Repository navigation
Packvium 1.10.0
Nested packing, overhanging pallets, gusseted bags, 24 rotations for a hull, a declared currency
and an id on every placement.
Added
packNested({ levels, levelBeamWidth }), this package's first nested packer: each level is
a JSON request, and each packed container is handed up as one upright item. AlevelBeamWidth
above 1 (default 1, the greedy chain) carries that many carton sets up a level, so a slightly
worse carton level can win by needing fewer pallets.container.pallet_overhang_limitis honoured instead of refused: a load may pass the deck by
the stated length at each end and width at each side. Positions are measured from the corner of
the overhang zone, only the deck bears weight, and the packed pallet gains
achieved_dimensions. Refused besideaccess_directions,axles,made_to_measure,
obstacles, a non-zerovoid_fill_reserve_ratioor anystop_index.deformable_boundary: { kind: 'gusseted_bag', side_gusset_depth }: a mailer whose side
gussets let the load's width plus its thickness reach the flat width plus the gusset depth.- 18 signed rotations for a
convex_hullitem (-L-W+Hand the rest), 24 in all, in
allowed_rotations, a placement'sorientation,fixed_placementsand revision events. A
signed code on any other item isinvalid_request/invalid_value. - An optional
currencyon the request and on eachrate_table, three capital letters,
echoed as the result'scurrency. It never changes the packing or the score; a rate table in
another currency isnot_allowed, and one with no request currency ismissing_field. placement_idon every placement: the canonical JSON of[container id, x, y, z, item_type, orientation], positions in ticks. A fixed placement or a locked revision event
may quote it, and the execution plan's placement reference copies it.optimality.lower_boundand the gap underopen_dimension_height,maximum_valueand
maximum_volume, besidesdefaultandlowest_cost;validatechecks them.- A made-to-measure box may keep a
void_fill_reserve_ratio: when the box cut tight to the
load would break the reserve, a larger one is cut. stockCutBoxesinrevisions.js, and the matchingartifact_requiredrevision issue.validatereportsplacement_id_mismatch,duplicate_placement_idand
currency_mismatch.
Changed
- Breaking for requests with a
unitskey other thanlength: it was ignored, so
units.weightsilently read bare weights as grams; it is nowinvalid_request/not_allowed
at/units/<key>. Write the unit on each weight instead. deriveRevisionstocks the boxes a plan already cut: a locked or verified placement in a
made-to-measure box used to derive a request every engine refused. The box now becomes a stock
container<type>@<revision>#<instance>at its cut size, andverifyRevisionChainchecks that
revision only when given its approved artifact.keep_uprightnarrows an explicitallowed_rotationslist in the fallback and in
validate, not only the default list.- The fallback breaks rotation ties by the rotation table's order, not by string order; a hull
answer can move, and three now match the other engines. - On the native backend, containers are numbered per type (
pair#1,large#1) on every
path, as the fallback always did. FixedPlacementErrorhas a third reason,invalid_value, for aplacement_idthat is not
the one its entry spells, or a signed orientation on an item that is not a hull.
Fixed
- An explicit rotation list emptied by
keep_uprightis refused atallowed_rotations,
with the same named request error the independent validator checks. - Stocking cut boxes indexes artifact lookups once and reports malformed consumed
machine fields as structuredinvalid_revisionerrors. - Nested beams keep fixed placements across container offers and handoffs instead of
aborting when a different carried branch cannot supply a locked item or container.