@operato/scene-storage 10.0.0-beta.48 → 10.0.0-beta.53

package/dist/templates/index.d.ts

@@ -20,6 +20,86 @@ declare const _default: ({
         fontFamily: string;
         bold: boolean;
     };
+} | {
+    type: string;
+    description: string;
+    group: string;
+    icon: string;
+    model: {
+        type: string;
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+        depth: number;
+        rotation: number;
+        fillStyle: string;
+        strokeStyle: string;
+        stackPattern: string;
+        carrierPreset: string;
+        carrierWidth: number;
+        carrierHeight: number;
+        carrierDepth: number;
+        carrierGap: number;
+        capacity: number;
+        pickPolicy: string;
+        data: {
+            id: string;
+        }[];
+    };
+} | {
+    type: string;
+    description: string;
+    group: string;
+    icon: string;
+    model: {
+        type: string;
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+        depth: number;
+        rotation: number;
+        fillStyle: string;
+        strokeStyle: string;
+        cols: number;
+        rows: number;
+        cellWidth: number;
+        cellHeight: number;
+        stackPattern: string;
+        carrierPreset: string;
+        carrierWidth: number;
+        carrierHeight: number;
+        carrierDepth: number;
+        carrierGap: number;
+        capacity: number;
+        pickPolicy: string;
+        data: {
+            col: number;
+            row: number;
+            data: {
+                id: string;
+            }[];
+        }[];
+    };
+} | {
+    type: string;
+    description: string;
+    group: string;
+    icon: string;
+    model: {
+        type: string;
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+        depth: number;
+        rotation: number;
+        fillStyle: string;
+        strokeStyle: string;
+        processingTimeMs: number;
+        status: string;
+    };
 } | {
     type: string;
     description: string;

package/dist/templates/index.js

@@ -10,6 +10,9 @@
  *   - spot — virtual placement marker
  */
 import spot from './spot.js';
+import stockpile from './stockpile.js';
+import stockpileGrid from './stockpile-grid.js';
+import pickingStation from './picking-station.js';
 const pallet = new URL('../../icons/pallet.png', import.meta.url).href;
 const box = new URL('../../icons/box.png', import.meta.url).href;
 const parcel = new URL('../../icons/parcel.png', import.meta.url).href;
@@ -195,6 +198,9 @@ export default [
             ]
         }
     },
