@patterkit/model 0.16.0 → 0.17.0

package/dist/index.d.cts

@@ -667,8 +667,9 @@ interface ProjectFile {
      * The Patter extensions this project takes, by id (ruled 2026-10-18: the project opts in), each pinned to a
      * version, with its settings (the host fields its claims present, by setting name). The manifest itself
      * sits in `extensions/<id>.extension.json`, and the data in `.patterextension` shards. Authoring config:
-     * the bundle carries each one's compiled declarations and values, never this block. An extension named
-     * here whose manifest is missing is a warning, and its data is left untouched.
+     * the bundle carries each one's compiled declarations, values, and resolved settings
+     * (`BundleExtension.settings`), never this block itself. An extension named here whose manifest is missing
+     * is a warning, and its data is left untouched.
      */
     extensions?: Record<string, ProjectExtension>;
     /** Ordered writing-status ladder (not-done -> done); default `DEFAULT_WRITING_STATUSES`. */
@@ -1072,9 +1073,9 @@ interface Bundle {
     gameDataFields?: GameDataFields;
     /**
      * The extensions the project takes, by id: each one's version and its compiled declarations by node kind,
-     * every default resolved (what `extensionDecls` reads), and the project node's own values. A node's values
-     * sit on the node, under `extensions`. Absent when the project takes none, so a bundle without them is
-     * byte for byte what it was.
+     * every default resolved (what `extensionDecls` reads), the project node's own values, and its settings,
+     * resolved (what `extensionSettings` reads). A node's values sit on the node, under `extensions`. Absent
+     * when the project takes none, so a bundle without them is byte for byte what it was.
      */
     extensions?: Record<string, BundleExtension>;
     scenes: Record<string, CompiledScene>;
@@ -1325,6 +1326,13 @@ interface BundleExtension {
     fields: Record<string, ExtensionFieldDecl[]>;
     /** The project node's values, raw, when it has any. */
     project?: Record<string, unknown>;
+    /**
+     * Every setting the manifest declares, by setting name, keys sorted: the project's value (`ProjectExtension.
+     * settings`), or else the setting's default (`@wildwinter/toolkit/extensions`' `settingValues`). A setting
+     * names a host field, so a game reads here which gameData field holds what the extension claims. Present
+     * only when the manifest declares settings.
+     */
+    settings?: Record<string, string>;
 }
 /**
  * A compiled extension field declaration (`@wildwinter/toolkit/extensions`' FieldDecl, less the editor's

package/dist/index.d.ts

@@ -667,8 +667,9 @@ interface ProjectFile {
      * The Patter extensions this project takes, by id (ruled 2026-10-18: the project opts in), each pinned to a
      * version, with its settings (the host fields its claims present, by setting name). The manifest itself
      * sits in `extensions/<id>.extension.json`, and the data in `.patterextension` shards. Authoring config:
-     * the bundle carries each one's compiled declarations and values, never this block. An extension named
-     * here whose manifest is missing is a warning, and its data is left untouched.
+     * the bundle carries each one's compiled declarations, values, and resolved settings
+     * (`BundleExtension.settings`), never this block itself. An extension named here whose manifest is missing
+     * is a warning, and its data is left untouched.
      */
     extensions?: Record<string, ProjectExtension>;
     /** Ordered writing-status ladder (not-done -> done); default `DEFAULT_WRITING_STATUSES`. */
@@ -1072,9 +1073,9 @@ interface Bundle {
     gameDataFields?: GameDataFields;
     /**
      * The extensions the project takes, by id: each one's version and its compiled declarations by node kind,
-     * every default resolved (what `extensionDecls` reads), and the project node's own values. A node's values
-     * sit on the node, under `extensions`. Absent when the project takes none, so a bundle without them is
-     * byte for byte what it was.
+     * every default resolved (what `extensionDecls` reads), the project node's own values, and its settings,
+     * resolved (what `extensionSettings` reads). A node's values sit on the node, under `extensions`. Absent
+     * when the project takes none, so a bundle without them is byte for byte what it was.
      */
     extensions?: Record<string, BundleExtension>;
     scenes: Record<string, CompiledScene>;
@@ -1325,6 +1326,13 @@ interface BundleExtension {
     fields: Record<string, ExtensionFieldDecl[]>;
     /** The project node's values, raw, when it has any. */
     project?: Record<string, unknown>;
+    /**
+     * Every setting the manifest declares, by setting name, keys sorted: the project's value (`ProjectExtension.
+     * settings`), or else the setting's default (`@wildwinter/toolkit/extensions`' `settingValues`). A setting
+     * names a host field, so a game reads here which gameData field holds what the extension claims. Present
+     * only when the manifest declares settings.
+     */
+    settings?: Record<string, string>;
 }
 /**
  * A compiled extension field declaration (`@wildwinter/toolkit/extensions`' FieldDecl, less the editor's

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patterkit/model",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Patter data-model types: source (scene/block/group/snippet/beat/jump), project, locale, authoring. The shape source-of-truth.",
   "type": "module",
   "license": "MIT",