@patterkit/model 0.4.0 → 0.5.0

package/dist/index.cjs

@@ -29,19 +29,22 @@ __export(index_exports, {
   PROJECT_LOCALE_SCENE: () => PROJECT_LOCALE_SCENE,
   RERECORD_STATUS: () => RERECORD_STATUS,
   RERECORD_STATUS_DECL: () => RERECORD_STATUS_DECL,
-  RESERVED_PROPERTY_NAMES: () => RESERVED_PROPERTY_NAMES,
+  RESERVED_PROPERTY_NAMES: () => import_expr.RESERVED_PROPERTY_NAMES,
+  SAVE_SCHEMA: () => SAVE_SCHEMA,
+  SAVE_VERSION: () => SAVE_VERSION,
   castStringKey: () => castStringKey,
   deriveRecordingFolders: () => deriveRecordingFolders,
   effectiveGameId: () => effectiveGameId,
   gameIdify: () => gameIdify,
-  isCaseOnlyPropertyName: () => isCaseOnlyPropertyName,
+  isCaseOnlyPropertyName: () => import_expr.isCaseOnlyPropertyName,
   isContentlessBeat: () => isContentlessBeat,
   isValidGameId: () => isValidGameId,
-  isValidPropertyName: () => isValidPropertyName,
-  propertyNameify: () => propertyNameify,
+  isValidPropertyName: () => import_expr.isValidPropertyName,
+  propertyNameify: () => import_expr.propertyNameify,
   walkNodes: () => walkNodes
 });
 module.exports = __toCommonJS(index_exports);