-    spot
+    spot,
+    stockpile,
+    stockpileGrid,
+    pickingStation
 ];
 //# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * things-scene catalog templates for the storage domain.\n *\n * Components:\n *   - pallet / box / parcel — carriers\n *   - rack — multi-level storage shelf (bays × levels)\n *   - rack-table — bulk layout (rows × columns × shelves) helper\n *   - crane — stacker picker (Mover + CarrierHolder + ContainerCapacity)\n *   - mobile-rack — Mover(Rack), an AGV-mounted / cart-mounted moving rack\n *   - spot — virtual placement marker\n */\nimport spot from './spot.js'\nconst pallet = new URL('../../icons/pallet.png', import.meta.url).href\nconst box = new URL('../../icons/box.png', import.meta.url).href\nconst parcel = new URL('../../icons/parcel.png', import.meta.url).href\nconst rack = new URL('../../icons/storage-rack.png', import.meta.url).href\nconst crane = new URL('../../icons/crane.png', import.meta.url).href\n\nexport default [\n  {\n    type: 'wood pallet',\n    description: 'wood pallet (EUR / EPAL)',\n    group: 'storage',\n    icon: pallet,\n    model: {\n      type: 'pallet',\n      top: 100,\n      left: 100,\n      width: 80,\n      height: 80,\n      material: 'wood'\n    }\n  },\n  {\n    type: 'plastic pallet',\n    description: 'plastic pallet',\n    group: 'storage',\n    icon: pallet,\n    model: {\n      type: 'pallet',\n      top: 100,\n      left: 250,\n      width: 80,\n      height: 80,\n      depth: 4,\n      material: 'plastic'\n    }\n  },\n  {\n    type: 'wood box',\n    description: 'wood crate',\n    group: 'storage',\n    icon: box,\n    model: {\n      type: 'box',\n      top: 100,\n      left: 400,\n      width: 80,\n      height: 80,\n      material: 'wood'\n    }\n  },\n  {\n    type: 'plastic box',\n    description: 'plastic tote',\n    group: 'storage',\n    icon: box,\n    model: {\n      type: 'box',\n      top: 100,\n      left: 520,\n      width: 80,\n      height: 80,\n      depth: 60,\n      material: 'plastic'\n    }\n  },\n  {\n    type: 'parcel',\n    description: 'cardboard parcel',\n    group: 'storage',\n    icon: parcel,\n    model: {\n      type: 'parcel',\n      top: 100,\n      left: 640,\n      width: 10,\n      height: 10,\n      depth: 10\n    }\n  },\n  {\n    type: 'storage-rack',\n    description: 'storage rack — multi-level shelves',\n    group: 'storage',\n    icon: rack,\n    model: {\n      type: 'storage-rack',\n      top: 300,\n      left: 100,\n      width: 800,\n      height: 200,\n      levels: 4,\n      bays: 5\n    }\n  },\n  {\n    type: 'rack-grid',\n    description: 'rack table — N×M rack layout + auto location IDs',\n    group: 'storage',\n    icon: rack,\n    model: {\n      type: 'rack-grid',\n      top: 100,\n      left: 100,\n      width: 1200,\n      height: 600,\n      rows: 2,\n      columns: 4,\n      shelves: 4,\n      zone: 'A',\n      locPattern: '{z}{s}-{u}-{sh}',\n      sectionDigits: 2,\n      unitDigits: 2\n    }\n  },\n  {\n    type: 'crane',\n    description: 'stacker crane — picker actor',\n    group: 'storage',\n    icon: crane,\n    model: {\n      type: 'crane',\n      top: 550,\n      left: 400,\n      width: 100,\n      height: 200,\n      status: 'idle',\n      carriageHeight: 100\n    }\n  },\n  {\n    type: 'mobile-storage-rack',\n    description: 'mobile rack — Mover(Rack), AGV/cart-mounted',\n    group: 'storage',\n    icon: rack,\n    model: {\n      type: 'mobile-storage-rack',\n      top: 300,\n      left: 100,\n      width: 400,\n      height: 200,\n      levels: 3,\n      bays: 3\n    }\n  },\n  {\n    type: 'group',\n    description: 'storage aisle — rack pair + crane',\n    group: 'storage',\n    icon: rack,\n    model: {\n      type: 'group',\n      top: 100,\n      left: 100,\n      width: 840,\n      height: 220,\n      components: [\n        {\n          type: 'storage-rack',\n          top: 100,\n          left: 100,\n          width: 800,\n          height: 80,\n          levels: 4,\n          bays: 8\n        },\n        {\n          type: 'crane',\n          top: 140,\n          left: 420,\n          width: 60,\n          height: 60,\n          status: 'idle',\n          carriageHeight: 0\n        },\n        {\n          type: 'storage-rack',\n          top: 320,\n          left: 100,\n          width: 800,\n          height: 80,\n          levels: 4,\n          bays: 8\n        }\n      ]\n    }\n  },\n  spot\n]\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * things-scene catalog templates for the storage domain.\n *\n * Components:\n *   - pallet / box / parcel — carriers\n *   - rack — multi-level storage shelf (bays × levels)\n *   - rack-table — bulk layout (rows × columns × shelves) helper\n *   - crane — stacker picker (Mover + CarrierHolder + ContainerCapacity)\n *   - mobile-rack — Mover(Rack), an AGV-mounted / cart-mounted moving rack\n *   - spot — virtual placement marker\n */\nimport spot from './spot.js'\nimport stockpile from './stockpile.js'\nimport stockpileGrid from './stockpile-grid.js'\nimport pickingStation from './picking-station.js'\nconst pallet = new URL('../../icons/pallet.png', import.meta.url).href\nconst box = new URL('../../icons/box.png', import.meta.url).href\nconst parcel = new URL('../../icons/parcel.png', import.meta.url).href\nconst rack = new URL('../../icons/storage-rack.png', import.meta.url).href\nconst crane = new URL('../../icons/crane.png', import.meta.url).href\n\nexport default [\n  {\n    type: 'wood pallet',\n    description: 'wood pallet (EUR / EPAL)',\n    group: 'storage',\n    icon: pallet,\n    model: {\n      type: 'pallet',\n      top: 100,\n      left: 100,\n      width: 80,\n      height: 80,\n      material: 'wood'\n    }\n  },\n  {\n    type: 'plastic pallet',\n    description: 'plastic pallet',\n    group: 'storage',\n    icon: pallet,\n    model: {\n      type: 'pallet',\n      top: 100,\n      left: 250,\n      width: 80,\n      height: 80,\n      depth: 4,\n      material: 'plastic'\n    }\n  },\n  {\n    type: 'wood box',\n    description: 'wood crate',\n    group: 'storage',\n    icon: box,\n    model: {\n      type: 'box',\n      top: 100,\n      left: 400,\n      width: 80,\n      height: 80,\n      material: 'wood'\n    }\n  },\n  {\n    type: 'plastic box',\n    description: 'plastic tote',\n    group: 'storage',\n    icon: box,\n    model: {\n      type: 'box',\n      top: 100,\n      left: 520,\n      width: 80,\n      height: 80,\n      depth: 60,\n      material: 'plastic'\n    }\n  },\n  {\n    type: 'parcel',\n    description: 'cardboard parcel',\n    group: 'storage',\n    icon: parcel,\n    model: {\n      type: 'parcel',\n      top: 100,\n      left: 640,\n      width: 10,\n      height: 10,\n      depth: 10\n    }\n  },\n  {\n    type: 'storage-rack',\n    description: 'storage rack — multi-level shelves',\n    group: 'storage',\n    icon: rack,\n    model: {\n      type: 'storage-rack',\n      top: 300,\n      left: 100,\n      width: 800,\n      height: 200,\n      levels: 4,\n      bays: 5\n    }\n  },\n  {\n    type: 'rack-grid',\n    description: 'rack table — N×M rack layout + auto location IDs',\n    group: 'storage',\n    icon: rack,\n    model: {\n      type: 'rack-grid',\n      top: 100,\n      left: 100,\n      width: 1200,\n      height: 600,\n      rows: 2,\n      columns: 4,\n      shelves: 4,\n      zone: 'A',\n      locPattern: '{z}{s}-{u}-{sh}',\n      sectionDigits: 2,\n      unitDigits: 2\n    }\n  },\n  {\n    type: 'crane',\n    description: 'stacker crane — picker actor',\n    group: 'storage',\n    icon: crane,\n    model: {\n      type: 'crane',\n      top: 550,\n      left: 400,\n      width: 100,\n      height: 200,\n      status: 'idle',\n      carriageHeight: 100\n    }\n  },\n  {\n    type: 'mobile-storage-rack',\n    description: 'mobile rack — Mover(Rack), AGV/cart-mounted',\n    group: 'storage',\n    icon: rack,\n    model: {\n      type: 'mobile-storage-rack',\n      top: 300,\n      left: 100,\n      width: 400,\n      height: 200,\n      levels: 3,\n      bays: 3\n    }\n  },\n  {\n    type: 'group',\n    description: 'storage aisle — rack pair + crane',\n    group: 'storage',\n    icon: rack,\n    model: {\n      type: 'group',\n      top: 100,\n      left: 100,\n      width: 840,\n      height: 220,\n      components: [\n        {\n          type: 'storage-rack',\n          top: 100,\n          left: 100,\n          width: 800,\n          height: 80,\n          levels: 4,\n          bays: 8\n        },\n        {\n          type: 'crane',\n          top: 140,\n          left: 420,\n          width: 60,\n          height: 60,\n          status: 'idle',\n          carriageHeight: 0\n        },\n        {\n          type: 'storage-rack',\n          top: 320,\n          left: 100,\n          width: 800,\n          height: 80,\n          levels: 4,\n          bays: 8\n        }\n      ]\n    }\n  },\n  spot,\n  stockpile,\n  stockpileGrid,\n  pickingStation\n]\n"]}

