@storylet-studio/model 0.3.0 → 0.4.0

package/dist/index.cjs

@@ -29,6 +29,7 @@ __export(index_exports, {
   DEFAULT_PLAY_RUNG: () => DEFAULT_PLAY_RUNG,
   FURNITURE_COLOURS: () => FURNITURE_COLOURS,
   HANDS_SCHEMA: () => HANDS_SCHEMA,
+  MAP_SCHEMA: () => MAP_SCHEMA,
   NOTES_SCHEMA: () => NOTES_SCHEMA,
   PLACE_GROUP: () => PLACE_GROUP,
   PROJECT_FOLDER_EXTENSION: () => PROJECT_FOLDER_EXTENSION,
@@ -562,11 +563,22 @@ var SHARD_EXTENSIONS = {
   tags: ".storylettags",
   hands: ".storylethands",
   deck: ".storyletdeck",
-  /** The arrangement layer: where things SIT, never what they are. Its own shard
-   *  because positions churn (an afternoon of tidying a canvas touches every
-   *  card) and content does not, so a designer arranging and a writer editing
-   *  never collide on one file (design/graphical-views.md section 1.2). */
+  /** The AUTHOR's arrangement layer: the canvases, where cards sit on a deck's
+   *  node canvas and the furniture drawn round them. Its own shard because
+   *  positions churn (an afternoon of tidying a canvas touches every card) and
+   *  content does not, so a designer arranging and a writer editing never
+   *  collide on one file (design/graphical-views.md section 1.2). */
   view: ".storyletview",
+  /** The DESIGNER's map: where a box's hands stand in space, and the furniture
+   *  round them. One per box, beside the view shard.
+   *
+   *  Split out of the view shard on 2026-09-06 (design/engine-server.md 9.1
+   *  point 5) because the two halves stopped having one owner. A hand's
+   *  position ships in the bundle's `maps` block (4.3) and is where a venue's
+   *  kiosk stands, so it is SHAPE, which a server's author key may not change;
+   *  the canvases are the author's own working drawing and never leave the
+   *  project folder. One file could not be both. */
+  map: ".storyletmap",
   /** Threaded comments: content-ADJACENT, so neither in a content shard (a
    *  writer's deck edit must not conflict with a reviewer's comment) nor in the
    *  arrangement sidecar (this is not where anything sits). One per box,
@@ -589,6 +601,7 @@ var TAGS_SCHEMA = "storylets/tags@0";
 var HANDS_SCHEMA = "storylets/hands@0";
 var DECK_SCHEMA = "storylets/deck@0";
 var VIEW_SCHEMA = "storylets/view@0";
+var MAP_SCHEMA = "storylets/map@0";
 var NOTES_SCHEMA = "storylets/notes@0";
 var CONTRACT_SCHEMA = "storylets/contract@0";
 var contractPropertyPath = (p) => typeof p === "string" ? p : p.path;
@@ -605,6 +618,7 @@ var FURNITURE_COLOURS = ["paper", "amber", "sage", "sky", "rose", "slate"];
   DEFAULT_PLAY_RUNG,
   FURNITURE_COLOURS,
   HANDS_SCHEMA,
+  MAP_SCHEMA,
   NOTES_SCHEMA,
   PLACE_GROUP,
   PROJECT_FOLDER_EXTENSION,

package/dist/index.d.cts

@@ -430,8 +430,9 @@ interface PropertyDecl {
     durable?: boolean;
     purpose?: string;
 }
-/** A card-template field (box-defined). Data for the host; the engine never
- *  interprets fields and they are not addressable from expressions. */
+/** A template field (box-defined), of the card template or of the outcome
+ *  fields. Data for the host; the engine never interprets fields and they are
+ *  not addressable from expressions. */
 interface FieldDecl {
     name: string;
     type: PropertyType;
@@ -544,6 +545,11 @@ interface Outcome<E> {
     /** Target ("@scope.name") -> expression; all right-hand sides evaluate
      *  against pre-play state (schema 3.7). */
     changes: Record<string, E>;
+    /** Template data, as `Card.fields` is: field name -> value, declared by
+     *  the box's `outcomeFields`, validated at publish, and handed to the host
+     *  with the outcome. The engine never reads it: a press can say one line
+     *  ("The notice is in your pocket") without spending a card on it. */
+    fields?: Record<string, ScalarValue>;
 }
 interface Card<E> {
     id: string;
@@ -847,6 +853,10 @@ interface Box<E> {
     };
     /** The card template: what every card in this box carries. */
     fields: FieldDecl[];
+    /** What every outcome in this box may carry, declared the same way.
+     *  Absent when the box declares none, so a bundle without them is byte for
+     *  byte what it was. */
+    outcomeFields?: FieldDecl[];
     properties: PropertyDecl[];
     tagGroups: TagGroup[];
     decks: Deck<E>[];
@@ -1127,11 +1137,22 @@ declare const SHARD_EXTENSIONS: {
     readonly tags: ".storylettags";
     readonly hands: ".storylethands";
     readonly deck: ".storyletdeck";
-    /** The arrangement layer: where things SIT, never what they are. Its own shard
-     *  because positions churn (an afternoon of tidying a canvas touches every
-     *  card) and content does not, so a designer arranging and a writer editing
-     *  never collide on one file (design/graphical-views.md section 1.2). */
+    /** The AUTHOR's arrangement layer: the canvases, where cards sit on a deck's
+     *  node canvas and the furniture drawn round them. Its own shard because
+     *  positions churn (an afternoon of tidying a canvas touches every card) and
+     *  content does not, so a designer arranging and a writer editing never
+     *  collide on one file (design/graphical-views.md section 1.2). */
     readonly view: ".storyletview";
+    /** The DESIGNER's map: where a box's hands stand in space, and the furniture
+     *  round them. One per box, beside the view shard.
+     *
+     *  Split out of the view shard on 2026-09-06 (design/engine-server.md 9.1
+     *  point 5) because the two halves stopped having one owner. A hand's
+     *  position ships in the bundle's `maps` block (4.3) and is where a venue's
+     *  kiosk stands, so it is SHAPE, which a server's author key may not change;
+     *  the canvases are the author's own working drawing and never leave the
+     *  project folder. One file could not be both. */
+    readonly map: ".storyletmap";
     /** Threaded comments: content-ADJACENT, so neither in a content shard (a
      *  writer's deck edit must not conflict with a reviewer's comment) nor in the
      *  arrangement sidecar (this is not where anything sits). One per box,
@@ -1157,6 +1178,7 @@ declare const TAGS_SCHEMA = "storylets/tags@0";
 declare const HANDS_SCHEMA = "storylets/hands@0";
 declare const DECK_SCHEMA = "storylets/deck@0";
 declare const VIEW_SCHEMA = "storylets/view@0";
+declare const MAP_SCHEMA = "storylets/map@0";
 /** The comment sidecar's schema. Still called "notes" on disk: the file already
  *  held both, and renaming it would break every project for no gain. */
 declare const NOTES_SCHEMA = "storylets/notes@0";
@@ -1203,6 +1225,10 @@ interface ContractShard {
     properties?: ContractProperty[];
     /** Card-template field names the crew and the bridges read. */
     fields?: string[];
+    /** Outcome field names they read, the same way: the after-line a station
+     *  shows when a press lands. What `fields` is to the card template, this is
+     *  to the box's `outcomeFields`. */
+    outcomeFields?: string[];
 }
 /**
  * One contracted property.
@@ -1284,7 +1310,9 @@ interface DeckCanvas extends CanvasFurniture {
     /** Keyed by CARD id. */
     cards?: Record<string, ViewPoint>;
 }
-/** The box's map: where its hands sit in space, and the furniture around them. */
+/** The box's map: where its hands sit in space, and the furniture around them.
+ *  Carried by the MAP shard since 2026-09-06; `ViewShard.map` is the old
+ *  address, read for one release and never written. */
 interface BoxMap extends CanvasFurniture {
     /** Keyed by HAND id. WHERE a site is, and nothing else.
      *
@@ -1300,7 +1328,8 @@ interface BoxMap extends CanvasFurniture {
      *  were edited. */
     sites?: Record<string, ViewPoint>;
 }
-/** The arrangement layer for one box: where things SIT, never what they are.
+/** The AUTHOR's arrangement layer for one box: where cards sit on their decks'
+ *  canvases, and the furniture drawn round them.
  *
  *  Its own shard on purpose (design/graphical-views.md section 1.2). Positions
  *  churn, content does not: an afternoon of tidying a canvas touches every card,
@@ -1315,8 +1344,33 @@ interface ViewShard {
     schema: typeof VIEW_SCHEMA;
     /** Keyed by DECK id: one node canvas each. */
     canvases?: Record<string, DeckCanvas>;
+    /** @deprecated The box map's old address, kept for one release and READ ONLY.
+     *  A reader that meets it uses it when the box has no `MapShard`, and the
+     *  formatter moves it; nothing writes it any more. Removed after the next
+     *  release, at which point a map left here is simply lost. */
     map?: BoxMap;
 }
+/** The DESIGNER's map for one box: where its hands stand in space.
+ *
+ *  Split out of the view shard on 2026-09-06 (design/engine-server.md 9.1 point
+ *  5). The two halves had stopped sharing an owner: a hand's position ships in
+ *  the bundle's `maps` block (4.3), which makes it the thing a venue provisions
+ *  its kiosks against, while a deck's canvas is a working drawing that never
+ *  leaves the folder. A server's author key may change the canvases and not
+ *  this.
+ *
+ *  The map is NESTED under `map` rather than flattened to the top level, and
+ *  deliberately: the block's bytes are then exactly what the view shard held, so
+ *  the migration is a move of a value rather than a reshaping of it, the merge
+ *  strategy carries over word for word, and a reader that has to look in both
+ *  places is one expression (`box.map?.map ?? box.view?.map`).
+ *
+ *  Source-only in the sense the view shard is not: `compileMaps` reads the
+ *  positions for the bundle's `maps` block, under `export.map`. */
+interface MapShard {
+    schema: typeof MAP_SCHEMA;
+    map: BoxMap;
+}
 /** A coverage input driver: during a coverage run the harness feeds a
  *  host-seam property (`@world.x`) values from `values`, so content gated on
  *  external state gets exercised (Patter's coverageDrivers, carried whole). */
@@ -1416,6 +1470,9 @@ interface BoxShard {
             seconds: number;
         };
         fields: FieldDecl[];
+        /** The outcome fields (see `Box.outcomeFields`); a shard without the key
+         *  declares none. */
+        outcomeFields?: FieldDecl[];
         properties: PropertyDecl[];
     };
 }
@@ -1449,4 +1506,4 @@ interface DeckShard {
     cards: Card<string>[];
 }
 
-export { BOX_SCHEMA, BUNDLE_EXTENSION, BUNDLE_SCHEMA, type Box, type BoxMap, type BoxShard, type Bundle, type BundleBackground, type BundleContent, type BundleMap, type BundleSettings, CONTRACTS_DIR, CONTRACT_SCHEMA, type CanvasFurniture, type Card, type Comment, type CommentMark, type CommentMessage, type ContractProperty, type ContractShard, type CoverageConfig, type CoverageDriver, DECK_SCHEMA, DEFAULT_PLAY_RUNG, type Deck, type DeckCanvas, type DeckShard, FURNITURE_COLOURS, type FieldDecl, type FlowSave, type Frame, type FurnitureColour, HANDS_SCHEMA, type Hand, type HandBinding, type HandRule, type HandTemplate, type HandsShard, type HoleRef, type HoleRefScope, type LoadEviction, type LoadProperty, type LoadReport, NOTES_SCHEMA, type NotesShard, type Outcome, PLACE_GROUP, PROJECT_FOLDER_EXTENSION, PROJECT_SCHEMA, type PlayRecord, type PlayRung, type Polygon, type ProjectSettings, type ProjectShard, type PropertyBag, type PropertyDecl, type PropertyType, type PropsPartition, type Rect, type RedrawPolicy, SAVEFILE_SCHEMA, SAVE_SCHEMA, SHARD_EXTENSIONS, SPATIAL, type SaveEnvelope, type SaveFile, type SharedSave, type SpatialBackground, type SpatialGroup, type StackMove, type Stacked, TAGS_SCHEMA, type Tag, type TagGroup, type TagsShard, VIEW_SCHEMA, type ValueAddresses, type ViewPoint, type ViewShard, ambiguousValueAddressMessage, backgroundsOf, bindHand, bundleAssetPath, byDisplayOrder, centroid, commentsOf, contractPropertyPath, contractPropertyType, droppedRect, effectiveGameId, framesOf, freeGameId, freeTitle, gameIdify, handBinding, inferDeclFromWrite, isHoleRef, isSpatial, isValidGameId, labelPoint, markOf, marksOn, openThreadCounts, parseHoleRef, pointInPolygon, polygonBounds, polygonOf, restack, spatialOf, stacked, threadsFor, turnSpan, unbindHand, valueAddresses, withBackgrounds, withPolygon, withSpatialGroup, withZ, zOf, zoneAt, zonesAt };
+export { BOX_SCHEMA, BUNDLE_EXTENSION, BUNDLE_SCHEMA, type Box, type BoxMap, type BoxShard, type Bundle, type BundleBackground, type BundleContent, type BundleMap, type BundleSettings, CONTRACTS_DIR, CONTRACT_SCHEMA, type CanvasFurniture, type Card, type Comment, type CommentMark, type CommentMessage, type ContractProperty, type ContractShard, type CoverageConfig, type CoverageDriver, DECK_SCHEMA, DEFAULT_PLAY_RUNG, type Deck, type DeckCanvas, type DeckShard, FURNITURE_COLOURS, type FieldDecl, type FlowSave, type Frame, type FurnitureColour, HANDS_SCHEMA, type Hand, type HandBinding, type HandRule, type HandTemplate, type HandsShard, type HoleRef, type HoleRefScope, type LoadEviction, type LoadProperty, type LoadReport, MAP_SCHEMA, type MapShard, NOTES_SCHEMA, type NotesShard, type Outcome, PLACE_GROUP, PROJECT_FOLDER_EXTENSION, PROJECT_SCHEMA, type PlayRecord, type PlayRung, type Polygon, type ProjectSettings, type ProjectShard, type PropertyBag, type PropertyDecl, type PropertyType, type PropsPartition, type Rect, type RedrawPolicy, SAVEFILE_SCHEMA, SAVE_SCHEMA, SHARD_EXTENSIONS, SPATIAL, type SaveEnvelope, type SaveFile, type SharedSave, type SpatialBackground, type SpatialGroup, type StackMove, type Stacked, TAGS_SCHEMA, type Tag, type TagGroup, type TagsShard, VIEW_SCHEMA, type ValueAddresses, type ViewPoint, type ViewShard, ambiguousValueAddressMessage, backgroundsOf, bindHand, bundleAssetPath, byDisplayOrder, centroid, commentsOf, contractPropertyPath, contractPropertyType, droppedRect, effectiveGameId, framesOf, freeGameId, freeTitle, gameIdify, handBinding, inferDeclFromWrite, isHoleRef, isSpatial, isValidGameId, labelPoint, markOf, marksOn, openThreadCounts, parseHoleRef, pointInPolygon, polygonBounds, polygonOf, restack, spatialOf, stacked, threadsFor, turnSpan, unbindHand, valueAddresses, withBackgrounds, withPolygon, withSpatialGroup, withZ, zOf, zoneAt, zonesAt };

package/dist/index.d.ts

@@ -430,8 +430,9 @@ interface PropertyDecl {
     durable?: boolean;
     purpose?: string;
 }
-/** A card-template field (box-defined). Data for the host; the engine never
- *  interprets fields and they are not addressable from expressions. */
+/** A template field (box-defined), of the card template or of the outcome
+ *  fields. Data for the host; the engine never interprets fields and they are
+ *  not addressable from expressions. */
 interface FieldDecl {
     name: string;
     type: PropertyType;
@@ -544,6 +545,11 @@ interface Outcome<E> {
     /** Target ("@scope.name") -> expression; all right-hand sides evaluate
      *  against pre-play state (schema 3.7). */
     changes: Record<string, E>;
+    /** Template data, as `Card.fields` is: field name -> value, declared by
+     *  the box's `outcomeFields`, validated at publish, and handed to the host
+     *  with the outcome. The engine never reads it: a press can say one line
+     *  ("The notice is in your pocket") without spending a card on it. */
+    fields?: Record<string, ScalarValue>;
 }
 interface Card<E> {
     id: string;
@@ -847,6 +853,10 @@ interface Box<E> {
     };
     /** The card template: what every card in this box carries. */
     fields: FieldDecl[];
+    /** What every outcome in this box may carry, declared the same way.
+     *  Absent when the box declares none, so a bundle without them is byte for
+     *  byte what it was. */
+    outcomeFields?: FieldDecl[];
     properties: PropertyDecl[];
     tagGroups: TagGroup[];
     decks: Deck<E>[];
@@ -1127,11 +1137,22 @@ declare const SHARD_EXTENSIONS: {
     readonly tags: ".storylettags";
     readonly hands: ".storylethands";
     readonly deck: ".storyletdeck";
-    /** The arrangement layer: where things SIT, never what they are. Its own shard
-     *  because positions churn (an afternoon of tidying a canvas touches every
-     *  card) and content does not, so a designer arranging and a writer editing
-     *  never collide on one file (design/graphical-views.md section 1.2). */
+    /** The AUTHOR's arrangement layer: the canvases, where cards sit on a deck's
+     *  node canvas and the furniture drawn round them. Its own shard because
+     *  positions churn (an afternoon of tidying a canvas touches every card) and
+     *  content does not, so a designer arranging and a writer editing never
+     *  collide on one file (design/graphical-views.md section 1.2). */
     readonly view: ".storyletview";
+    /** The DESIGNER's map: where a box's hands stand in space, and the furniture
+     *  round them. One per box, beside the view shard.
+     *
+     *  Split out of the view shard on 2026-09-06 (design/engine-server.md 9.1
+     *  point 5) because the two halves stopped having one owner. A hand's
+     *  position ships in the bundle's `maps` block (4.3) and is where a venue's
+     *  kiosk stands, so it is SHAPE, which a server's author key may not change;
+     *  the canvases are the author's own working drawing and never leave the
+     *  project folder. One file could not be both. */
+    readonly map: ".storyletmap";
     /** Threaded comments: content-ADJACENT, so neither in a content shard (a
      *  writer's deck edit must not conflict with a reviewer's comment) nor in the
      *  arrangement sidecar (this is not where anything sits). One per box,
@@ -1157,6 +1178,7 @@ declare const TAGS_SCHEMA = "storylets/tags@0";
 declare const HANDS_SCHEMA = "storylets/hands@0";
 declare const DECK_SCHEMA = "storylets/deck@0";
 declare const VIEW_SCHEMA = "storylets/view@0";
+declare const MAP_SCHEMA = "storylets/map@0";
 /** The comment sidecar's schema. Still called "notes" on disk: the file already
  *  held both, and renaming it would break every project for no gain. */
 declare const NOTES_SCHEMA = "storylets/notes@0";
@@ -1203,6 +1225,10 @@ interface ContractShard {
     properties?: ContractProperty[];
     /** Card-template field names the crew and the bridges read. */
     fields?: string[];
+    /** Outcome field names they read, the same way: the after-line a station
+     *  shows when a press lands. What `fields` is to the card template, this is
+     *  to the box's `outcomeFields`. */
+    outcomeFields?: string[];
 }
 /**
  * One contracted property.
@@ -1284,7 +1310,9 @@ interface DeckCanvas extends CanvasFurniture {
     /** Keyed by CARD id. */
     cards?: Record<string, ViewPoint>;
 }
-/** The box's map: where its hands sit in space, and the furniture around them. */
+/** The box's map: where its hands sit in space, and the furniture around them.
+ *  Carried by the MAP shard since 2026-09-06; `ViewShard.map` is the old
+ *  address, read for one release and never written. */
 interface BoxMap extends CanvasFurniture {
     /** Keyed by HAND id. WHERE a site is, and nothing else.
      *
@@ -1300,7 +1328,8 @@ interface BoxMap extends CanvasFurniture {
      *  were edited. */
     sites?: Record<string, ViewPoint>;
 }
-/** The arrangement layer for one box: where things SIT, never what they are.
+/** The AUTHOR's arrangement layer for one box: where cards sit on their decks'
+ *  canvases, and the furniture drawn round them.
  *
  *  Its own shard on purpose (design/graphical-views.md section 1.2). Positions
  *  churn, content does not: an afternoon of tidying a canvas touches every card,
@@ -1315,8 +1344,33 @@ interface ViewShard {
     schema: typeof VIEW_SCHEMA;
     /** Keyed by DECK id: one node canvas each. */
     canvases?: Record<string, DeckCanvas>;
+    /** @deprecated The box map's old address, kept for one release and READ ONLY.
+     *  A reader that meets it uses it when the box has no `MapShard`, and the
+     *  formatter moves it; nothing writes it any more. Removed after the next
+     *  release, at which point a map left here is simply lost. */
     map?: BoxMap;
 }
+/** The DESIGNER's map for one box: where its hands stand in space.
+ *
+ *  Split out of the view shard on 2026-09-06 (design/engine-server.md 9.1 point
+ *  5). The two halves had stopped sharing an owner: a hand's position ships in
+ *  the bundle's `maps` block (4.3), which makes it the thing a venue provisions
+ *  its kiosks against, while a deck's canvas is a working drawing that never
+ *  leaves the folder. A server's author key may change the canvases and not
+ *  this.
+ *
+ *  The map is NESTED under `map` rather than flattened to the top level, and
+ *  deliberately: the block's bytes are then exactly what the view shard held, so
+ *  the migration is a move of a value rather than a reshaping of it, the merge
+ *  strategy carries over word for word, and a reader that has to look in both
+ *  places is one expression (`box.map?.map ?? box.view?.map`).
+ *
+ *  Source-only in the sense the view shard is not: `compileMaps` reads the
+ *  positions for the bundle's `maps` block, under `export.map`. */
+interface MapShard {
+    schema: typeof MAP_SCHEMA;
+    map: BoxMap;
+}
 /** A coverage input driver: during a coverage run the harness feeds a
  *  host-seam property (`@world.x`) values from `values`, so content gated on
  *  external state gets exercised (Patter's coverageDrivers, carried whole). */
@@ -1416,6 +1470,9 @@ interface BoxShard {
             seconds: number;
         };
         fields: FieldDecl[];
+        /** The outcome fields (see `Box.outcomeFields`); a shard without the key
+         *  declares none. */
+        outcomeFields?: FieldDecl[];
         properties: PropertyDecl[];
     };
 }
@@ -1449,4 +1506,4 @@ interface DeckShard {
     cards: Card<string>[];
 }
 
-export { BOX_SCHEMA, BUNDLE_EXTENSION, BUNDLE_SCHEMA, type Box, type BoxMap, type BoxShard, type Bundle, type BundleBackground, type BundleContent, type BundleMap, type BundleSettings, CONTRACTS_DIR, CONTRACT_SCHEMA, type CanvasFurniture, type Card, type Comment, type CommentMark, type CommentMessage, type ContractProperty, type ContractShard, type CoverageConfig, type CoverageDriver, DECK_SCHEMA, DEFAULT_PLAY_RUNG, type Deck, type DeckCanvas, type DeckShard, FURNITURE_COLOURS, type FieldDecl, type FlowSave, type Frame, type FurnitureColour, HANDS_SCHEMA, type Hand, type HandBinding, type HandRule, type HandTemplate, type HandsShard, type HoleRef, type HoleRefScope, type LoadEviction, type LoadProperty, type LoadReport, NOTES_SCHEMA, type NotesShard, type Outcome, PLACE_GROUP, PROJECT_FOLDER_EXTENSION, PROJECT_SCHEMA, type PlayRecord, type PlayRung, type Polygon, type ProjectSettings, type ProjectShard, type PropertyBag, type PropertyDecl, type PropertyType, type PropsPartition, type Rect, type RedrawPolicy, SAVEFILE_SCHEMA, SAVE_SCHEMA, SHARD_EXTENSIONS, SPATIAL, type SaveEnvelope, type SaveFile, type SharedSave, type SpatialBackground, type SpatialGroup, type StackMove, type Stacked, TAGS_SCHEMA, type Tag, type TagGroup, type TagsShard, VIEW_SCHEMA, type ValueAddresses, type ViewPoint, type ViewShard, ambiguousValueAddressMessage, backgroundsOf, bindHand, bundleAssetPath, byDisplayOrder, centroid, commentsOf, contractPropertyPath, contractPropertyType, droppedRect, effectiveGameId, framesOf, freeGameId, freeTitle, gameIdify, handBinding, inferDeclFromWrite, isHoleRef, isSpatial, isValidGameId, labelPoint, markOf, marksOn, openThreadCounts, parseHoleRef, pointInPolygon, polygonBounds, polygonOf, restack, spatialOf, stacked, threadsFor, turnSpan, unbindHand, valueAddresses, withBackgrounds, withPolygon, withSpatialGroup, withZ, zOf, zoneAt, zonesAt };
+export { BOX_SCHEMA, BUNDLE_EXTENSION, BUNDLE_SCHEMA, type Box, type BoxMap, type BoxShard, type Bundle, type BundleBackground, type BundleContent, type BundleMap, type BundleSettings, CONTRACTS_DIR, CONTRACT_SCHEMA, type CanvasFurniture, type Card, type Comment, type CommentMark, type CommentMessage, type ContractProperty, type ContractShard, type CoverageConfig, type CoverageDriver, DECK_SCHEMA, DEFAULT_PLAY_RUNG, type Deck, type DeckCanvas, type DeckShard, FURNITURE_COLOURS, type FieldDecl, type FlowSave, type Frame, type FurnitureColour, HANDS_SCHEMA, type Hand, type HandBinding, type HandRule, type HandTemplate, type HandsShard, type HoleRef, type HoleRefScope, type LoadEviction, type LoadProperty, type LoadReport, MAP_SCHEMA, type MapShard, NOTES_SCHEMA, type NotesShard, type Outcome, PLACE_GROUP, PROJECT_FOLDER_EXTENSION, PROJECT_SCHEMA, type PlayRecord, type PlayRung, type Polygon, type ProjectSettings, type ProjectShard, type PropertyBag, type PropertyDecl, type PropertyType, type PropsPartition, type Rect, type RedrawPolicy, SAVEFILE_SCHEMA, SAVE_SCHEMA, SHARD_EXTENSIONS, SPATIAL, type SaveEnvelope, type SaveFile, type SharedSave, type SpatialBackground, type SpatialGroup, type StackMove, type Stacked, TAGS_SCHEMA, type Tag, type TagGroup, type TagsShard, VIEW_SCHEMA, type ValueAddresses, type ViewPoint, type ViewShard, ambiguousValueAddressMessage, backgroundsOf, bindHand, bundleAssetPath, byDisplayOrder, centroid, commentsOf, contractPropertyPath, contractPropertyType, droppedRect, effectiveGameId, framesOf, freeGameId, freeTitle, gameIdify, handBinding, inferDeclFromWrite, isHoleRef, isSpatial, isValidGameId, labelPoint, markOf, marksOn, openThreadCounts, parseHoleRef, pointInPolygon, polygonBounds, polygonOf, restack, spatialOf, stacked, threadsFor, turnSpan, unbindHand, valueAddresses, withBackgrounds, withPolygon, withSpatialGroup, withZ, zOf, zoneAt, zonesAt };

package/dist/index.js

@@ -479,11 +479,22 @@ var SHARD_EXTENSIONS = {
   tags: ".storylettags",
   hands: ".storylethands",
   deck: ".storyletdeck",
-  /** The arrangement layer: where things SIT, never what they are. Its own shard
-   *  because positions churn (an afternoon of tidying a canvas touches every
-   *  card) and content does not, so a designer arranging and a writer editing
-   *  never collide on one file (design/graphical-views.md section 1.2). */
+  /** The AUTHOR's arrangement layer: the canvases, where cards sit on a deck's
+   *  node canvas and the furniture drawn round them. Its own shard because
+   *  positions churn (an afternoon of tidying a canvas touches every card) and
+   *  content does not, so a designer arranging and a writer editing never
+   *  collide on one file (design/graphical-views.md section 1.2). */
   view: ".storyletview",
+  /** The DESIGNER's map: where a box's hands stand in space, and the furniture
+   *  round them. One per box, beside the view shard.
+   *
+   *  Split out of the view shard on 2026-09-06 (design/engine-server.md 9.1
+   *  point 5) because the two halves stopped having one owner. A hand's
+   *  position ships in the bundle's `maps` block (4.3) and is where a venue's
+   *  kiosk stands, so it is SHAPE, which a server's author key may not change;
+   *  the canvases are the author's own working drawing and never leave the
+   *  project folder. One file could not be both. */
+  map: ".storyletmap",
   /** Threaded comments: content-ADJACENT, so neither in a content shard (a
    *  writer's deck edit must not conflict with a reviewer's comment) nor in the
    *  arrangement sidecar (this is not where anything sits). One per box,
@@ -506,6 +517,7 @@ var TAGS_SCHEMA = "storylets/tags@0";
 var HANDS_SCHEMA = "storylets/hands@0";
 var DECK_SCHEMA = "storylets/deck@0";
 var VIEW_SCHEMA = "storylets/view@0";
+var MAP_SCHEMA = "storylets/map@0";
 var NOTES_SCHEMA = "storylets/notes@0";
 var CONTRACT_SCHEMA = "storylets/contract@0";
 var contractPropertyPath = (p) => typeof p === "string" ? p : p.path;
@@ -521,6 +533,7 @@ export {
   DEFAULT_PLAY_RUNG,
   FURNITURE_COLOURS,
   HANDS_SCHEMA,
+  MAP_SCHEMA,
   NOTES_SCHEMA,
   PLACE_GROUP,
   PROJECT_FOLDER_EXTENSION,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@storylet-studio/model",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Storylets data-model types: source shards (project / box / tags / hands / deck), the compiled bundle, the save envelope. The shape source-of-truth.",
   "type": "module",
   "license": "MIT",