+var import_expr = require("@wildwinter/expr");
 function walkNodes(nodes, visit) {
   for (const node of nodes) {
     visit(node);
@@ -62,22 +65,6 @@ function gameIdify(text) {
 function isValidGameId(gameId) {
   return /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/.test(gameId);
 }
-var RESERVED_PROPERTY_NAMES = ["true", "false", "and", "or", "not"];
-function propertyNameify(text) {
-  const trimmed = text.trim();
-  const deliberateLeading = trimmed.startsWith("_");
-  let out = trimmed.toLowerCase().replace(/['\u2019]/g, "").replace(/[^a-z0-9_]+/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
-  if (out === "") return "";
-  if (deliberateLeading || /^[0-9]/.test(out)) out = `_${out}`;
-  if (RESERVED_PROPERTY_NAMES.includes(out)) out = `${out}_`;
-  return out;
-}
-function isValidPropertyName(name) {
-  return /^[a-z_][a-z0-9_]*$/.test(name) && !RESERVED_PROPERTY_NAMES.includes(name);
-}
-function isCaseOnlyPropertyName(name) {
-  return !isValidPropertyName(name) && isValidPropertyName(name.toLowerCase());
-}
 function effectiveGameId(entity) {
   const g = entity.gameId?.trim();
   return g ? g : gameIdify(entity.name);
@@ -128,6 +115,8 @@ function castStringKey(name) {
 }
 var DEFAULT_CAPTION_DELIMITERS = { open: "[", close: "]" };
 var DEFAULT_CAPTION_CHARACTER = "SFX";
+var SAVE_SCHEMA = "patter/save@0";
+var SAVE_VERSION = 2;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   COMMON_GENDERS,
@@ -140,6 +129,8 @@ var DEFAULT_CAPTION_CHARACTER = "SFX";
   RERECORD_STATUS,
   RERECORD_STATUS_DECL,
   RESERVED_PROPERTY_NAMES,
+  SAVE_SCHEMA,
+  SAVE_VERSION,
   castStringKey,
   deriveRecordingFolders,
   effectiveGameId,

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 import { AstNode } from '@wildwinter/expr';
+export { RESERVED_PROPERTY_NAMES, isCaseOnlyPropertyName, isValidPropertyName, propertyNameify } from '@wildwinter/expr';
 
 type ScalarValue = boolean | number | string | string[];
 /** Developer-defined host metadata (spec §17). Opaque to Patter. */
@@ -207,21 +208,7 @@ declare function isContentlessBeat(beat: Beat, hasText: boolean): boolean;
 declare function gameIdify(text: string): string;
 /** A valid authored game id: lowercase alphanumerics + hyphens, no leading / trailing hyphen. */
 declare function isValidGameId(gameId: string): boolean;
-/** The words `@wildwinter/expr` lexes as keywords, so no property may be called one.
- *  `packages/model/test/property-name-grammar.test.ts` probes the real parser rather
- *  than trusting this copy. */
-declare const RESERVED_PROPERTY_NAMES: readonly string[];
-/** Coerce a label into a legal property name: lower case, apostrophes dropped, runs of
- *  anything else to a single underscore, no trailing underscore, an underscore in front
- *  of a leading digit, one behind a keyword. "" when nothing usable was left. */
-declare function propertyNameify(text: string): string;
-/** Is this a name an expression can actually reach? Lower case letters, digits and
- *  underscores, not starting with a digit, not a keyword. "" is not a name. */
-declare function isValidPropertyName(name: string): boolean;
-/** True when folding case ALONE would make it legal (`isNight`). The only violation a
- *  loader may repair without guessing at intent: every reference is folded already, so
- *  folding the declaration to match changes nothing observable. */
-declare function isCaseOnlyPropertyName(name: string): boolean;
+
 /** The effective address: the explicit `gameId` if pinned, else derived from `name`. */
 declare function effectiveGameId(entity: {
     gameId?: string;
@@ -858,5 +845,97 @@ declare const DEFAULT_CAPTION_DELIMITERS: CaptionDelimiters;
 /** The default caption character: a cast member named `SFX` whose lines are pure captions (omitted when
  *  captions are off). Applies even to a project that pins no `closedCaptions`. */
 declare const DEFAULT_CAPTION_CHARACTER = "SFX";
+declare const SAVE_SCHEMA = "patter/save@0";
+/** The `save.version` inside the envelope. Bumped only when a reader would MISREAD an older save. */
+declare const SAVE_VERSION = 2;
+/** The tagged envelope a host stores: `serializeState` writes it, `deserializeState` refuses anything else. */
+interface SaveEnvelope {
+    schema: typeof SAVE_SCHEMA;
+    save: SaveGame;
+}
+/** A property-state snapshot: owned scope -> property name -> value (`{ patter: { gold: 7 } }`). */
+type EngineSave = Record<string, Record<string, ScalarValue>>;
+/** Serialised `sequence` selector visit state for one group (spec §4 / §7). Every key is OPTIONAL and
+ *  present only once the selector has used it: `seq` after the first sequential pick, `bag` once a
+ *  shuffle has drawn, `last` once there is a no-immediate-repeat memory. A port that stores "started"
+ *  flags derives them from key presence rather than writing them. */
+interface SelectorSnapshot {
+    seq?: number;
+    bag?: string[];
+    last?: string;
+}
+/** One entry on a flow's continuation stack: a position within a container's children. */
+interface StackFrame {
+    sceneId: string;
+    /** A block id or a run-group id (both are sequential containers). */
+    containerId: string;
+    index: number;
+    /** SNAPSHOT-ONLY (never on a live frame): the id of the child at `index` when the save was taken, so a
+     *  restore against an EDITED bundle re-finds the position by id. Absent when the frame sat at its
+     *  container's end (no next child), or in an older save. */
+    nextId?: string;
+}
+/** The prompt of a saved choice option: the choice text as a structured line/text beat. */
+interface SavedChoicePrompt {
+    kind: "line" | "text";
+    text: string;
+    character?: string;
+    characterName?: string;
+    direction?: string;
+}
+/** One option of a pending choice, saved VERBATIM: re-deriving on load would re-evaluate conditions. */
+interface SavedChoiceOption {
+    id: string;
+    prompt?: SavedChoicePrompt;
+    eligible: boolean;
+    gameData?: GameData;
+}
+/** A pending choice as saved: the option set the player was shown, replayed on load (schema 9.3). */
+interface SavedChoice {
+    groupId: string;
+    options: SavedChoiceOption[];
+}
+/** The flow's execution position: where it is, and what it is waiting on. */
+interface FlowCursor {
+    flowEnded: boolean;
+    currentSceneId: string | null;
+    /** The continuation stack (call frames + the active block run), root first. */
+    stack: StackFrame[];
+    activeSnippetId: string | null;
+    beatIndex: number;
+    /** Present (non-null) iff the flow is stopped at a choice. */
+    pendingChoice: SavedChoice | null;
+    /** The chosen option owning a prompt still to be replayed (a save taken between choose + advance).
+     *  Optional / null in older saves -> no pending prompt. */
+    pendingPromptOwnerId?: string | null;
+    /** This flow's (non-shared) selector cursors, keyed by group id. */
+    selectors: Record<string, SelectorSnapshot>;
+}
+/** The serialised cursor + scopes + PRNG of a single flow. */
+interface FlowSnapshot {
+    /** This flow's owned-scope values = the NOT-shared `@patter` globals, under token "patter". */
+    scopes: EngineSave;
+    /** Per-scene NOT-shared `@scene` bags (scene id -> name -> value); persist across re-entries (spec §7). */
+    sceneBags: Record<string, Record<string, ScalarValue>>;
+    /** This flow's built-in PRNG position (mulberry32 state, uint32; older saves may carry it signed). */
+    rngState: number;
+    /** This flow's per-node entry counts (node id -> times entered by this flow). */
+    visits: Record<string, number>;
+    cursor: FlowCursor;
+}
+/** A full resumable save-game: shared `@patter` state + every live flow. */
+interface SaveGame {
+    version: number;
+    /** Shared `@patter` globals (owned scope "patter"). */
+    shared: EngineSave;
+    /** World-wide per-node entry counts (node id -> times entered by any flow). */
+    sharedVisits: Record<string, number>;
+    /** Shared selector cursors (node id -> snapshot) for `shared` memoried selectors. */
+    sharedSelectors: Record<string, SelectorSnapshot>;
+    /** Shared, scene-namespaced `@scene` bags (scene id -> name -> value) - the shared scene props. */
+    stageBags: Record<string, Record<string, ScalarValue>>;
+    /** Each live flow's snapshot, keyed by flow id. */
+    flows: Record<string, FlowSnapshot>;
+}
 
-export { type AuthoringFile, type Beat, type Block, type Bundle, type BundleCastMember, COMMON_GENDERS, type CaptionDelimiters, type CastMember, type Comment, type CommentMessage, type CommentRange, type CompiledBlock, type CompiledEffect, type CompiledGroup, type CompiledScene, type CompiledSnippet, type CoverageDriver, DEFAULT_CAPTION_CHARACTER, DEFAULT_CAPTION_DELIMITERS, DEFAULT_DOCUMENTATION_CLASSES, DEFAULT_RECORDING_STATUSES, DEFAULT_WRITING_STATUSES, type DocLine, type DocumentationClass, type EditRecord, type Effect, type EstimatingConfig, type Expression, type FlowFile, type FlowNode, type GameData, type GameDataField, type GameDataFieldType, type GameDataFields, type GameDataNodeKind, type GameEventBeat, type GrammaticalGender, type Group, type HostScopeDecl, type HostScopeRegistry, type HostScopeSpec, type Jump, type JumpTarget, type LineBeat, type LocaleFile, PROJECT_LOCALE_SCENE, type ProjectDictionary, type ProjectFile, type PromptBeat, type PropertyDecl, type PropertyType, RERECORD_STATUS, RERECORD_STATUS_DECL, RESERVED_PROPERTY_NAMES, type RecordingFolder, type RecordingStatusDecl, type ScalarValue, type Scene, type Selector, type SelectorExhaust, type SelectorOrder, type SequenceOptions, type Snippet, type Suggestion, type TextBeat, type VcsKind, type WritingStatusDecl, castStringKey, deriveRecordingFolders, effectiveGameId, gameIdify, isCaseOnlyPropertyName, isContentlessBeat, isValidGameId, isValidPropertyName, propertyNameify, walkNodes };
+export { type AuthoringFile, type Beat, type Block, type Bundle, type BundleCastMember, COMMON_GENDERS, type CaptionDelimiters, type CastMember, type Comment, type CommentMessage, type CommentRange, type CompiledBlock, type CompiledEffect, type CompiledGroup, type CompiledScene, type CompiledSnippet, type CoverageDriver, DEFAULT_CAPTION_CHARACTER, DEFAULT_CAPTION_DELIMITERS, DEFAULT_DOCUMENTATION_CLASSES, DEFAULT_RECORDING_STATUSES, DEFAULT_WRITING_STATUSES, type DocLine, type DocumentationClass, type EditRecord, type Effect, type EngineSave, type EstimatingConfig, type Expression, type FlowCursor, type FlowFile, type FlowNode, type FlowSnapshot, type GameData, type GameDataField, type GameDataFieldType, type GameDataFields, type GameDataNodeKind, type GameEventBeat, type GrammaticalGender, type Group, type HostScopeDecl, type HostScopeRegistry, type HostScopeSpec, type Jump, type JumpTarget, type LineBeat, type LocaleFile, PROJECT_LOCALE_SCENE, type ProjectDictionary, type ProjectFile, type PromptBeat, type PropertyDecl, type PropertyType, RERECORD_STATUS, RERECORD_STATUS_DECL, type RecordingFolder, type RecordingStatusDecl, SAVE_SCHEMA, SAVE_VERSION, type SaveEnvelope, type SaveGame, type SavedChoice, type SavedChoiceOption, type SavedChoicePrompt, type ScalarValue, type Scene, type Selector, type SelectorExhaust, type SelectorOrder, type SelectorSnapshot, type SequenceOptions, type Snippet, type StackFrame, type Suggestion, type TextBeat, type VcsKind, type WritingStatusDecl, castStringKey, deriveRecordingFolders, effectiveGameId, gameIdify, isContentlessBeat, isValidGameId, walkNodes };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { AstNode } from '@wildwinter/expr';
+export { RESERVED_PROPERTY_NAMES, isCaseOnlyPropertyName, isValidPropertyName, propertyNameify } from '@wildwinter/expr';
 
 type ScalarValue = boolean | number | string | string[];
 /** Developer-defined host metadata (spec §17). Opaque to Patter. */
@@ -207,21 +208,7 @@ declare function isContentlessBeat(beat: Beat, hasText: boolean): boolean;
 declare function gameIdify(text: string): string;
 /** A valid authored game id: lowercase alphanumerics + hyphens, no leading / trailing hyphen. */
 declare function isValidGameId(gameId: string): boolean;
-/** The words `@wildwinter/expr` lexes as keywords, so no property may be called one.
- *  `packages/model/test/property-name-grammar.test.ts` probes the real parser rather
- *  than trusting this copy. */
-declare const RESERVED_PROPERTY_NAMES: readonly string[];
-/** Coerce a label into a legal property name: lower case, apostrophes dropped, runs of
- *  anything else to a single underscore, no trailing underscore, an underscore in front
- *  of a leading digit, one behind a keyword. "" when nothing usable was left. */
-declare function propertyNameify(text: string): string;
-/** Is this a name an expression can actually reach? Lower case letters, digits and
- *  underscores, not starting with a digit, not a keyword. "" is not a name. */
-declare function isValidPropertyName(name: string): boolean;
-/** True when folding case ALONE would make it legal (`isNight`). The only violation a
- *  loader may repair without guessing at intent: every reference is folded already, so
- *  folding the declaration to match changes nothing observable. */
-declare function isCaseOnlyPropertyName(name: string): boolean;
+
 /** The effective address: the explicit `gameId` if pinned, else derived from `name`. */
 declare function effectiveGameId(entity: {
     gameId?: string;
@@ -858,5 +845,97 @@ declare const DEFAULT_CAPTION_DELIMITERS: CaptionDelimiters;
 /** The default caption character: a cast member named `SFX` whose lines are pure captions (omitted when
  *  captions are off). Applies even to a project that pins no `closedCaptions`. */
 declare const DEFAULT_CAPTION_CHARACTER = "SFX";
+declare const SAVE_SCHEMA = "patter/save@0";
+/** The `save.version` inside the envelope. Bumped only when a reader would MISREAD an older save. */
+declare const SAVE_VERSION = 2;
+/** The tagged envelope a host stores: `serializeState` writes it, `deserializeState` refuses anything else. */
+interface SaveEnvelope {
+    schema: typeof SAVE_SCHEMA;
+    save: SaveGame;
+}
+/** A property-state snapshot: owned scope -> property name -> value (`{ patter: { gold: 7 } }`). */
+type EngineSave = Record<string, Record<string, ScalarValue>>;
+/** Serialised `sequence` selector visit state for one group (spec §4 / §7). Every key is OPTIONAL and
+ *  present only once the selector has used it: `seq` after the first sequential pick, `bag` once a
+ *  shuffle has drawn, `last` once there is a no-immediate-repeat memory. A port that stores "started"
+ *  flags derives them from key presence rather than writing them. */
+interface SelectorSnapshot {
+    seq?: number;
+    bag?: string[];
+    last?: string;
+}
+/** One entry on a flow's continuation stack: a position within a container's children. */
+interface StackFrame {
+    sceneId: string;
+    /** A block id or a run-group id (both are sequential containers). */
+    containerId: string;
+    index: number;
+    /** SNAPSHOT-ONLY (never on a live frame): the id of the child at `index` when the save was taken, so a
+     *  restore against an EDITED bundle re-finds the position by id. Absent when the frame sat at its
+     *  container's end (no next child), or in an older save. */
+    nextId?: string;
+}
+/** The prompt of a saved choice option: the choice text as a structured line/text beat. */
+interface SavedChoicePrompt {
+    kind: "line" | "text";
+    text: string;
+    character?: string;
+    characterName?: string;
+    direction?: string;
+}
+/** One option of a pending choice, saved VERBATIM: re-deriving on load would re-evaluate conditions. */
+interface SavedChoiceOption {
+    id: string;
+    prompt?: SavedChoicePrompt;
+    eligible: boolean;
+    gameData?: GameData;
+}
+/** A pending choice as saved: the option set the player was shown, replayed on load (schema 9.3). */
+interface SavedChoice {
+    groupId: string;
+    options: SavedChoiceOption[];
+}
+/** The flow's execution position: where it is, and what it is waiting on. */
+interface FlowCursor {
+    flowEnded: boolean;
+    currentSceneId: string | null;
+    /** The continuation stack (call frames + the active block run), root first. */
+    stack: StackFrame[];
+    activeSnippetId: string | null;
+    beatIndex: number;
+    /** Present (non-null) iff the flow is stopped at a choice. */
+    pendingChoice: SavedChoice | null;
+    /** The chosen option owning a prompt still to be replayed (a save taken between choose + advance).
+     *  Optional / null in older saves -> no pending prompt. */
+    pendingPromptOwnerId?: string | null;
+    /** This flow's (non-shared) selector cursors, keyed by group id. */
+    selectors: Record<string, SelectorSnapshot>;
+}
+/** The serialised cursor + scopes + PRNG of a single flow. */
+interface FlowSnapshot {
+    /** This flow's owned-scope values = the NOT-shared `@patter` globals, under token "patter". */
+    scopes: EngineSave;
+    /** Per-scene NOT-shared `@scene` bags (scene id -> name -> value); persist across re-entries (spec §7). */
+    sceneBags: Record<string, Record<string, ScalarValue>>;
+    /** This flow's built-in PRNG position (mulberry32 state, uint32; older saves may carry it signed). */
+    rngState: number;
+    /** This flow's per-node entry counts (node id -> times entered by this flow). */
+    visits: Record<string, number>;
+    cursor: FlowCursor;
+}
+/** A full resumable save-game: shared `@patter` state + every live flow. */
+interface SaveGame {
+    version: number;
+    /** Shared `@patter` globals (owned scope "patter"). */
+    shared: EngineSave;
+    /** World-wide per-node entry counts (node id -> times entered by any flow). */
+    sharedVisits: Record<string, number>;
+    /** Shared selector cursors (node id -> snapshot) for `shared` memoried selectors. */
+    sharedSelectors: Record<string, SelectorSnapshot>;
+    /** Shared, scene-namespaced `@scene` bags (scene id -> name -> value) - the shared scene props. */
+    stageBags: Record<string, Record<string, ScalarValue>>;
+    /** Each live flow's snapshot, keyed by flow id. */
+    flows: Record<string, FlowSnapshot>;
+}
 
-export { type AuthoringFile, type Beat, type Block, type Bundle, type BundleCastMember, COMMON_GENDERS, type CaptionDelimiters, type CastMember, type Comment, type CommentMessage, type CommentRange, type CompiledBlock, type CompiledEffect, type CompiledGroup, type CompiledScene, type CompiledSnippet, type CoverageDriver, DEFAULT_CAPTION_CHARACTER, DEFAULT_CAPTION_DELIMITERS, DEFAULT_DOCUMENTATION_CLASSES, DEFAULT_RECORDING_STATUSES, DEFAULT_WRITING_STATUSES, type DocLine, type DocumentationClass, type EditRecord, type Effect, type EstimatingConfig, type Expression, type FlowFile, type FlowNode, type GameData, type GameDataField, type GameDataFieldType, type GameDataFields, type GameDataNodeKind, type GameEventBeat, type GrammaticalGender, type Group, type HostScopeDecl, type HostScopeRegistry, type HostScopeSpec, type Jump, type JumpTarget, type LineBeat, type LocaleFile, PROJECT_LOCALE_SCENE, type ProjectDictionary, type ProjectFile, type PromptBeat, type PropertyDecl, type PropertyType, RERECORD_STATUS, RERECORD_STATUS_DECL, RESERVED_PROPERTY_NAMES, type RecordingFolder, type RecordingStatusDecl, type ScalarValue, type Scene, type Selector, type SelectorExhaust, type SelectorOrder, type SequenceOptions, type Snippet, type Suggestion, type TextBeat, type VcsKind, type WritingStatusDecl, castStringKey, deriveRecordingFolders, effectiveGameId, gameIdify, isCaseOnlyPropertyName, isContentlessBeat, isValidGameId, isValidPropertyName, propertyNameify, walkNodes };
+export { type AuthoringFile, type Beat, type Block, type Bundle, type BundleCastMember, COMMON_GENDERS, type CaptionDelimiters, type CastMember, type Comment, type CommentMessage, type CommentRange, type CompiledBlock, type CompiledEffect, type CompiledGroup, type CompiledScene, type CompiledSnippet, type CoverageDriver, DEFAULT_CAPTION_CHARACTER, DEFAULT_CAPTION_DELIMITERS, DEFAULT_DOCUMENTATION_CLASSES, DEFAULT_RECORDING_STATUSES, DEFAULT_WRITING_STATUSES, type DocLine, type DocumentationClass, type EditRecord, type Effect, type EngineSave, type EstimatingConfig, type Expression, type FlowCursor, type FlowFile, type FlowNode, type FlowSnapshot, type GameData, type GameDataField, type GameDataFieldType, type GameDataFields, type GameDataNodeKind, type GameEventBeat, type GrammaticalGender, type Group, type HostScopeDecl, type HostScopeRegistry, type HostScopeSpec, type Jump, type JumpTarget, type LineBeat, type LocaleFile, PROJECT_LOCALE_SCENE, type ProjectDictionary, type ProjectFile, type PromptBeat, type PropertyDecl, type PropertyType, RERECORD_STATUS, RERECORD_STATUS_DECL, type RecordingFolder, type RecordingStatusDecl, SAVE_SCHEMA, SAVE_VERSION, type SaveEnvelope, type SaveGame, type SavedChoice, type SavedChoiceOption, type SavedChoicePrompt, type ScalarValue, type Scene, type Selector, type SelectorExhaust, type SelectorOrder, type SelectorSnapshot, type SequenceOptions, type Snippet, type StackFrame, type Suggestion, type TextBeat, type VcsKind, type WritingStatusDecl, castStringKey, deriveRecordingFolders, effectiveGameId, gameIdify, isContentlessBeat, isValidGameId, walkNodes };

package/dist/index.js

@@ -1,4 +1,10 @@
 // src/index.ts
+import {
+  propertyNameify,
+  isValidPropertyName,
+  isCaseOnlyPropertyName,
+  RESERVED_PROPERTY_NAMES
+} from "@wildwinter/expr";
 function walkNodes(nodes, visit) {
   for (const node of nodes) {
     visit(node);
@@ -19,22 +25,6 @@ function gameIdify(text) {
 function isValidGameId(gameId) {
   return /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/.test(gameId);
 }
-var RESERVED_PROPERTY_NAMES = ["true", "false", "and", "or", "not"];
-function propertyNameify(text) {
-  const trimmed = text.trim();
-  const deliberateLeading = trimmed.startsWith("_");
-  let out = trimmed.toLowerCase().replace(/['\u2019]/g, "").replace(/[^a-z0-9_]+/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
-  if (out === "") return "";
-  if (deliberateLeading || /^[0-9]/.test(out)) out = `_${out}`;
-  if (RESERVED_PROPERTY_NAMES.includes(out)) out = `${out}_`;
-  return out;
-}
-function isValidPropertyName(name) {
-  return /^[a-z_][a-z0-9_]*$/.test(name) && !RESERVED_PROPERTY_NAMES.includes(name);
-}
-function isCaseOnlyPropertyName(name) {
-  return !isValidPropertyName(name) && isValidPropertyName(name.toLowerCase());
-}
 function effectiveGameId(entity) {
   const g = entity.gameId?.trim();
   return g ? g : gameIdify(entity.name);
@@ -85,6 +75,8 @@ function castStringKey(name) {
 }
 var DEFAULT_CAPTION_DELIMITERS = { open: "[", close: "]" };
 var DEFAULT_CAPTION_CHARACTER = "SFX";
+var SAVE_SCHEMA = "patter/save@0";
+var SAVE_VERSION = 2;
 export {
   COMMON_GENDERS,
   DEFAULT_CAPTION_CHARACTER,
@@ -96,6 +88,8 @@ export {
   RERECORD_STATUS,
   RERECORD_STATUS_DECL,
   RESERVED_PROPERTY_NAMES,
+  SAVE_SCHEMA,
+  SAVE_VERSION,
   castStringKey,
   deriveRecordingFolders,
   effectiveGameId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patterkit/model",
-  "version": "0.4.0",
+  "version": "0.5.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",
@@ -34,6 +34,6 @@
     "build": "tsup src/index.ts --format esm,cjs --dts --clean"
   },
   "dependencies": {
-    "@wildwinter/expr": "^0.4.0"
+    "@wildwinter/expr": "^0.5.0"
   }
 }