package/dist/templates/picking-station.d.ts

@@ -0,0 +1,20 @@
+declare const _default: {
+    type: string;
+    description: string;
+    group: string;
+    icon: string;
+    model: {
+        type: string;
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+        depth: number;
+        rotation: number;
+        fillStyle: string;
+        strokeStyle: string;
+        processingTimeMs: number;
+        status: string;
+    };
+};
+export default _default;

package/dist/templates/picking-station.js

@@ -0,0 +1,22 @@
+// Reuse parcel.png as a placeholder icon until a dedicated picking-station icon is drawn.
+const icon = new URL('../../icons/parcel.png', import.meta.url).href;
+export default {
+    type: 'picking-station',
+    description: 'work station — carrier stays for processingTimeMs then becomes idle. anchors AMR↔human handoff',
+    group: 'storage',
+    icon,
+    model: {
+        type: 'picking-station',
+        top: 200,
+        left: 400,
+        width: 120,
+        height: 100,
+        depth: 60,
+        rotation: 0,
+        fillStyle: '#5a8ab8',
+        strokeStyle: '#3d6a8f',
+        processingTimeMs: 3000,
+        status: 'idle'
+    }
+};
+//# sourceMappingURL=picking-station.js.map

package/dist/templates/picking-station.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picking-station.js","sourceRoot":"","sources":["../../src/templates/picking-station.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAA;AAEpE,eAAe;IACb,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,gGAAgG;IAClG,KAAK,EAAE,SAAS;IAChB,IAAI;IACJ,KAAK,EAAE;QACL,IAAI,EAAE,iBAAiB;QACvB,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,SAAS;QACtB,gBAAgB,EAAE,IAAI;QACtB,MAAM,EAAE,MAAM;KACf;CACF,CAAA","sourcesContent":["// Reuse parcel.png as a placeholder icon until a dedicated picking-station icon is drawn.\nconst icon = new URL('../../icons/parcel.png', import.meta.url).href\n\nexport default {\n  type: 'picking-station',\n  description:\n    'work station — carrier stays for processingTimeMs then becomes idle. anchors AMR↔human handoff',\n  group: 'storage',\n  icon,\n  model: {\n    type: 'picking-station',\n    top: 200,\n    left: 400,\n    width: 120,\n    height: 100,\n    depth: 60,\n    rotation: 0,\n    fillStyle: '#5a8ab8',\n    strokeStyle: '#3d6a8f',\n    processingTimeMs: 3000,\n    status: 'idle'\n  }\n}\n"]}

