@almadar/core 10.29.0 → 10.31.0

package/dist/{pattern-types-JZordBZv.d.ts → pattern-types-VDIr2TkX.d.ts}

@@ -1,6 +1,312 @@
 import { z } from 'zod';
 import { S as SExpr } from './expression-CB9R3KWk.js';
 
+/**
+ * Identity model (Almadar Rabit V4, Phase 1 — types only).
+ *
+ * Branded, prefix-tagged node ids + a workspace-scoped name ledger. Ids are
+ * the durable edge keys of the identity-keyed schema graph; the ledger is the
+ * sole name↔id map (names are display labels, one row per rename). This module
+ * is pure: no I/O, no side effects. Minting is the only impurity (clock +
+ * crypto randomness for the ULID suffix).
+ *
+ * @packageDocumentation
+ */
+
+type Branded<K extends string> = string & {
+    readonly __idBrand: K;
+};
+type OrbitalId = Branded<'OrbitalId'>;
+type EntityId = Branded<'EntityId'>;
+type TraitId = Branded<'TraitId'>;
+type EventId = Branded<'EventId'>;
+type PageId = Branded<'PageId'>;
+type ServiceId = Branded<'ServiceId'>;
+type ThemeId = Branded<'ThemeId'>;
+type PaletteEntryId = Branded<'PaletteEntryId'>;
+/** Node kind ↔ id-prefix table. The single source of truth for every prefix. */
+declare const ID_PREFIXES: {
+    readonly orbital: "orb_";
+    readonly entity: "ent_";
+    readonly trait: "trt_";
+    readonly event: "evt_";
+    readonly page: "pag_";
+    readonly service: "svc_";
+    readonly theme: "thm_";
+    readonly palette: "pal_";
+};
+type IdKind = keyof typeof ID_PREFIXES;
+/** Compile-time map from kind to its branded id type. */
+interface IdForKind {
+    orbital: OrbitalId;
+    entity: EntityId;
+    trait: TraitId;
+    event: EventId;
+    page: PageId;
+    service: ServiceId;
+    theme: ThemeId;
+    palette: PaletteEntryId;
+}
+declare const isOrbitalId: (value: string) => value is OrbitalId;
+declare const asOrbitalId: (value: string) => OrbitalId;
+declare const isEntityId: (value: string) => value is EntityId;
+declare const asEntityId: (value: string) => EntityId;
+declare const isTraitId: (value: string) => value is TraitId;
+declare const asTraitId: (value: string) => TraitId;
+declare const isEventId: (value: string) => value is EventId;
+declare const asEventId: (value: string) => EventId;
+declare const isPageId: (value: string) => value is PageId;
+declare const asPageId: (value: string) => PageId;
+declare const isServiceId: (value: string) => value is ServiceId;
+declare const asServiceId: (value: string) => ServiceId;
+declare const isThemeId: (value: string) => value is ThemeId;
+declare const asThemeId: (value: string) => ThemeId;
+declare const isPaletteEntryId: (value: string) => value is PaletteEntryId;
+declare const asPaletteEntryId: (value: string) => PaletteEntryId;
+/**
+ * The id-prefix for a node kind (`'entity' → 'ent_'`). The JS mirror of the
+ * Rust `IdKind::prefix`. Single source of truth is {@link ID_PREFIXES}.
+ */
+declare function idPrefix(kind: IdKind): string;
+/**
+ * The node kind an id's prefix denotes, or `null` for an unrecognized /
+ * bare-prefix string. The JS mirror of the Rust `id_kind_of`. Prefixes are
+ * mutually non-overlapping, so match order is irrelevant.
+ */
+declare function idKindOf(id: string): IdKind | null;
+/** Mint a fresh, opaque, kind-tagged id: `<prefix><ULID>`. */
+declare function mintId<K extends IdKind>(kind: K): IdForKind[K];
+/** Ledger row kind. `palette` entries are manifest ids, not name-ledger rows. */
+type LedgerKind = 'orbital' | 'entity' | 'trait' | 'event' | 'page' | 'service' | 'theme';
+/**
+ * One ledger row: the workspace's name history for a single node id.
+ *
+ * For kind `'event'` the row is minted per-(trait, declared event) per the
+ * Phase-0 freeze — the owning trait is recorded in `parent`; a call-site event
+ * rename is a one-row edit on this same id (the baked-vs-current key namespaces
+ * collapse into `bakedName` vs `curName`).
+ */
+interface LedgerEntry {
+    id: string;
+    kind: LedgerKind;
+    bakedName: string;
+    curName: string;
+    renames: ReadonlyArray<{
+        from: string;
+        to: string;
+        at: string;
+    }>;
+    owner: 'std' | 'io' | 'workspace';
+    /** Owning trait for kind `'event'` (per-trait event-id namespace). */
+    parent?: TraitId;
+}
+interface IdentityLedger {
+    schemaVersion: 1;
+    entries: Record<string, LedgerEntry>;
+}
+/** Resolve a name to its id via exact `curName` match within `kind`, else null. */
+declare function ledgerResolveName(ledger: IdentityLedger, kind: LedgerKind, name: string): string | null;
+/** Immutable rename: returns a new ledger with the id's `curName` + `renames` updated. */
+declare function ledgerRename(ledger: IdentityLedger, id: string, to: string, at: string): IdentityLedger;
+/** Current display name for an id, or null when the id is not in the ledger. */
+declare function ledgerCurName(ledger: IdentityLedger, id: string): string | null;
+/**
+ * Prefix-checked, kind-tagged id schemas. Each narrows a validated string to
+ * its branded id type via the module's own kind guard, so a schema that reads
+ * `TraitIdSchema.optional()` yields `TraitId | undefined` with no cast. The
+ * guard is the single source of prefix truth (`ID_PREFIXES`); the schema is a
+ * thin zod wrapper over it.
+ */
+declare const OrbitalIdSchema: z.ZodEffects<z.ZodString, OrbitalId, string>;
+declare const EntityIdSchema: z.ZodEffects<z.ZodString, EntityId, string>;
+declare const TraitIdSchema: z.ZodEffects<z.ZodString, TraitId, string>;
+declare const EventIdSchema: z.ZodEffects<z.ZodString, EventId, string>;
+declare const PageIdSchema: z.ZodEffects<z.ZodString, PageId, string>;
+declare const ServiceIdSchema: z.ZodEffects<z.ZodString, ServiceId, string>;
+declare const ThemeIdSchema: z.ZodEffects<z.ZodString, ThemeId, string>;
+declare const PaletteEntryIdSchema: z.ZodEffects<z.ZodString, PaletteEntryId, string>;
+declare const LedgerKindSchema: z.ZodEnum<["orbital", "entity", "trait", "event", "page", "service", "theme"]>;
+declare const LedgerEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<["orbital", "entity", "trait", "event", "page", "service", "theme"]>;
+    bakedName: z.ZodString;
+    curName: z.ZodString;
+    renames: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        from: string;
+        to: string;
+    }, {
+        at: string;
+        from: string;
+        to: string;
+    }>, "many">;
+    owner: z.ZodEnum<["std", "io", "workspace"]>;
+    parent: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    kind: "orbital" | "entity" | "trait" | "event" | "page" | "service" | "theme";
+    bakedName: string;
+    curName: string;
+    renames: {
+        at: string;
+        from: string;
+        to: string;
+    }[];
+    owner: "std" | "io" | "workspace";
+    parent?: TraitId | undefined;
+}, {
+    id: string;
+    kind: "orbital" | "entity" | "trait" | "event" | "page" | "service" | "theme";
+    bakedName: string;
+    curName: string;
+    renames: {
+        at: string;
+        from: string;
+        to: string;
+    }[];
+    owner: "std" | "io" | "workspace";
+    parent?: string | undefined;
+}>;
+declare const IdentityLedgerSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    entries: z.ZodRecord<z.ZodString, z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<["orbital", "entity", "trait", "event", "page", "service", "theme"]>;
+        bakedName: z.ZodString;
+        curName: z.ZodString;
+        renames: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            at: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            at: string;
+            from: string;
+            to: string;
+        }, {
+            at: string;
+            from: string;
+            to: string;
+        }>, "many">;
+        owner: z.ZodEnum<["std", "io", "workspace"]>;
+        parent: z.ZodOptional<z.ZodEffects<z.ZodString, TraitId, string>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: "orbital" | "entity" | "trait" | "event" | "page" | "service" | "theme";
+        bakedName: string;
+        curName: string;
+        renames: {
+            at: string;
+            from: string;
+            to: string;
+        }[];
+        owner: "std" | "io" | "workspace";
+        parent?: TraitId | undefined;
+    }, {
+        id: string;
+        kind: "orbital" | "entity" | "trait" | "event" | "page" | "service" | "theme";
+        bakedName: string;
+        curName: string;
+        renames: {
+            at: string;
+            from: string;
+            to: string;
+        }[];
+        owner: "std" | "io" | "workspace";
+        parent?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    entries: Record<string, {
+        id: string;
+        kind: "orbital" | "entity" | "trait" | "event" | "page" | "service" | "theme";
+        bakedName: string;
+        curName: string;
+        renames: {
+            at: string;
+            from: string;
+            to: string;
+        }[];
+        owner: "std" | "io" | "workspace";
+        parent?: TraitId | undefined;
+    }>;
+    schemaVersion: 1;
+}, {
+    entries: Record<string, {
+        id: string;
+        kind: "orbital" | "entity" | "trait" | "event" | "page" | "service" | "theme";
+        bakedName: string;
+        curName: string;
+        renames: {
+            at: string;
+            from: string;
+            to: string;
+        }[];
+        owner: "std" | "io" | "workspace";
+        parent?: string | undefined;
+    }>;
+    schemaVersion: 1;
+}>;
+
+/**
+ * JSON primitives — the universal "data crossed a boundary" type.
+ *
+ * Every value that arrives over the wire from an LLM (tool-call args),
+ * from disk (workspace files), or from an HTTP body before
+ * domain-specific validation is a `JsonValue`. Narrow with a typed
+ * predicate (`is`-guard) at the boundary; don't widen back to `unknown`.
+ *
+ * `JsonObject` and `ToolArgs` are aliases for the common
+ * `Record<string, JsonValue>` shape. `ToolArgs` is the name the
+ * agent surface uses for LLM-emitted tool-call arguments; `JsonObject`
+ * is the general-purpose alias. They are the same type — the alias
+ * exists so call sites read at the right semantic level.
+ *
+ * Why not `Record<string, unknown>`? Two reasons. (1) `unknown` widens
+ * back to anything, which defeats the purpose of typing the boundary.
+ * (2) The `@almadar/eslint-plugin/no-record-string-unknown` rule blocks
+ * the wider form — `JsonValue`-based records are the typed answer.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Recursive JSON value union — every shape JSON can carry.
+ */
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * JSON object — keyed string→JsonValue. The wire form of arbitrary
+ * structured data. Replaces `Record<string, unknown>` at typed
+ * boundaries (LLM emits, file reads, HTTP bodies).
+ */
+type JsonObject = {
+    [key: string]: JsonValue;
+};
+/**
+ * LLM tool-call arguments — same shape as `JsonObject`, named for the
+ * agent-surface call site. Each tool's `execute(args: ToolArgs)`
+ * receives this and narrows via an `is`-guard predicate before any
+ * field access.
+ */
+type ToolArgs = JsonObject;
+/**
+ * Type guard: is the given value a JSON primitive (non-array,
+ * non-object)? Used by walkers that decide whether to recurse.
+ */
+declare function isJsonPrimitive(value: JsonValue): value is string | number | boolean | null;
+/**
+ * Type guard: is the given value a JSON object (non-array, non-null)?
+ */
+declare function isJsonObject(value: JsonValue): value is JsonObject;
+/**
+ * Type guard: is the given value a JSON array?
+ */
+declare function isJsonArray(value: JsonValue): value is JsonValue[];
+
 /**
  * Field Types for Orbital Units
  *
@@ -28,9 +334,11 @@ type RelationCardinality = 'one' | 'many' | 'one-to-many' | 'many-to-one' | 'man
  * Configuration for relation fields (foreign keys).
  * Matches Rust compiler's RelationDefinition format.
  */
