@almadar/core 10.56.0 → 10.58.0

package/dist/{effect-DxD-XTI8.d.ts → effect-BH2k4oK6.d.ts}

@@ -1117,6 +1117,9 @@ type EntityFieldBase = {
     name?: string;
     /** Whether the field is required */
     required?: boolean;
+    /** Primary-key marker. Mirrors Rust's `FieldDefinition.primary_key`
+     *  (serde `primaryKey`). */
+    primaryKey?: boolean;
     /** Default value — parsed from `.orb`, always JSON-shaped. */
     default?: JsonValue;
     /** Minimum value (for number) or length (for string) */
@@ -2427,7 +2430,7 @@ type EntityData = Record<string, EntityRow[]>;
  *
  * DO NOT EDIT MANUALLY — regenerated by almadar-pattern-sync `patterns` command.
  *
- * Generated: 2026-08-05T01:21:57.577Z
+ * Generated: 2026-08-16T04:34:48.543Z
  * Pattern count: 269
  */
 
@@ -4035,6 +4038,7 @@ interface PatternPropsMap {
         className?: string | SExpr;
         showLabels?: boolean | string | SExpr;
         zoomToFit?: boolean | string | SExpr;
+        layout?: string | SExpr;
     };
     'grid': {
         type: 'grid';
@@ -5977,12 +5981,35 @@ type CallServiceConfig = {
  * lets the TS effect type express it.
  */
 type RenderBinding = `@${string}`;
+/**
+ * A binding reference resolving to a {@link UISlot} at inline time — a trait
+ * `config` knob holding the slot name, e.g. `"@config.reviewSlot"`. Mirrors
+ * {@link RenderBinding} for the SLOT position: the compiler's inline phase
+ * substitutes the config value before anything renders, and the Rust
+ * validator accepts the pre-substitution form (worked example:
+ * `std-approval-gate`'s review queue renders into `@config.reviewSlot`).
+ * This variant lets the TS effect type express the template-layer form.
+ */
+type SlotBinding = `@config.${string}`;
+/**
+ * Template-layer pattern node: a render tree whose discriminant and/or props
+ * are still bindings (`type: '@config.viewPattern'`, `title: '@config.title'`)
+ * or loose nested descriptors the compiler's inline phase resolves. The
+ * resolved layer is {@link AnyPatternConfig}; this variant lets generated
+ * behavior descriptors (std-ts) carry the pre-substitution form the Rust
+ * validator accepts (worked example: `std-graphs` renders
+ * `{ type: '@config.viewPattern', chartType: '@config.chartType', … }`).
+ */
+type TemplatePatternConfig = {
+    type: PatternType | RenderBinding;
+} & Record<string, JsonValue>;
 /**
  * Render UI effect - displays a pattern in a UI slot.
  * @example ['render-ui', 'main', { patternType: 'entity-table', columns: ['name'] }]
  * @example ['render-ui', 'main', '@config.bodyContent']  // a {@link RenderBinding} target
+ * @example ['render-ui', '@config.reviewSlot', { patternType: 'entity-table' }]  // a {@link SlotBinding} slot
  */
-type RenderUIEffect = ['render-ui', UISlot, AnyPatternConfig] | ['render-ui', UISlot, AnyPatternConfig, ResolvedPatternProps] | ['render-ui', UISlot, RenderBinding] | ['render-ui', UISlot, null];
+type RenderUIEffect = ['render-ui', UISlot | SlotBinding, AnyPatternConfig] | ['render-ui', UISlot | SlotBinding, AnyPatternConfig, ResolvedPatternProps] | ['render-ui', UISlot | SlotBinding, TemplatePatternConfig] | ['render-ui', UISlot | SlotBinding, RenderBinding] | ['render-ui', UISlot | SlotBinding, null];
 /**
  * Lambda expression for per-item rendering in data-grid/data-list.
  * The compiler generates: {(paramName: Record<string, unknown>) => (<>JSX</>)}
@@ -6007,7 +6034,7 @@ type RenderChildrenMap = ['array/map', SExpr, RenderItemLambda];
  * @example ['navigate', '/tasks'] or ['navigate', '/tasks/:id', { id: '123' }]
  * @example ['navigate', 'https://example.com']
  */
-type NavigateEffect = ['navigate', string | SExpr] | ['navigate', string | SExpr, Record<string, string>];
+type NavigateEffect = ['navigate', string | SExpr] | ['navigate', string | SExpr, Record<string, string | SExpr>];
 /**
  * Emit effect - emits an event, optionally with payload.
  * @example ['emit', 'SAVE'] or ['emit', 'PLAYER_DIED', { playerId: '@entity.id' }]
@@ -6087,7 +6114,10 @@ type PersistEmitConfig = {
  * runtime, binding strings and expressions resolve to `EntityRow` values
  * before the persist op runs — both paths evaluate the expression first.
  */
-type PersistData = EntityRow | string | SExpr[];
+type PersistRowInput = {
+    id?: string | SExpr;
+} & Record<string, FieldValue | SExpr | undefined>;
+type PersistData = EntityRow | PersistRowInput | string | SExpr[];
 /**
  * Persist effect - creates, updates, deletes, or clears entities.
  *
@@ -6136,8 +6166,8 @@ type DespawnEffect = ['despawn', string];
 type DoEffect = ['do', ...SExpr[]];
 /**
  * Notify effect - sends a notification.
- * @example ['notify', 'in_app', 'Task created successfully']
- * @example ['notify', 'in_app', ['str/concat', 'Item: ', '@entity.name']]
+ * @example ['notify', 'in-app', 'Task created successfully']
+ * @example ['notify', 'in-app', ['str/concat', 'Item: ', '@entity.name']]
  */
 type NotifyEffect = ['notify', string, string | SExpr] | ['notify', string, string | SExpr, string];
 /**
@@ -6151,10 +6181,12 @@ type FetchOptions = {
     id?: string;
     /** Filter expression (S-expression) */
     filter?: SExpr;
-    /** Maximum number of entities to return */
-    limit?: number;
-    /** Number of entities to skip */
-    offset?: number;
+    /** Maximum number of entities to return. The template layer may carry a
+     *  binding (`'@config.pageSize'`) or a computed S-expression — the
+     *  compiler's inline phase resolves it to a number. */
+    limit?: number | RenderBinding | SExpr[];
+    /** Number of entities to skip — same template-layer forms as `limit`. */
+    offset?: number | RenderBinding | SExpr[];
     /** Relations to populate (entity field names) */
     include?: string[];
     /** Lifecycle events to emit on resolve / reject */
@@ -6570,10 +6602,10 @@ declare function despawn(entityId: string): DespawnEffect;
 declare function doEffects(...effects: SExpr[]): DoEffect;
 /**
  * Create a notify effect
- * @example ["notify", "in_app", "Task created successfully"]
+ * @example ["notify", "in-app", "Task created successfully"]
  */
-declare function notify(channel: 'email' | 'push' | 'sms' | 'in_app', message: string): NotifyEffect;
-declare function notify(channel: 'email' | 'push' | 'sms' | 'in_app', message: string, recipient: string): NotifyEffect;
+declare function notify(channel: 'email' | 'push' | 'sms' | 'in-app', message: string): NotifyEffect;
+declare function notify(channel: 'email' | 'push' | 'sms' | 'in-app', message: string, recipient: string): NotifyEffect;
 /**
  * Create a ref effect (reactive entity subscription).
  *

package/dist/{entityAccess-Bnz5CJ3S.d.ts → entityAccess-QAurFO7l.d.ts}

@@ -1,4 +1,4 @@
-import { O as OrbitalSchema } from './schema-Nk1usPv6.js';
+import { O as OrbitalSchema } from './schema-Sk_irLOY.js';
 import { S as SExpr } from './expression-Fk8bQWef.js';
 
 /**

package/dist/factory/index.d.ts

@@ -1,7 +1,7 @@
-import { h as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, j as FactorySignature, R as RuleOverlay, p as RuleOverlayEntry, o as PresentationOverlay, T as TraitOverlay } from '../types-C4YztU2N.js';
-export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, i as FactoryProvenance, k as FactorySignatureCatalog, l as FactorySignatureEntityField, m as FactoryTraitSignature, J as JsonSchema, n as JsonSchemaType, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, q as TraitOverlayEntry, r as TraitOverlayListener } from '../types-C4YztU2N.js';
-import { a as EntityPersistence, E as EntityField } from '../effect-DxD-XTI8.js';
-import { a as TraitReference } from '../trait-WnYkvPdZ.js';
+import { h as FactoryParamValue, c as FactoryConfigTier, b as FactoryConfigParam, F as FactoryCallSite, j as FactorySignature, R as RuleOverlay, p as RuleOverlayEntry, o as PresentationOverlay, T as TraitOverlay } from '../types-D71hY_4A.js';
+export { a as FactoryCallSiteParams, d as FactoryEntitySignature, e as FactoryEventSignature, f as FactoryExposure, g as FactoryPageSignature, i as FactoryProvenance, k as FactorySignatureCatalog, l as FactorySignatureEntityField, m as FactoryTraitSignature, J as JsonSchema, n as JsonSchemaType, O as OwnershipOverlayEntry, P as PresentationNavItem, S as SchemaFieldType, q as TraitOverlayEntry, r as TraitOverlayListener } from '../types-D71hY_4A.js';
+import { a as EntityPersistence, E as EntityField } from '../effect-BH2k4oK6.js';
+import { a as TraitReference } from '../trait-Bw4nWHu1.js';
 export { J as JsonValue } from '../expression-Fk8bQWef.js';
 import 'zod';
 

package/dist/factory-runtime/index.d.ts

@@ -1,6 +1,6 @@
-import { O as OrbitalSchema, a as OrbitalDefinition } from '../schema-Nk1usPv6.js';
-import { h as CallSiteConfig, i as CallSiteConfigEntry, g as Trait } from '../trait-WnYkvPdZ.js';
-import { E as EntityField, a as EntityPersistence } from '../effect-DxD-XTI8.js';
+import { O as OrbitalSchema, a as OrbitalDefinition } from '../schema-Sk_irLOY.js';
+import { h as CallSiteConfig, i as CallSiteConfigEntry, g as Trait } from '../trait-Bw4nWHu1.js';
+import { E as EntityField, a as EntityPersistence } from '../effect-BH2k4oK6.js';
 import { MakeTraitRefOpts } from '../builders.js';
 import '../expression-Fk8bQWef.js';
 import 'zod';
@@ -150,18 +150,39 @@ declare function rewriteEntityInInlineTrait(trait: Trait, oldName: string, newNa
  */
 declare function mergeCallSiteConfigOverrides(base: CallSiteConfig, overrides: CallSiteConfig): Record<string, CallSiteConfigEntry>;
 /**
- * Apply `traitOverrides.<T>.name` renames to trait DECLARATIONS only,
- * AFTER the schema has been stamped (V4-W4 stamp-before-rename).
+ * Read-only structural view over the JSON lattice the reference-rewrite
+ * walker traverses — same trick as `derive-expectations.ts` (`SExpr` and
+ * `TraitConfigValue` both assign to it). Exported alongside
+ * `rewriteTraitRefsInTree` for the rabit composer's dedupe backstop.
+ */
+type WalkableData = string | number | boolean | null | ReadonlyArray<WalkableData> | {
+    readonly [key: string]: WalkableData;
+};
+/**
+ * Deep `@trait.<from>` → `@trait.<to>` token rewrite over a JSON tree —
+ * config values at any depth, state-machine trees, listen/tick arms. The
+ * rename pass (`applyDeclarationTraitRenames`) and the rabit composer's
+ * inline-trait dedupe backstop share this one walker so both cover exactly
+ * the positions the compiled path's `rewrite_trait_embed_in_sexpr` does.
+ */
+declare function rewriteTraitRefsInTree(node: WalkableData, renames: ReadonlyMap<string, string>): WalkableData;
+/**
+ * Apply `traitOverrides.<T>.name` renames to trait DECLARATIONS, AFTER the
+ * schema has been stamped (V4-W4 stamp-before-rename).
  *
- * A trait rename is a pure display-name change: it renames the declaration
- * (`traits[].name` for inline traits, the ref object's local `name` for
- * reference traits) and nothing else. Every REFERENCE to the trait —
- * `pages[].traits[].ref`, `@trait.<canonical>` tokens in sibling config /
- * stateMachine effect trees — is left carrying its canonical name AND its
- * stamped id (page ref `refId`, the referring trait's `traitEmbedIds`
- * side-map). Readers resolve those references by stable id onto the renamed
- * declaration, so no token/page-ref rewrite is needed (this replaced the
- * deleted `applyTraitRenames`).
+ * The rename moves the declaration (`traits[].name` for inline traits, the
+ * ref object's local `name` for reference traits), the ledger `curName` of
+ * each renamed declaration id, AND every name-based reference to the old
+ * name: `@trait.<old>` tokens in config values and state-machine/tick effect
+ * trees, the `traitEmbedIds` side-map keys that index those tokens, and page
+ * trait refs (`pages[].traits[].ref`). The dual-carry ids (`refId`,
+ * `traitEmbedIds` values) are untouched, so the compiled path's
+ * `identity_normalize` pass observes tokens already equal to the id-resolved
+ * current name and no-ops, while the JS runtime — which resolves `@trait.X`
+ * config knobs (e.g. `DashboardLayout.config.tile2Trait`) and page refs BY
+ * NAME — never sees a dangling reference (FIX-H, dashboard-edit-title-string
+ * 2026-08-06: the declaration-only rename left `@trait.DefaultRevenueChart`
+ * in a sibling's config and the page ref while validate stayed green).
  *
  * The keys are canonical names because stamping ran while the declaration
  * still carried its canonical name (the factory no longer renames — see
@@ -228,6 +249,20 @@ at: string): OrbitalSchema;
  * adopted row carries identity (the id) forward. No-op when they agree.
  */
 declare function healEntityLedgerRows(schema: OrbitalSchema, at: string): OrbitalSchema;
+/**
+ * Trait-declaration sibling of `healEntityLedgerRows`. A re-instantiate with
+ * NO trait renames in its params (a corrective rebuild, or the plan-repair
+ * reset-to-factory-defaults verb) adopts the prior `.orb`'s ledger — including
+ * trait rename rows an earlier build recorded — while the factory re-emits
+ * every trait declaration at its baked/requested name, so the stale `curName`
+ * would manufacture an `ORB_ID_NAME_MISMATCH` (the entity twin of this is the
+ * battery 2026-08-06 `healEntityLedgerRows` case). Same soundness argument:
+ * on this path the factory re-emission is the build's truth and the adopted
+ * row carries identity (the id) forward. Reference-form declarations resolve
+ * their current name as `name ?? <ref last segment>` (mirrors the compiler's
+ * `collect_trait_id_names`). No-op when they agree.
+ */
+declare function healTraitLedgerRows(schema: OrbitalSchema, at: string): OrbitalSchema;
 /**
  * The overlay. Resolves the effective entity name + collection, calls
  * `makeOrbitalWithUses` with the rewritten data, then applies the params'
@@ -251,4 +286,4 @@ declare function applyParamsToOrb(orb: OrbitalSchema, orbitalName: string, _mani
 
 declare function applyParamsToWholeOrb(orb: OrbitalSchema, manifests: readonly OrbitalParamsManifest[], params: OrbitalFactoryParams): OrbitalSchema;
 
-export { type EntityDeclarationRename, type OrbitalFactoryParams, type OrbitalParamsManifest, type OrbitalTraitOverride, type ParamFieldDescriptor, type ParamValidationError, type ParamValidationResult, applyDeclarationEntityRename, applyDeclarationTraitRenames, applyParamsToOrb, applyParamsToWholeOrb, extractManifest, healEntityLedgerRows, mergeCallSiteConfigOverrides, rebindInlineTraitEntity, rewriteEntityInInlineTrait, validateOrbitalFactoryParams };
+export { type EntityDeclarationRename, type OrbitalFactoryParams, type OrbitalParamsManifest, type OrbitalTraitOverride, type ParamFieldDescriptor, type ParamValidationError, type ParamValidationResult, type WalkableData, applyDeclarationEntityRename, applyDeclarationTraitRenames, applyParamsToOrb, applyParamsToWholeOrb, extractManifest, healEntityLedgerRows, healTraitLedgerRows, mergeCallSiteConfigOverrides, rebindInlineTraitEntity, rewriteEntityInInlineTrait, rewriteTraitRefsInTree, validateOrbitalFactoryParams };

package/dist/factory-runtime/index.js

@@ -148,6 +148,7 @@ var EntityFieldSchema = z.lazy(() => {
   const baseFieldShape = {
     name: z.string().min(1, "Field name is required").optional(),
     required: z.boolean().optional(),
+    primaryKey: z.boolean().optional(),
     default: JsonValueSchema.optional(),
     min: z.number().optional(),
     max: z.number().optional(),
@@ -555,7 +556,10 @@ var TraitEntityFieldSchema = z.object({
     "url",
     "phone",
     "uuid",
-    "image"
+    "image",
+    "trait",
+    "slot",
+    "pattern"
   ]),
   required: z.boolean().optional(),
   default: TraitConfigValueSchema.optional(),
@@ -665,7 +669,7 @@ var TraitEventListenerSchema = z.object({
 });
 var RequiredFieldSchema = z.object({
   name: z.string().min(1),
-  type: z.enum(["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum", "email", "url", "phone", "uuid", "image"]),
+  type: z.enum(["string", "number", "boolean", "date", "array", "object", "timestamp", "datetime", "enum", "email", "url", "phone", "uuid", "image", "trait", "slot", "pattern"]),
   description: z.string().optional()
 });
 var TraitReferenceSchema = z.object({
@@ -1592,6 +1596,7 @@ function makeOrbitalWithUses(opts) {
     uses: opts.uses,
     ...opts.expects !== void 0 ? { expects: opts.expects } : {},
     entity: opts.entity,
+    ...opts.auxiliaryEntities !== void 0 ? { auxiliaryEntities: opts.auxiliaryEntities } : {},
     traits: opts.traits,
     pages: opts.pages ?? []
   };
@@ -1884,22 +1889,83 @@ function mergeCallSiteConfigOverrides(base, overrides) {
   }
   return next;
 }
+function rewriteTraitRefToken(value, renames) {
+  const prefix = "@trait.";
+  if (!value.startsWith(prefix)) return value;
+  const rest = value.slice(prefix.length);
+  const splitAt = rest.search(/[.[]/);
+  const name = splitAt === -1 ? rest : rest.slice(0, splitAt);
+  const to = renames.get(name);
+  if (to === void 0) return value;
+  return `${prefix}${to}${splitAt === -1 ? "" : rest.slice(splitAt)}`;
+}
+function rewriteTraitRefsInTree(node, renames) {
+  if (typeof node === "string") return rewriteTraitRefToken(node, renames);
+  if (Array.isArray(node)) return node.map((item) => rewriteTraitRefsInTree(item, renames));
+  if (node !== null && typeof node === "object") {
+    const out = {};
+    for (const [key, value] of Object.entries(node)) out[key] = rewriteTraitRefsInTree(value, renames);
+    return out;
+  }
+  return node;
+}
+function rekeyTraitEmbedIds(embedIds, renames) {
+  let out;
+  for (const [token, id] of Object.entries(embedIds)) {
+    const to = renames.get(token);
+    if (to === void 0) continue;
+    out = out ?? { ...embedIds };
+    delete out[token];
+    out[to] = id;
+  }
+  return out ?? embedIds;
+}
 function applyDeclarationTraitRenames(schema, renames, at) {
   if (renames.size === 0) return schema;
   const renamedTraitIds = [];
   const renameDeclaration = (t) => {
     if (typeof t !== "object" || t === null) return t;
+    let next = t;
     const named = t;
-    if (typeof named.name !== "string") return t;
-    const renamed = renames.get(named.name);
-    if (renamed === void 0) return t;
-    const id = t.id;
-    if (typeof id === "string") renamedTraitIds.push({ id, to: renamed });
-    return { ...t, name: renamed };
+    if (typeof named.name === "string") {
+      const renamed = renames.get(named.name);
+      if (renamed !== void 0) {
+        const id = t.id;
+        if (typeof id === "string") renamedTraitIds.push({ id, to: renamed });
+        next = { ...next, name: renamed };
+      }
+    }
+    const walked = rewriteTraitRefsInTree(next, renames);
+    const embedIds = walked.traitEmbedIds;
+    if (embedIds !== void 0) {
+      const rekeyed = rekeyTraitEmbedIds(embedIds, renames);
+      if (rekeyed !== embedIds) {
+        walked.traitEmbedIds = rekeyed;
+      }
+    }
+    return walked;
+  };
+  const renamePageTraitRefs = (p) => {
+    if (typeof p !== "object" || p === null) return p;
+    const walked = rewriteTraitRefsInTree(p, renames);
+    const traits = walked.traits;
+    if (!Array.isArray(traits)) return walked;
+    return {
+      ...walked,
+      traits: traits.map((t) => {
+        if (typeof t === "string") return renames.get(t) ?? t;
+        const to = renames.get(t.ref);
+        return to === void 0 ? t : { ...t, ref: to };
+      })
+    };
   };
   const orbitals = schema.orbitals.map((orbital) => {
     if (!("traits" in orbital) || !Array.isArray(orbital.traits)) return orbital;
-    return { ...orbital, traits: orbital.traits.map(renameDeclaration) };
+    return {
+      ...orbital,
+      traits: orbital.traits.map(renameDeclaration),
+      ...orbital.pages !== void 0 ? { pages: orbital.pages.map(renamePageTraitRefs) } : {}
+    };
   });
   let ledger = schema.ledger;
   if (ledger !== void 0) {
@@ -1956,6 +2022,24 @@ function healEntityLedgerRows(schema, at) {
   }
   return ledger !== schema.ledger ? { ...schema, ledger } : schema;
 }
+function healTraitLedgerRows(schema, at) {
+  let ledger = schema.ledger;
+  if (ledger === void 0) return schema;
+  for (const orbital of schema.orbitals) {
+    for (const trait of orbital.traits ?? []) {
+      if (typeof trait !== "object" || trait === null) continue;
+      const id = trait.id;
+      if (typeof id !== "string") continue;
+      const declared = trait;
+      const name = typeof declared.name === "string" ? declared.name : typeof declared.ref === "string" ? declared.ref.slice(declared.ref.lastIndexOf(".") + 1) : void 0;
+      if (name === void 0) continue;
+      const entry = ledger.entries[id];
+      if (entry === void 0 || entry.kind !== "trait" || entry.curName === name) continue;
+      ledger = ledgerRename(ledger, id, name, at);
+    }
+  }
+  return ledger !== schema.ledger ? { ...schema, ledger } : schema;
+}
 function applyParamsToOrb(orb, orbitalName, _manifest, params) {
   const orbital = findOrbitalOrThrow(orb, orbitalName);
   const canonicalEntity = assertResolvedEntity(orbital.entity, orbitalName, orb.name);
@@ -2030,6 +2114,6 @@ function applyParamsToWholeOrb(orb, manifests, params) {
   return { ...orb, orbitals: rebuilt };
 }
 
-export { applyDeclarationEntityRename, applyDeclarationTraitRenames, applyParamsToOrb, applyParamsToWholeOrb, extractManifest, healEntityLedgerRows, mergeCallSiteConfigOverrides, rebindInlineTraitEntity, rewriteEntityInInlineTrait, validateOrbitalFactoryParams };
+export { applyDeclarationEntityRename, applyDeclarationTraitRenames, applyParamsToOrb, applyParamsToWholeOrb, extractManifest, healEntityLedgerRows, healTraitLedgerRows, mergeCallSiteConfigOverrides, rebindInlineTraitEntity, rewriteEntityInInlineTrait, rewriteTraitRefsInTree, validateOrbitalFactoryParams };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map