package/dist/templates/stockpile-grid.d.ts

@@ -0,0 +1,37 @@
+declare const _default: {
+    type: string;
+    description: string;
+    group: string;
+    icon: string;
+    model: {
+        type: string;
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+        depth: number;
+        rotation: number;
+        fillStyle: string;
+        strokeStyle: string;
+        cols: number;
+        rows: number;
+        cellWidth: number;
+        cellHeight: number;
+        stackPattern: string;
+        carrierPreset: string;
+        carrierWidth: number;
+        carrierHeight: number;
+        carrierDepth: number;
+        carrierGap: number;
+        capacity: number;
+        pickPolicy: string;
+        data: {
+            col: number;
+            row: number;
+            data: {
+                id: string;
+            }[];
+        }[];
+    };
+};
+export default _default;

package/dist/templates/stockpile-grid.js

@@ -0,0 +1,38 @@
+// Reuse parcel.png as a placeholder icon until a dedicated stockpile-grid icon is drawn.
+const icon = new URL('../../icons/parcel.png', import.meta.url).href;
+export default {
+    type: 'stockpile-grid',
+    description: 'grid of block/floor storage cells — each cell is a stockpile with its own records, capacity, and preset override',
+    group: 'storage',
+    icon,
+    model: {
+        type: 'stockpile-grid',
+        top: 200,
+        left: 400,
+        width: 300,
+        height: 200,
+        depth: 5,
+        rotation: 0,
+        fillStyle: '#c89c5c',
+        strokeStyle: '#7a5a2e',
+        cols: 3,
+        rows: 2,
+        cellWidth: 100,
+        cellHeight: 100,
+        stackPattern: 'row',
+        carrierPreset: 'box',
+        carrierWidth: 30,
+        carrierHeight: 30,
+        carrierDepth: 22,
+        carrierGap: 10,
+        capacity: 20,
+        pickPolicy: 'lifo',
+        // 데모 — 일부 cell 에 records 미리 채워서 끌어 놓자 마자 적치 보이게.
+        data: [
+            { col: 0, row: 0, data: [{ id: 'a1' }, { id: 'a2' }] },
+            { col: 1, row: 0, data: [{ id: 'b1' }, { id: 'b2' }, { id: 'b3' }] },
+            { col: 2, row: 1, data: [{ id: 'c1' }] }
+        ]
+    }
+};
+//# sourceMappingURL=stockpile-grid.js.map