-interface RelationConfig {
+type RelationConfig = {
     /** Target entity name (e.g., 'User', 'Task') - matches Rust's `entity` field */
     entity: string;
+    /** V4 dual-carry id sibling of `entity` — optional until the Phase-7 flip. */
+    entityId?: EntityId;
     /** Field on target entity (defaults to 'id') */
     field?: string;
     /**
@@ -55,9 +363,10 @@ interface RelationConfig {
      * @deprecated Use cardinality instead
      */
     type?: RelationCardinality;
-}
+};
 declare const RelationConfigSchema: z.ZodEffects<z.ZodObject<{
     entity: z.ZodString;
+    entityId: z.ZodOptional<z.ZodEffects<z.ZodString, EntityId, string>>;
     field: z.ZodOptional<z.ZodString>;
     cardinality: z.ZodOptional<z.ZodEnum<["one", "many", "one-to-many", "many-to-one", "many-to-many"]>>;
     onDelete: z.ZodOptional<z.ZodEnum<["cascade", "nullify", "restrict"]>>;
@@ -66,28 +375,31 @@ declare const RelationConfigSchema: z.ZodEffects<z.ZodObject<{
     type: z.ZodOptional<z.ZodEnum<["one", "many", "one-to-many", "many-to-one", "many-to-many"]>>;
 }, "strip", z.ZodTypeAny, {
     entity: string;
+    type?: "many" | "one" | "one-to-many" | "many-to-one" | "many-to-many" | undefined;
+    entityId?: EntityId | undefined;
     field?: string | undefined;
-    cardinality?: "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many" | undefined;
+    cardinality?: "many" | "one" | "one-to-many" | "many-to-one" | "many-to-many" | undefined;
     onDelete?: "cascade" | "nullify" | "restrict" | undefined;
     foreignKey?: string | undefined;
     target?: string | undefined;
-    type?: "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many" | undefined;
 }, {
     entity: string;
+    type?: "many" | "one" | "one-to-many" | "many-to-one" | "many-to-many" | undefined;
+    entityId?: string | undefined;
     field?: string | undefined;
-    cardinality?: "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many" | undefined;
+    cardinality?: "many" | "one" | "one-to-many" | "many-to-one" | "many-to-many" | undefined;
     onDelete?: "cascade" | "nullify" | "restrict" | undefined;
     foreignKey?: string | undefined;
     target?: string | undefined;
-    type?: "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many" | undefined;
 }>, RelationConfig, {
     entity: string;
+    type?: "many" | "one" | "one-to-many" | "many-to-one" | "many-to-many" | undefined;
+    entityId?: string | undefined;
     field?: string | undefined;
-    cardinality?: "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many" | undefined;
+    cardinality?: "many" | "one" | "one-to-many" | "many-to-one" | "many-to-many" | undefined;
     onDelete?: "cascade" | "nullify" | "restrict" | undefined;
     foreignKey?: string | undefined;
     target?: string | undefined;
-    type?: "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many" | undefined;
 }>;
 /**
  * Field format validators for string fields.
@@ -108,7 +420,7 @@ declare const FieldFormatSchema: z.ZodEnum<["email", "url", "phone", "date", "da
  */
 type ScalarFieldType = 'string' | 'number' | 'boolean' | 'date' | 'timestamp' | 'datetime' | 'trait' | 'slot' | 'pattern';
 /** Fields shared across every variant. */
-interface EntityFieldBase {
+type EntityFieldBase = {
     /**
      * Field name (camelCase). Optional for nested item/property descriptors
      * where the name is implied by the parent (`items`, `properties[k]`).
@@ -117,8 +429,8 @@ interface EntityFieldBase {
     name?: string;
     /** Whether the field is required */
     required?: boolean;
-    /** Default value */
-    default?: unknown;
+    /** Default value — parsed from `.orb`, always JSON-shaped. */
+    default?: JsonValue;
     /** Validation format */
     format?: FieldFormat;
     /** Minimum value (for number) or length (for string) */
@@ -141,51 +453,51 @@ interface EntityFieldBase {
     /** User-vocabulary synonyms (authored `@synonyms "..."` in `.lolo`).
      *  Free text feeding catalog search / curation field-matching. */
     synonyms?: string;
-}
+};
 /**
  * Scalar / structural fields — no type-dependent payload required.
  * `values?` is permitted as an OPTIONAL UI/validation hint (e.g. lolo's
  * `'a' | 'b' | 'c'` string-union sugar lowers to `type: 'string', values:
  * [...]`). Only `EnumEntityField` MANDATES values.
  */
-interface ScalarEntityField extends EntityFieldBase {
+type ScalarEntityField = EntityFieldBase & {
     type: ScalarFieldType;
     /** Optional vocabulary hint for scalar fields (e.g. string unions
      *  authored as `'a'|'b'|'c'` in lolo). Not required at this variant. */
     values?: string[];
-}
+};
 /** `type: 'enum'` REQUIRES the closed vocabulary in `values`. */
-interface EnumEntityField extends EntityFieldBase {
+type EnumEntityField = EntityFieldBase & {
     type: 'enum';
     /** Closed string vocabulary the field accepts. */
     values: string[];
-}
+};
 /** `type: 'relation'` REQUIRES the relation target binding. */
-interface RelationEntityField extends EntityFieldBase {
+type RelationEntityField = EntityFieldBase & {
     type: 'relation';
     /** Relation target binding (entity + cardinality). */
     relation: RelationConfig;
-}
+};
 /** `type: 'array'` — element schema in `items` strongly preferred but
  *  optional for legacy compatibility with codegen-emitted scalar-array
  *  fields (e.g. `{type: 'array', default: []}`). The lolo lowerer + Rust
  *  validator catch typed-element-required cases downstream. */
-interface ArrayEntityField extends EntityFieldBase {
+type ArrayEntityField = EntityFieldBase & {
     type: 'array';
     /** Element schema for the array. */
     items?: EntityField;
-}
+};
 /**
  * `type: 'object'` — a fixed-key struct (fields in `properties`) OR a
  * dynamic-key map (`Map K V` in `.lolo`; the uniform value schema lives in
  * `items`, mirroring an array's element schema). A distinct variant so `items`
  * is statically allowed only on object/array fields, never on scalars.
  */
-interface ObjectEntityField extends EntityFieldBase {
+type ObjectEntityField = EntityFieldBase & {
     type: 'object';
     /** Uniform value schema for a dynamic-key map (`Map K V`). */
     items?: EntityField;
-}
+};
 /**
  * Entity field definition — discriminated union by `type`. Each variant
  * statically enforces its dependent payload (`values` for enum,
@@ -552,7 +864,7 @@ declare const TilesheetSchema: z.ZodObject<{
  * Semantic reference to an asset (not a hardcoded path).
  * Resolved to actual paths at compile time via asset maps.
  */
-interface SemanticAssetRef {
+type SemanticAssetRef = {
     /**
      * Entity role — a free string. Core no longer constrains the vocabulary to
      * `EntityRole` (that enum stays an exported shared reference for the asset
@@ -571,7 +883,7 @@ interface SemanticAssetRef {
     dimension?: AssetDimension;
     /** Rendering aspect ratio (square sprite/portrait/tile, 16:9 backdrop, 5:7 card, 8:1 fx-strip). */
     aspect?: AssetAspect;
-}
+};
 declare const SemanticAssetRefSchema: z.ZodObject<{
     role: z.ZodString;
     category: z.ZodString;
@@ -697,18 +1009,18 @@ declare const AssetCatalogEntrySchema: z.ZodObject<{
     dimension: z.ZodOptional<z.ZodEnum<["2d", "3d"]>>;
     aspect: z.ZodOptional<z.ZodEnum<["1:1", "16:9", "5:7", "8:1"]>>;
 }, "strip", z.ZodTypeAny, {
+    kind: "image" | "spritesheet" | "audio" | "scene" | "portrait" | "model" | "other";
     url: string;
     name: string;
     category: string;
-    kind: "image" | "spritesheet" | "audio" | "scene" | "portrait" | "model" | "other";
     dimension?: "2d" | "3d" | undefined;
     aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
     thumbnailUrl?: string | undefined;
 }, {
+    kind: "image" | "spritesheet" | "audio" | "scene" | "portrait" | "model" | "other";
     url: string;
     name: string;
     category: string;
-    kind: "image" | "spritesheet" | "audio" | "scene" | "portrait" | "model" | "other";
     dimension?: "2d" | "3d" | undefined;
     aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
     thumbnailUrl?: string | undefined;
@@ -726,18 +1038,18 @@ declare const AssetCatalogSchema: z.ZodArray<z.ZodObject<{
     dimension: z.ZodOptional<z.ZodEnum<["2d", "3d"]>>;
     aspect: z.ZodOptional<z.ZodEnum<["1:1", "16:9", "5:7", "8:1"]>>;
 }, "strip", z.ZodTypeAny, {
+    kind: "image" | "spritesheet" | "audio" | "scene" | "portrait" | "model" | "other";
     url: string;
     name: string;
     category: string;
-    kind: "image" | "spritesheet" | "audio" | "scene" | "portrait" | "model" | "other";
     dimension?: "2d" | "3d" | undefined;
     aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
     thumbnailUrl?: string | undefined;
 }, {
+    kind: "image" | "spritesheet" | "audio" | "scene" | "portrait" | "model" | "other";
     url: string;
     name: string;
     category: string;
-    kind: "image" | "spritesheet" | "audio" | "scene" | "portrait" | "model" | "other";
     dimension?: "2d" | "3d" | undefined;
     aspect?: "1:1" | "16:9" | "5:7" | "8:1" | undefined;
     thumbnailUrl?: string | undefined;
@@ -952,7 +1264,9 @@ declare const EntityPersistenceSchema: z.ZodEnum<["persistent", "runtime"]>;
  * This is a simplified entity definition optimized for orbital composition.
  * Collection names are derived automatically from persistence type if not provided.
  */
-interface OrbitalEntity {
+type OrbitalEntity = {
+    /** V4 dual-carry id sibling of `name` — optional until the Phase-7 flip. */
+    id?: EntityId;
     /** Entity name (PascalCase, e.g., "Task", "User") */
     name: string;
     /** Entity persistence type (defaults to 'persistent' if not specified) */
@@ -975,7 +1289,7 @@ interface OrbitalEntity {
     visual_prompt?: string;
     /** Semantic asset reference for visual representation (games) */
     assetRef?: SemanticAssetRef;
-}
+};
 declare const OrbitalEntitySchema: z.ZodObject<{
     name: z.ZodString;
     persistence: z.ZodDefault<z.ZodEnum<["persistent", "runtime"]>>;
@@ -1249,8 +1563,8 @@ type EntityData = Record<string, EntityRow[]>;
  *
  * DO NOT EDIT MANUALLY — regenerated by almadar-pattern-sync `patterns` command.
  *
- * Generated: 2026-07-13T15:27:57.844Z
- * Pattern count: 261
+ * Generated: 2026-07-21T09:54:57.817Z
+ * Pattern count: 263
  */
 
 /**
@@ -1262,7 +1576,7 @@ type PatternPropValue = Record<string, FieldValue | undefined>;
  * All valid pattern type names from @almadar/core/patterns registry.
  * Use this type in render-ui effects for compile-time validation.
  */
-type PatternType = 'about-page-template' | 'accordion' | 'action-palette' | 'action-tile' | 'activation-block' | 'alert' | 'algorithm-canvas' | 'animated-counter' | 'animated-graphic' | 'animated-reveal' | 'article-section' | 'aside' | 'atlas-image' | 'atlas-panel' | 'auth-layout' | 'avatar' | 'badge' | 'behavior-view' | 'biology-canvas' | 'bloom-quiz-block' | 'book-chapter-view' | 'book-cover-page' | 'book-nav-bar' | 'book-table-of-contents' | 'book-viewer' | 'box' | 'branching-logic-builder' | 'breadcrumb' | 'button' | 'calendar-grid' | 'canvas' | 'canvas-2d' | 'card' | 'carousel' | 'case-study-card' | 'case-study-organism' | 'center' | 'chart' | 'chart-legend' | 'chat-bar' | 'checkbox' | 'chemistry-canvas' | 'choice-button' | 'code-block' | 'code-runner-panel' | 'community-links' | 'conditional-wrapper' | 'confetti-effect' | 'confirm-dialog' | 'connection-block' | 'container' | 'content-renderer' | 'content-section' | 'control-button' | 'control-grid' | 'counter-template' | 'cta-banner' | 'dashboard-grid' | 'dashboard-layout' | 'data-grid' | 'data-list' | 'date-range-picker' | 'date-range-selector' | 'day-cell' | 'detail-panel' | 'dialog' | 'dialogue-bubble' | 'divider' | 'doc-breadcrumb' | 'doc-pagination' | 'doc-search' | 'doc-sidebar' | 'doc-toc' | 'document-viewer' | 'draw-shape' | 'draw-shape-layer' | 'draw-sprite' | 'draw-sprite-layer' | 'draw-text' | 'draw-text-layer' | 'drawer' | 'drawer-slot' | 'edge-decoration' | 'empty-state' | 'entity-cards' | 'entity-list' | 'entity-table' | 'error-boundary' | 'error-state' | 'feature-card' | 'feature-detail-page-template' | 'feature-grid' | 'feature-grid-organism' | 'file-tree' | 'filter-group' | 'filter-pill' | 'flex' | 'flip-card' | 'flip-container' | 'floating-action-button' | 'form' | 'form-actions' | 'form-field' | 'form-layout' | 'form-section' | 'form-section-header' | 'game-audio-toggle' | 'game-hud' | 'game-icon' | 'game-menu' | 'game-shell' | 'generic-app-template' | 'geometric-pattern' | 'gradient-divider' | 'graph-canvas' | 'graph-view' | 'grid' | 'header' | 'health-bar' | 'hero-organism' | 'hero-section' | 'hstack' | 'icon' | 'infinite-scroll-sentinel' | 'input' | 'input-group' | 'install-box' | 'jazari-state-machine' | 'label' | 'landing-page-template' | 'law-reference-tooltip' | 'learning-canvas' | 'lightbox' | 'likert-scale' | 'line-chart' | 'loading-state' | 'map-view' | 'markdown-content' | 'marketing-footer' | 'marketing-stat-card' | 'master-detail' | 'master-detail-layout' | 'math-canvas' | 'matrix-question' | 'media-gallery' | 'menu' | 'meter' | 'modal' | 'modal-slot' | 'module-card' | 'navigation' | 'notification' | 'number-stepper' | 'option-constraint-group' | 'orbital-visualization' | 'overlay' | 'page-header' | 'pagination' | 'pattern-tile' | 'physics-canvas' | 'popover' | 'positioned-canvas' | 'pricing-card' | 'pricing-grid' | 'pricing-organism' | 'pricing-page-template' | 'progress-bar' | 'progress-dots' | 'pull-quote' | 'pull-to-refresh' | 'qr-scanner' | 'quiz-block' | 'radio' | 'range-slider' | 'reflection-block' | 'relation-select' | 'repeatable-form-section' | 'reply-tree' | 'rich-block-editor' | 'runtime-debugger' | 'scaled-diagram' | 'score-display' | 'search-input' | 'section' | 'section-header' | 'segment-renderer' | 'select' | 'sequence-bar' | 'service-catalog' | 'showcase-card' | 'showcase-organism' | 'side-panel' | 'sidebar' | 'signature-pad' | 'simple-grid' | 'skeleton' | 'social-proof' | 'sortable-list' | 'spacer' | 'sparkline' | 'spinner' | 'split' | 'split-pane' | 'split-section' | 'stack' | 'star-rating' | 'stat-badge' | 'stat-card' | 'stat-display' | 'state-graph' | 'state-json-view' | 'state-machine-view' | 'stats-grid' | 'stats-organism' | 'status-dot' | 'step-flow' | 'step-flow-organism' | 'subagent-trace-panel' | 'svg-branch' | 'svg-connection' | 'svg-flow' | 'svg-grid' | 'svg-lobe' | 'svg-mesh' | 'svg-morph' | 'svg-node' | 'svg-pulse' | 'svg-ring' | 'svg-shield' | 'svg-stack' | 'swipeable-row' | 'switch' | 'tabbed-container' | 'table-view' | 'tabs' | 'tag-cloud' | 'tag-input' | 'team-card' | 'team-organism' | 'text-highlight' | 'textarea' | 'theme-toggle' | 'time-slot-cell' | 'timeline' | 'timer-display' | 'toast-slot' | 'tooltip' | 'trait-frame' | 'trait-slot' | 'trend-indicator' | 'typewriter-text' | 'typography' | 'ui-slot-renderer' | 'upload-drop-zone' | 'version-diff' | 'violation-alert' | 'vote-stack' | 'vstack' | 'wizard-container' | 'wizard-navigation' | 'wizard-progress';
+type PatternType = 'about-page-template' | 'accordion' | 'action-palette' | 'action-tile' | 'activation-block' | 'alert' | 'algorithm-canvas' | 'animated-counter' | 'animated-graphic' | 'animated-reveal' | 'article-section' | 'aside' | 'atlas-image' | 'atlas-panel' | 'auth-layout' | 'avatar' | 'badge' | 'behavior-view' | 'biology-canvas' | 'bloom-quiz-block' | 'book-chapter-view' | 'book-cover-page' | 'book-nav-bar' | 'book-table-of-contents' | 'book-viewer' | 'box' | 'branching-logic-builder' | 'breadcrumb' | 'button' | 'calendar-grid' | 'canvas' | 'canvas-2d' | 'card' | 'carousel' | 'case-study-card' | 'case-study-organism' | 'center' | 'chart' | 'chart-legend' | 'chat-bar' | 'checkbox' | 'chemistry-canvas' | 'choice-button' | 'code-block' | 'code-runner-panel' | 'community-links' | 'conditional-wrapper' | 'confetti-effect' | 'confirm-dialog' | 'connection-block' | 'container' | 'content-renderer' | 'content-section' | 'control-button' | 'control-grid' | 'counter-template' | 'cta-banner' | 'dashboard-grid' | 'dashboard-layout' | 'data-grid' | 'data-list' | 'date-range-picker' | 'date-range-selector' | 'day-cell' | 'detail-panel' | 'dialog' | 'dialogue-bubble' | 'divider' | 'doc-breadcrumb' | 'doc-pagination' | 'doc-search' | 'doc-sidebar' | 'doc-toc' | 'document-viewer' | 'draw-shape' | 'draw-shape-layer' | 'draw-sprite' | 'draw-sprite-layer' | 'draw-text' | 'draw-text-layer' | 'drawer' | 'drawer-slot' | 'edge-decoration' | 'empty-state' | 'entity-cards' | 'entity-list' | 'entity-table' | 'error-boundary' | 'error-state' | 'feature-card' | 'feature-detail-page-template' | 'feature-grid' | 'feature-grid-organism' | 'file-tree' | 'filter-group' | 'filter-pill' | 'flex' | 'flip-card' | 'flip-container' | 'floating-action-button' | 'form' | 'form-actions' | 'form-field' | 'form-layout' | 'form-section' | 'form-section-header' | 'game-audio-toggle' | 'game-hud' | 'game-icon' | 'game-menu' | 'game-shell' | 'generic-app-template' | 'geometric-pattern' | 'gradient-divider' | 'graph-canvas' | 'graph-view' | 'grid' | 'header' | 'health-bar' | 'hero-organism' | 'hero-section' | 'hstack' | 'icon' | 'infinite-scroll-sentinel' | 'input' | 'input-group' | 'install-box' | 'jazari-state-machine' | 'label' | 'landing-page-template' | 'law-reference-tooltip' | 'learning-canvas' | 'lightbox' | 'likert-scale' | 'line-chart' | 'loading-state' | 'map-view' | 'markdown-content' | 'marketing-footer' | 'marketing-stat-card' | 'master-detail' | 'master-detail-layout' | 'math-canvas' | 'matrix-question' | 'media-gallery' | 'menu' | 'meter' | 'modal' | 'modal-slot' | 'module-card' | 'navigation' | 'notification' | 'number-stepper' | 'option-constraint-group' | 'orbital-visualization' | 'overlay' | 'page-header' | 'page-transition' | 'pagination' | 'pattern-tile' | 'physics-canvas' | 'popover' | 'positioned-canvas' | 'presence' | 'pricing-card' | 'pricing-grid' | 'pricing-organism' | 'pricing-page-template' | 'progress-bar' | 'progress-dots' | 'pull-quote' | 'pull-to-refresh' | 'qr-scanner' | 'quiz-block' | 'radio' | 'range-slider' | 'reflection-block' | 'relation-select' | 'repeatable-form-section' | 'reply-tree' | 'rich-block-editor' | 'runtime-debugger' | 'scaled-diagram' | 'score-display' | 'search-input' | 'section' | 'section-header' | 'segment-renderer' | 'select' | 'sequence-bar' | 'service-catalog' | 'showcase-card' | 'showcase-organism' | 'side-panel' | 'sidebar' | 'signature-pad' | 'simple-grid' | 'skeleton' | 'social-proof' | 'sortable-list' | 'spacer' | 'sparkline' | 'spinner' | 'split' | 'split-pane' | 'split-section' | 'stack' | 'star-rating' | 'stat-badge' | 'stat-card' | 'stat-display' | 'state-graph' | 'state-json-view' | 'state-machine-view' | 'stats-grid' | 'stats-organism' | 'status-dot' | 'step-flow' | 'step-flow-organism' | 'subagent-trace-panel' | 'svg-branch' | 'svg-connection' | 'svg-flow' | 'svg-grid' | 'svg-lobe' | 'svg-mesh' | 'svg-morph' | 'svg-node' | 'svg-pulse' | 'svg-ring' | 'svg-shield' | 'svg-stack' | 'swipeable-row' | 'switch' | 'tabbed-container' | 'table-view' | 'tabs' | 'tag-cloud' | 'tag-input' | 'team-card' | 'team-organism' | 'text-highlight' | 'textarea' | 'theme-toggle' | 'time-slot-cell' | 'timeline' | 'timer-display' | 'toast-slot' | 'tooltip' | 'trait-frame' | 'trait-slot' | 'trend-indicator' | 'typewriter-text' | 'typography' | 'ui-slot-renderer' | 'upload-drop-zone' | 'version-diff' | 'violation-alert' | 'vote-stack' | 'vstack' | 'wizard-container' | 'wizard-navigation' | 'wizard-progress';
 /**
  * Pattern props map — each pattern type maps to its valid props interface.
  */
@@ -1354,6 +1668,7 @@ interface PatternPropsMap {
         duration?: number | string | SExpr;
         prefix?: string | SExpr;
         suffix?: string | SExpr;
+        format?: string | SExpr;
         className?: string | SExpr;
     };
     'animated-graphic': {
@@ -2330,7 +2645,6 @@ interface PatternPropsMap {
     };
     'entity-cards': {
         type: 'entity-cards';
-        entity?: PatternPropValue | unknown[] | string | SExpr;
         className?: string | SExpr;
         isLoading?: boolean | string | SExpr;
         error?: PatternPropValue | string | SExpr;
@@ -2342,6 +2656,7 @@ interface PatternPropsMap {
         totalCount?: number | string | SExpr;
         activeFilters?: PatternPropValue | string | SExpr;
         selectedIds?: unknown[] | string | SExpr;
+        entity?: PatternPropValue | unknown[] | string | SExpr;
         minCardWidth?: number | string | SExpr;
         maxCols?: number | string | SExpr;
         gap?: string | SExpr;
@@ -2579,20 +2894,15 @@ interface PatternPropsMap {
     };
     'form-actions': {
         type: 'form-actions';
+        children?: unknown | string | SExpr;
+        primary?: PatternPropValue | string | SExpr;
+        secondary?: unknown[] | string | SExpr;
+        variant?: string | SExpr;
+        orientation?: string | SExpr;
         className?: string | SExpr;
-        isLoading?: boolean | string | SExpr;
-        error?: PatternPropValue | string | SExpr;
-        sortBy?: string | SExpr;
-        sortDirection?: string | SExpr;
-        searchValue?: string | SExpr;
-        page?: number | string | SExpr;
-        pageSize?: number | string | SExpr;
-        totalCount?: number | string | SExpr;
-        activeFilters?: PatternPropValue | string | SExpr;
-        selectedIds?: unknown[] | string | SExpr;
-        children: unknown | string | SExpr;
-        sticky?: boolean | string | SExpr;
-        align?: string | SExpr;
+        entity?: string | SExpr;
+        filters?: unknown[] | string | SExpr;
+        look?: string | SExpr;
     };
     'form-field': {
         type: 'form-field';
@@ -2715,6 +3025,7 @@ interface PatternPropsMap {
         backgroundAsset?: PatternPropValue | string | SExpr;
         hudBackgroundAsset?: PatternPropValue | string | SExpr;
         fontFamily?: string | SExpr;
+        'data-theme'?: string | SExpr;
     };
     'generic-app-template': {
         type: 'generic-app-template';
@@ -2747,6 +3058,7 @@ interface PatternPropsMap {
         title?: string | SExpr;
         nodes?: unknown[] | string | SExpr;
         edges?: unknown[] | string | SExpr;
+        similarity?: unknown[] | string | SExpr;
         height?: number | string | SExpr;
         showLabels?: boolean | string | SExpr;
         interactive?: boolean | string | SExpr;
@@ -2754,6 +3066,7 @@ interface PatternPropsMap {
         actions?: unknown[] | string | SExpr;
         onNodeClick?: ((...args: unknown[]) => unknown) | string | SExpr;
         onNodeDoubleClick?: ((...args: unknown[]) => unknown) | string | SExpr;
+        onBadgeClick?: ((...args: unknown[]) => unknown) | string | SExpr;
         nodeClickEvent?: string | SExpr;
         selectedNodeId?: string | SExpr;
         repulsion?: number | string | SExpr;
@@ -3037,6 +3350,7 @@ interface PatternPropsMap {
         title?: string | SExpr;
         message?: string | SExpr;
         className?: string | SExpr;
+        fullPage?: boolean | string | SExpr;
     };
     'map-view': {
         type: 'map-view';
@@ -3192,6 +3506,7 @@ interface PatternPropsMap {
         type: 'modal';
         isOpen?: boolean | string | SExpr;
         onClose?: ((...args: unknown[]) => unknown) | string | SExpr;
+        onExited?: ((...args: unknown[]) => unknown) | string | SExpr;
         title?: string | SExpr;
         children?: unknown | string | SExpr;
         footer?: unknown | string | SExpr;
@@ -3306,6 +3621,12 @@ interface PatternPropsMap {
         children?: unknown | string | SExpr;
         className?: string | SExpr;
     };
+    'page-transition': {
+        type: 'page-transition';
+        locationKey: string | SExpr;
+        children: unknown | string | SExpr;
+        className?: string | SExpr;
+    };
     'pagination': {
         type: 'pagination';
         currentPage: number | string | SExpr;
@@ -3373,6 +3694,12 @@ interface PatternPropsMap {
         moveEvent?: string | SExpr;
         className?: string | SExpr;
     };
+    'presence': {
+        type: 'presence';
+        show: boolean | string | SExpr;
+        className?: string | SExpr;
+        children: unknown | string | SExpr;
+    };
     'pricing-card': {
         type: 'pricing-card';
         name: string | SExpr;
@@ -4632,4 +4959,4 @@ declare const PATTERN_TYPES: PatternType[];
  */
 declare function isValidPatternType(type: string): type is PatternType;
 
-export { type PatternConfig as $, type AnyPatternConfig as A, CameraModeSchema as B, CAMERA_MODES as C, CameraSchema as D, type EntityField as E, type FieldValue as F, ENTITY_ROLES as G, type EntityData as H, type EntityFieldInput as I, EntityFieldSchema as J, EntityPersistenceSchema as K, type EntityRole as L, EntityRoleSchema as M, EntitySchema as N, type EntityWith as O, type EnumEntityField as P, type Field as Q, type RelationConfig as R, type FieldFormat as S, FieldFormatSchema as T, FieldSchema as U, type FieldType as V, FieldTypeSchema as W, type OrbitalEntity as X, type OrbitalEntityInput as Y, OrbitalEntitySchema as Z, PATTERN_TYPES as _, type EntityPersistence as a, type PatternProps as a0, type PatternPropsMap as a1, type PatternType as a2, RelationConfigSchema as a3, type RelationEntityField as a4, SPRITE_DIRECTIONS as a5, type ScalarEntityField as a6, type ScenePos as a7, ScenePosSchema as a8, type SemanticAssetRef as a9, type SemanticAssetRefInput as aa, SemanticAssetRefSchema as ab, type SpriteDirection as ac, SpriteDirectionSchema as ad, type SpriteSheetAtlas as ae, type SpriteSheetAtlasInput as af, SpriteSheetAtlasSchema as ag, type SubTexture as ah, SubTextureSchema as ai, type TextureAtlas as aj, TextureAtlasSchema as ak, type Tilesheet as al, TilesheetSchema as am, VISUAL_STYLES as an, type VisualStyle as ao, VisualStyleSchema as ap, createAssetKey as aq, deriveCollection as ar, getDefaultAnimationsForRole as as, isFieldValue as at, isRuntimeEntity as au, isValidPatternType as av, parseAssetKey as aw, persistenceModeAllowsOverrides as ax, validateAssetAnimations as ay, type EntityRow as b, type Entity as c, ANIMATION_NAMES as d, ASSET_ASPECTS as e, ASSET_DIMENSIONS as f, type AnimationDef as g, type AnimationDefInput as h, AnimationDefSchema as i, type AnimationName as j, AnimationNameSchema as k, type ArrayEntityField as l, type Asset as m, type AssetAspect as n, AssetAspectSchema as o, type AssetCatalog as p, type AssetCatalogEntry as q, type AssetCatalogEntryInput as r, AssetCatalogEntrySchema as s, AssetCatalogSchema as t, type AssetDimension as u, AssetDimensionSchema as v, AssetSchema as w, type AssetUrl as x, type Camera as y, type CameraMode as z };
+export { type FieldFormat as $, type AnyPatternConfig as A, type AssetUrl as B, CAMERA_MODES as C, type Camera as D, type EntityField as E, type FieldValue as F, type CameraMode as G, CameraModeSchema as H, CameraSchema as I, type JsonValue as J, ENTITY_ROLES as K, type EntityData as L, type EntityFieldInput as M, EntityFieldSchema as N, type OrbitalId as O, type PageId as P, EntityIdSchema as Q, type RelationConfig as R, EntityPersistenceSchema as S, type TraitId as T, type EntityRole as U, EntityRoleSchema as V, EntitySchema as W, type EntityWith as X, type EnumEntityField as Y, EventIdSchema as Z, type Field as _, type EntityPersistence as a, getDefaultAnimationsForRole as a$, FieldFormatSchema as a0, FieldSchema as a1, type FieldType as a2, FieldTypeSchema as a3, type IdForKind as a4, type IdKind as a5, type IdentityLedger as a6, IdentityLedgerSchema as a7, type JsonObject as a8, type LedgerEntry as a9, type SpriteDirection as aA, SpriteDirectionSchema as aB, type SpriteSheetAtlas as aC, type SpriteSheetAtlasInput as aD, SpriteSheetAtlasSchema as aE, type SubTexture as aF, SubTextureSchema as aG, type TextureAtlas as aH, TextureAtlasSchema as aI, type ThemeId as aJ, ThemeIdSchema as aK, type Tilesheet as aL, TilesheetSchema as aM, TraitIdSchema as aN, VISUAL_STYLES as aO, type VisualStyle as aP, VisualStyleSchema as aQ, asEntityId as aR, asEventId as aS, asOrbitalId as aT, asPageId as aU, asPaletteEntryId as aV, asServiceId as aW, asThemeId as aX, asTraitId as aY, createAssetKey as aZ, deriveCollection as a_, LedgerEntrySchema as aa, type LedgerKind as ab, LedgerKindSchema as ac, type OrbitalEntity as ad, type OrbitalEntityInput as ae, OrbitalEntitySchema as af, OrbitalIdSchema as ag, PATTERN_TYPES as ah, PageIdSchema as ai, type PaletteEntryId as aj, PaletteEntryIdSchema as ak, type PatternConfig as al, type PatternProps as am, type PatternPropsMap as an, type PatternType as ao, RelationConfigSchema as ap, type RelationEntityField as aq, SPRITE_DIRECTIONS as ar, type ScalarEntityField as as, type ScenePos as at, ScenePosSchema as au, type SemanticAssetRef as av, type SemanticAssetRefInput as aw, SemanticAssetRefSchema as ax, type ServiceId as ay, ServiceIdSchema as az, type EntityRow as b, idKindOf as b0, idPrefix as b1, isEntityId as b2, isEventId as b3, isFieldValue as b4, isJsonArray as b5, isJsonObject as b6, isJsonPrimitive as b7, isOrbitalId as b8, isPageId as b9, isPaletteEntryId as ba, isRuntimeEntity as bb, isServiceId as bc, isThemeId as bd, isTraitId as be, isValidPatternType as bf, ledgerCurName as bg, ledgerRename as bh, ledgerResolveName as bi, mintId as bj, parseAssetKey as bk, persistenceModeAllowsOverrides as bl, validateAssetAnimations as bm, type EventId as c, type EntityId as d, type Entity as e, type ToolArgs as f, ANIMATION_NAMES as g, ASSET_ASPECTS as h, ASSET_DIMENSIONS as i, type AnimationDef as j, type AnimationDefInput as k, AnimationDefSchema as l, type AnimationName as m, AnimationNameSchema as n, type ArrayEntityField as o, type Asset as p, type AssetAspect as q, AssetAspectSchema as r, type AssetCatalog as s, type AssetCatalogEntry as t, type AssetCatalogEntryInput as u, AssetCatalogEntrySchema as v, AssetCatalogSchema as w, type AssetDimension as x, AssetDimensionSchema as y, AssetSchema as z };