package/dist/templates/stockpile-grid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stockpile-grid.js","sourceRoot":"","sources":["../../src/templates/stockpile-grid.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAA;AAEpE,eAAe;IACb,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,kHAAkH;IACpH,KAAK,EAAE,SAAS;IAChB,IAAI;IACJ,KAAK,EAAE;QACL,IAAI,EAAE,gBAAgB;QACtB,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,SAAS;QACpB,WAAW,EAAE,SAAS;QACtB,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,SAAS,EAAE,GAAG;QACd,UAAU,EAAE,GAAG;QACf,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,KAAK;QACpB,YAAY,EAAE,EAAE;QAChB,aAAa,EAAE,EAAE;QACjB,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,MAAM;QAClB,iDAAiD;QACjD,IAAI,EAAE;YACJ,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;YACtD,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;YACpE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;SACzC;KACF;CACF,CAAA","sourcesContent":["// Reuse parcel.png as a placeholder icon until a dedicated stockpile-grid icon is drawn.\nconst icon = new URL('../../icons/parcel.png', import.meta.url).href\n\nexport default {\n  type: 'stockpile-grid',\n  description:\n    'grid of block/floor storage cells — each cell is a stockpile with its own records, capacity, and preset override',\n  group: 'storage',\n  icon,\n  model: {\n    type: 'stockpile-grid',\n    top: 200,\n    left: 400,\n    width: 300,\n    height: 200,\n    depth: 5,\n    rotation: 0,\n    fillStyle: '#c89c5c',\n    strokeStyle: '#7a5a2e',\n    cols: 3,\n    rows: 2,\n    cellWidth: 100,\n    cellHeight: 100,\n    stackPattern: 'row',\n    carrierPreset: 'box',\n    carrierWidth: 30,\n    carrierHeight: 30,\n    carrierDepth: 22,\n    carrierGap: 10,\n    capacity: 20,\n    pickPolicy: 'lifo',\n    // 데모 — 일부 cell 에 records 미리 채워서 끌어 놓자 마자 적치 보이게.\n    data: [\n      { col: 0, row: 0, data: [{ id: 'a1' }, { id: 'a2' }] },\n      { col: 1, row: 0, data: [{ id: 'b1' }, { id: 'b2' }, { id: 'b3' }] },\n      { col: 2, row: 1, data: [{ id: 'c1' }] }\n    ]\n  }\n}\n"]}

package/dist/templates/stockpile.d.ts

@@ -0,0 +1,29 @@
+declare const _default: {
+    type: string;
+    description: string;
+    group: string;
+    icon: string;
+    model: {
+        type: string;
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+        depth: number;
+        rotation: number;
+        fillStyle: string;
+        strokeStyle: string;
+        stackPattern: string;
+        carrierPreset: string;
+        carrierWidth: number;
+        carrierHeight: number;
+        carrierDepth: number;
+        carrierGap: number;
+        capacity: number;
+        pickPolicy: string;
+        data: {
+            id: string;
+        }[];
+    };
+};
+export default _default;

package/dist/templates/stockpile.js

@@ -0,0 +1,31 @@
+// Reuse parcel.png as a placeholder icon until a dedicated stockpile icon is drawn.
+const icon = new URL('../../icons/parcel.png', import.meta.url).href;
+export default {
+    type: 'stockpile',
+    description: 'block/floor storage — rectangular footprint with auto-stacked virtual carriers (stackPattern × carrierPreset) driven by state.data records',
+    group: 'storage' /* line|shape|textAndMedia|chartAndGauge|table|container|dataSource|3D|facility|storage|conveyance|transport|manufacturing|form|etc */,
+    icon,
+    model: {
+        type: 'stockpile',
+        top: 200,
+        left: 400,
+        width: 200,
+        height: 150,
+        depth: 5,
+        rotation: 0,
+        fillStyle: '#c89c5c',
+        // 바닥 페인트 라인 의도 — fillStyle 보다 진한 색으로 영역 마킹이 눈에 띄게.
+        strokeStyle: '#7a5a2e',
+        stackPattern: 'row',
+        carrierPreset: 'box',
+        carrierWidth: 30,
+        carrierHeight: 30,
+        carrierDepth: 22,
+        carrierGap: 10,
+        capacity: 30,
+        pickPolicy: 'lifo',
+        // 데모용 — 새로 끌어다 놓았을 때 적치된 모습이 즉시 보이도록 record 몇 개.
+        data: [{ id: 'p-1' }, { id: 'p-2' }, { id: 'p-3' }]
+    }
+};
+//# sourceMappingURL=stockpile.js.map

package/dist/templates/stockpile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stockpile.js","sourceRoot":"","sources":["../../src/templates/stockpile.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAA;AAEpE,eAAe;IACb,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,4IAA4I;IAC9I,KAAK,EAAE,SAAS,CAAC,sIAAsI;IACvJ,IAAI;IACJ,KAAK,EAAE;QACL,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,SAAS;QACpB,mDAAmD;QACnD,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,KAAK;QACpB,YAAY,EAAE,EAAE;QAChB,aAAa,EAAE,EAAE;QACjB,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,MAAM;QAClB,iDAAiD;QACjD,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;KACpD;CACF,CAAA","sourcesContent":["// Reuse parcel.png as a placeholder icon until a dedicated stockpile icon is drawn.\nconst icon = new URL('../../icons/parcel.png', import.meta.url).href\n\nexport default {\n  type: 'stockpile',\n  description:\n    'block/floor storage — rectangular footprint with auto-stacked virtual carriers (stackPattern × carrierPreset) driven by state.data records',\n  group: 'storage' /* line|shape|textAndMedia|chartAndGauge|table|container|dataSource|3D|facility|storage|conveyance|transport|manufacturing|form|etc */,\n  icon,\n  model: {\n    type: 'stockpile',\n    top: 200,\n    left: 400,\n    width: 200,\n    height: 150,\n    depth: 5,\n    rotation: 0,\n    fillStyle: '#c89c5c',\n    // 바닥 페인트 라인 의도 — fillStyle 보다 진한 색으로 영역 마킹이 눈에 띄게.\n    strokeStyle: '#7a5a2e',\n    stackPattern: 'row',\n    carrierPreset: 'box',\n    carrierWidth: 30,\n    carrierHeight: 30,\n    carrierDepth: 22,\n    carrierGap: 10,\n    capacity: 30,\n    pickPolicy: 'lifo',\n    // 데모용 — 새로 끌어다 놓았을 때 적치된 모습이 즉시 보이도록 record 몇 개.\n    data: [{ id: 'p-1' }, { id: 'p-2' }, { id: 'p-3' }]\n  }\n}\n"]}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@operato/scene-storage",
   "description": "Storage-domain components for things-scene (smart factory / logistics) — pallet, box, parcel; AS/RS and shelves planned.",
   "author": "heartyoh",
-  "version": "10.0.0-beta.48",
+  "version": "10.0.0-beta.53",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -26,7 +26,7 @@
   },
   "dependencies": {
     "@hatiolab/things-scene": "^10.0.0-beta.1",
-    "@operato/scene-base": "^10.0.0-beta.48",
+    "@operato/scene-base": "^10.0.0-beta.53",
     "three": "^0.183.0"
   },
   "devDependencies": {
@@ -45,5 +45,5 @@
     "typescript": "^5.0.4"
   },
   "prettier": "@hatiolab/prettier-config",
-  "gitHead": "ebda54409e9c089f6e7662ee6b447b5de9a9ecb3"
+  "gitHead": "ce61d4ad1beee04ac4078e478d88fe55820b600f"
 }

package/src/box.ts

@@ -13,6 +13,7 @@ import {
 import type { State, Material3D, PickupFrame, PoseSerialized } from '@hatiolab/things-scene'
 import {
   Carriable,
+  Identifiable,
   Legendable,
   Placeable,
   type Alignment,
@@ -81,7 +82,7 @@ const NATURE: ComponentNature = {
  * scene-tree). If a future use case needs nested boxes, extend Container.
  */
 @sceneComponent('box')
-export default class Box extends Carriable(Legendable(Placeable(RectPath(Shape)))) {
+export default class Box extends Identifiable(Carriable(Legendable(Placeable(RectPath(Shape))))) {
   declare state: BoxState
 
   static legends: Record<string, LegendBinding> = {

package/src/index.ts

@@ -25,6 +25,20 @@ export { Crane3D } from './crane-3d.js'
 export { default as Spot } from './spot.js'
 export { Spot3D } from './spot-3d.js'
 
+export { default as Stockpile } from './stockpile.js'
+export type {
+  StockpileState, StockpileRecord, StackPattern, CarrierPreset, PickPolicy
+} from './stockpile.js'
+export { Stockpile3D } from './stockpile-3d.js'
+
+export { default as StockpileGrid } from './stockpile-grid.js'
+export type { StockpileGridState, StockpileGridCell } from './stockpile-grid.js'
+export { StockpileGrid3D } from './stockpile-grid-3d.js'
+
+export { default as PickingStation } from './picking-station.js'
+export type { PickingStationState, PickingStationStatus } from './picking-station.js'
+export { PickingStation3D } from './picking-station-3d.js'
+
 export { default as GenericContainer } from './generic-container.js'
 export type { ContainerStatus } from './generic-container.js'
 export { GenericContainer3D } from './generic-container-3d.js'

package/src/pallet.ts

@@ -15,6 +15,7 @@ import {
 import type { State, Material3D, PickupFrame, PoseSerialized } from '@hatiolab/things-scene'
 import {
   Carriable,
+  Identifiable,
   Legendable,
   Placeable,
   type Alignment,
@@ -122,7 +123,7 @@ const NATURE: ComponentNature = {
  * detection.
  */
 @sceneComponent('pallet')
-export default class Pallet extends Carriable(Legendable(Placeable(ContainerAbstract))) {
+export default class Pallet extends Identifiable(Carriable(Legendable(Placeable(ContainerAbstract)))) {
   declare state: PalletState
 
   static legends: Record<string, LegendBinding> = {

package/src/parcel.ts

@@ -13,6 +13,7 @@ import {
 import type { State, Material3D, PickupFrame, PoseSerialized } from '@hatiolab/things-scene'
 import {
   Carriable,
+  Identifiable,
   Placeable,
   type Alignment,
   type PlacementArchetype
@@ -62,7 +63,7 @@ const NATURE: ComponentNature = {
  * inspected indicators would add a status legend then.
  */
 @sceneComponent('parcel')
-export default class Parcel extends Carriable(Placeable(RectPath(Shape))) {
+export default class Parcel extends Identifiable(Carriable(Placeable(RectPath(Shape)))) {
   declare state: ParcelState
 
   static placement: PlacementArchetype = 'operation'

package/src/picking-station-3d.ts

@@ -0,0 +1,164 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * PickingStation3D — 사람 작업 위치의 3D 시각화. pad(영역) + 작업대(가운데 box, top
+ * face 가 carrier 안착면). status 별 색 변화 (idle/processing/busy) 로 작업 진행
+ * 인지성.
+ */
+
+import * as THREE from 'three'
+import { RealObjectGroup } from '@hatiolab/things-scene'
+
+import type PickingStation from './picking-station.js'
+import type { PickingStationStatus } from './picking-station.js'
+
+const PAD_DEPTH = 2
+
+const STATUS_TINT: Record<PickingStationStatus, number> = {
+  idle: 0x4a7a9b,        // 차분한 blue-grey
+  processing: 0xd9943a,  // 작업 중 — 주황
+  busy: 0xc04040          // busy/blocked — 빨강
+}
+
+export class PickingStation3D extends RealObjectGroup {
+  private _padMesh?: THREE.Mesh
+  private _padOutline?: THREE.LineSegments
+  private _tableMesh?: THREE.Mesh
+
+  build() {
+    super.build()
+    const state = this.component.state as any
+    const w = state.width ?? 100
+    const h = state.height ?? 100
+    const depth = state.depth ?? 5
+
+    // ── pad (영역) ─────────────────────────────────────────────
+    const padGeom = new THREE.BoxGeometry(w, PAD_DEPTH, h)
+    const padMat = new THREE.MeshStandardMaterial({
+      color: this._padColor(), roughness: 0.85, transparent: true, opacity: 0.5
+    })
+    this._padMesh = new THREE.Mesh(padGeom, padMat)
+    this._padMesh.position.y = PAD_DEPTH / 2
+    this._padMesh.receiveShadow = true
+    this.object3d.add(this._padMesh)
+
+    // pad outline
+    const outline = new THREE.LineBasicMaterial({ color: this._strokeColor() })
+    this._padOutline = new THREE.LineSegments(new THREE.EdgesGeometry(padGeom), outline)
+    this._padOutline.position.y = PAD_DEPTH / 2
+    this.object3d.add(this._padOutline)
+
+    // ── 작업대 (table) — pad 위 가운데 box. top face = carrier 안착면. ──
+    const tableW = w * 0.55
+    const tableH = h * 0.45
+    const tableD = Math.max(8, depth)   // 작업면 높이 — operation height 근사
+    const tableGeom = new THREE.BoxGeometry(tableW, tableD, tableH)
+    const tableMat = new THREE.MeshStandardMaterial({
+      color: this._statusColor(), roughness: 0.6, metalness: 0.1
+    })
+    this._tableMesh = new THREE.Mesh(tableGeom, tableMat)
+    this._tableMesh.position.y = PAD_DEPTH + tableD / 2
+    this._tableMesh.castShadow = true
+    this._tableMesh.receiveShadow = true
+    this.object3d.add(this._tableMesh)
+  }
+
+  /** carrier 안착 anchor — 작업대 top face. */
+  getAttachFrame(): THREE.Object3D | undefined {
+    return this._tableMesh ?? this._padMesh
+  }
+
+  private _padColor(): THREE.Color {
+    const raw = (this.component.state as any)?.fillStyle
+    if (typeof raw === 'string' && raw.length > 0) {
+      try { return new THREE.Color(raw) } catch { /* fallthrough */ }
+    }
+    return new THREE.Color(0x5a8ab8)
+  }
+
+  private _strokeColor(): THREE.Color {
+    const raw = (this.component.state as any)?.strokeStyle
+    if (typeof raw === 'string' && raw.length > 0) {
+      try { return new THREE.Color(raw) } catch { /* fallthrough */ }
+    }
+    return this._padColor().clone().multiplyScalar(0.6)
+  }
+
+  /** status 에 따른 작업대 색 — idle/processing/busy. */
+  private _statusColor(): THREE.Color {
+    const s = (this.component.state as any)?.status as PickingStationStatus | undefined
+    return new THREE.Color(STATUS_TINT[s ?? 'idle'] ?? STATUS_TINT.idle)
+  }
+
+  private _applyPadColor(): void {
+    if (this._padMesh) {
+      const m = this._padMesh.material as THREE.MeshStandardMaterial
+      m.color.copy(this._padColor())
+      m.needsUpdate = true
+    }
+  }
+  private _applyStrokeColor(): void {
+    if (this._padOutline) {
+      const m = this._padOutline.material as THREE.LineBasicMaterial
+      m.color.copy(this._strokeColor())
+      m.needsUpdate = true
+    }
+  }
+  private _applyStatusColor(): void {
+    if (this._tableMesh) {
+      const m = this._tableMesh.material as THREE.MeshStandardMaterial
+      m.color.copy(this._statusColor())
+      m.needsUpdate = true
+    }
+  }
+
+  updateAlpha(): void {
+    const alpha = typeof (this.component.state as any).alpha === 'number'
+      ? (this.component.state as any).alpha : 1
+    if (this._padMesh) {
+      const m = this._padMesh.material as THREE.MeshStandardMaterial
+      m.opacity = 0.5 * alpha
+      m.transparent = m.opacity < 1
+      m.needsUpdate = true
+    }
+  }
+
+  updateDimension(): void {
+    if (this._padMesh) {
+      const state = this.component.state as any
+      const w = state.width ?? 100
+      const h = state.height ?? 100
+      const depth = state.depth ?? 5
+      this._padMesh.geometry.dispose()
+      this._padMesh.geometry = new THREE.BoxGeometry(w, PAD_DEPTH, h)
+      if (this._padOutline) {
+        this._padOutline.geometry.dispose()
+        this._padOutline.geometry = new THREE.EdgesGeometry(this._padMesh.geometry)
+      }
+      if (this._tableMesh) {
+        const tableW = w * 0.55
+        const tableH = h * 0.45
+        const tableD = Math.max(8, depth)
+        this._tableMesh.geometry.dispose()
+        this._tableMesh.geometry = new THREE.BoxGeometry(tableW, tableD, tableH)
+        this._tableMesh.position.y = PAD_DEPTH + tableD / 2
+      }
+    }
+  }
+
+  onchange(after: Record<string, unknown>, before: Record<string, unknown>): void {
+    if ('width' in after || 'height' in after || 'depth' in after) {
+      this.updateDimension()
+      return
+    }
+    if ('alpha' in after) { this.updateAlpha(); return }
+    if ('fillStyle' in after) {
+      this._applyPadColor()
+      if ((this.component.state as any).strokeStyle == null) this._applyStrokeColor()
+      return
+    }
+    if ('strokeStyle' in after) { this._applyStrokeColor(); return }
+    if ('status' in after) { this._applyStatusColor(); return }
+    super.onchange?.(after, before)
+  }
+}