@almadar/core 10.63.0 → 10.64.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2464,7 +2464,7 @@ type EntityData = Record<string, EntityRow[]>;
2464
2464
  *
2465
2465
  * DO NOT EDIT MANUALLY — regenerated by almadar-pattern-sync `patterns` command.
2466
2466
  *
2467
- * Generated: 2026-08-20T23:14:19.798Z
2467
+ * Generated: 2026-08-21T10:52:11.834Z
2468
2468
  * Pattern count: 272
2469
2469
  */
2470
2470
 
@@ -2829,7 +2829,9 @@ interface PatternPropsMap {
2829
2829
  };
2830
2830
  'breadcrumb': {
2831
2831
  type: 'breadcrumb';
2832
- items: unknown[] | string | SExpr;
2832
+ items?: unknown[] | string | SExpr;
2833
+ fromNavStack?: boolean | string | SExpr;
2834
+ itemEvent?: string | SExpr;
2833
2835
  separator?: unknown | string | SExpr;
2834
2836
  maxItems?: number | string | SExpr;
2835
2837
  className?: string | SExpr;
@@ -3423,6 +3425,7 @@ interface PatternPropsMap {
3423
3425
  avatar?: unknown | string | SExpr;
3424
3426
  sections?: unknown[] | string | SExpr;
3425
3427
  actions?: unknown[] | string | SExpr;
3428
+ maxInlineActions?: number | string | SExpr;
3426
3429
  backAction?: PatternPropValue | string | SExpr;
3427
3430
  footer?: unknown | string | SExpr;
3428
3431
  slideOver?: boolean | string | SExpr;
@@ -6168,12 +6171,31 @@ type RenderItemLambda = ['fn', string, AnyPatternConfig];
6168
6171
  * @example ["array/map", "@entity.tasks", ["fn", "item", { "type": "typography", "content": "@item.title" }]]
6169
6172
  */
6170
6173
  type RenderChildrenMap = ['array/map', SExpr, RenderItemLambda];
6174
+ /**
6175
+ * Trailing options object on navigate effects. `crumb` labels the navigation
6176
+ * stack entry the client pushes for the target page (e.g. the record title a
6177
+ * list router has in `?row` at push time); without it the entry falls back to
6178
+ * the target page's declared/derived label.
6179
+ */
6180
+ type NavigateOptions = {
6181
+ crumb?: string | SExpr;
6182
+ };
6171
6183
  /**
6172
6184
  * Navigate effect - navigates to an internal page path or an external URL.
6173
6185
  * @example ['navigate', '/tasks'] or ['navigate', '/tasks/:id', { id: '123' }]
6174
6186
  * @example ['navigate', 'https://example.com']
6187
+ * @example ['navigate', '/contracts/42', { id: '42' }, { crumb: '@payload.row.title' }]
6175
6188
  */
6176
- type NavigateEffect = ['navigate', string | SExpr] | ['navigate', string | SExpr, Record<string, string | SExpr>];
6189
+ type NavigateEffect = ['navigate', string | SExpr] | ['navigate', string | SExpr, Record<string, string | SExpr>] | ['navigate', string | SExpr, Record<string, string | SExpr>, NavigateOptions];
6190
+ /**
6191
+ * Navigate-back effect - pops the current entry off the orbital-scoped
6192
+ * navigation stack and navigates to the previous one. The stack is
6193
+ * client-session state (cold loads are seeded from declared page-path
6194
+ * prefixes), so an ancestor always exists on nested paths; the validator
6195
+ * rejects `navigate-back` reachable only from pages with no path ancestor.
6196
+ * @example ['navigate-back']
6197
+ */
6198
+ type NavigateBackEffect = ['navigate-back'];
6177
6199
  /**
6178
6200
  * Emit effect - emits an event, optionally with payload.
6179
6201
  * @example ['emit', 'SAVE'] or ['emit', 'PLAYER_DIED', { playerId: '@entity.id' }]
@@ -6601,7 +6623,7 @@ type AsyncSequenceEffect = ['async/sequence', ...Effect[]];
6601
6623
  * Union of all typed effects.
6602
6624
  * Provides compile-time validation for common effect types.
6603
6625
  */
6604
- type TypedEffect = RenderUIEffect | NavigateEffect | EmitEffect | SetEffect | PersistEffect | CallServiceEffect | SpawnEffect | DespawnEffect | DoEffect | NotifyEffect | FetchEffect | IfEffect | WhenEffect | LetEffect | LogEffect | WaitEffect | RefEffect | DerefEffect | SwapEffect | WatchEffect | AtomicEffect | AsyncDelayEffect | AsyncDebounceEffect | AsyncThrottleEffect | AsyncIntervalEffect | AsyncRaceEffect | AsyncAllEffect | AsyncSequenceEffect | ForwardEffect | TrainEffect | EvaluateEffect | CheckpointSaveEffect | CheckpointLoadEffect | AgentEffect | OsEffect | BrowserEffect | LlmEffect | BehaviorEffect | ValidateEffect | SessionEffect | ComposeEffect | TraceEffect | MemoryEffect | ApplicationEffect;
6626
+ type TypedEffect = RenderUIEffect | NavigateEffect | NavigateBackEffect | EmitEffect | SetEffect | PersistEffect | CallServiceEffect | SpawnEffect | DespawnEffect | DoEffect | NotifyEffect | FetchEffect | IfEffect | WhenEffect | LetEffect | LogEffect | WaitEffect | RefEffect | DerefEffect | SwapEffect | WatchEffect | AtomicEffect | AsyncDelayEffect | AsyncDebounceEffect | AsyncThrottleEffect | AsyncIntervalEffect | AsyncRaceEffect | AsyncAllEffect | AsyncSequenceEffect | ForwardEffect | TrainEffect | EvaluateEffect | CheckpointSaveEffect | CheckpointLoadEffect | AgentEffect | OsEffect | BrowserEffect | LlmEffect | BehaviorEffect | ValidateEffect | SessionEffect | ComposeEffect | TraceEffect | MemoryEffect | ApplicationEffect;
6605
6627
  /**
6606
6628
  * Effect type - typed S-expression format.
6607
6629
  *
@@ -6706,6 +6728,15 @@ declare function emit(event: string, payload?: EventPayload): Effect;
6706
6728
  */
6707
6729
  declare function navigate(path: string): NavigateEffect;
6708
6730
  declare function navigate(path: string, params: Record<string, string>): NavigateEffect;
6731
+ declare function navigate(path: string, params: Record<string, string>, options: NavigateOptions): NavigateEffect;
6732
+ /**
6733
+ * Creates a navigate-back effect: pop the orbital's navigation stack and
6734
+ * navigate to the previous entry.
6735
+ *
6736
+ * @example
6737
+ * navigateBack(); // returns ["navigate-back"]
6738
+ */
6739
+ declare function navigateBack(): NavigateBackEffect;
6709
6740
  /**
6710
6741
  * Create a render-ui effect
6711
6742
  * @example ["render-ui", "main", { "patternType": "entity-table", "columns": ["name"] }]
@@ -6820,4 +6851,4 @@ interface RenderUINode {
6820
6851
  renderItem?: RenderUINode;
6821
6852
  }
6822
6853
 
6823
- export { type ComposeEffect as $, type AnyPatternConfig as A, AssetCatalogEntrySchema as B, AssetCatalogSchema as C, type AssetDimension as D, type EntityField as E, type FieldValue as F, AssetDimensionSchema as G, AssetSchema as H, type IdentityLedger as I, type AssetUrl as J, type AtomicEffect as K, type BehaviorEffect as L, CAMERA_MODES as M, type CallServiceConfig as N, type OrbitalId as O, type PageId as P, type CallServiceEffect as Q, type RelationConfig as R, type ServiceRef as S, type TraitId as T, type UISlot as U, type Camera as V, type CameraMode as W, CameraModeSchema as X, CameraSchema as Y, type CheckpointLoadEffect as Z, type CheckpointSaveEffect as _, type EntityPersistence as a, type PersistData as a$, type DerefEffect as a0, type DespawnEffect as a1, type DoEffect as a2, ENTITY_ROLES as a3, type EffectInput as a4, EffectSchema as a5, type EmitConfig as a6, type EmitEffect as a7, type EntityData as a8, type EntityFieldInput as a9, type LedgerEntry as aA, LedgerEntrySchema as aB, type LedgerKind as aC, LedgerKindSchema as aD, type LlmEffect as aE, type LogEffect as aF, type McpServiceDef as aG, McpServiceDefSchema as aH, type MemoryEffect as aI, type NavigateEffect as aJ, type NnConfig as aK, type NnLayer as aL, type NotifyEffect as aM, type ObjectEntityField as aN, type OrbitalEntity as aO, type OrbitalEntityInput as aP, OrbitalEntitySchema as aQ, OrbitalIdSchema as aR, type OsEffect as aS, PATTERN_TYPES as aT, PageIdSchema as aU, type PaletteEntryId as aV, PaletteEntryIdSchema as aW, type PatternConfig as aX, type PatternProps as aY, type PatternPropsMap as aZ, type PatternType as a_, EntityFieldSchema as aa, EntityIdSchema as ab, EntityPersistenceSchema as ac, type EntityRole as ad, EntityRoleSchema as ae, EntitySchema as af, type EntityWith as ag, type EnumEntityField as ah, type EvaluateConfig as ai, type EvaluateEffect as aj, EventIdSchema as ak, FIELD_TYPES as al, type FetchEffect as am, type FetchOptions as an, type FetchResult as ao, type Field as ap, FieldSchema as aq, type FieldType as ar, FieldTypeSchema as as, type FileValue as at, FileValueSchema as au, type ForwardConfig as av, type ForwardEffect as aw, type IdForKind as ax, type IdKind as ay, IdentityLedgerSchema as az, type EventId as b, UISlotSchema as b$, type PersistEffect as b0, type PersistEmitConfig as b1, type RefEffect as b2, RelationConfigSchema as b3, type RelationEntityField as b4, type RenderChildrenMap as b5, type RenderItemLambda as b6, type RenderUINode as b7, type ResolvedPatternProps as b8, type RestAuthConfig as b9, type SetEffect as bA, type SheetProjection as bB, SheetProjectionSchema as bC, type SocketEvents as bD, SocketEventsSchema as bE, type SocketServiceDef as bF, SocketServiceDefSchema as bG, type SpawnEffect as bH, type SpriteDirection as bI, SpriteDirectionSchema as bJ, type SpriteSheetAtlas as bK, type SpriteSheetAtlasInput as bL, SpriteSheetAtlasSchema as bM, type SubTexture as bN, SubTextureSchema as bO, type SwapEffect as bP, type TextureAtlas as bQ, TextureAtlasSchema as bR, type ThemeId as bS, ThemeIdSchema as bT, type Tilesheet as bU, TilesheetSchema as bV, type TraceEffect as bW, type TrainConfig as bX, type TrainEffect as bY, TraitIdSchema as bZ, type TypedEffect as b_, RestAuthConfigSchema as ba, type RestServiceDef as bb, RestServiceDefSchema as bc, SEMANTIC_STRING_TYPES as bd, SERVICE_TYPES as be, SHEET_PROJECTIONS as bf, SPRITE_DIRECTIONS as bg, type ScalarEntityField as bh, type ScenePos as bi, ScenePosSchema as bj, type SemanticAssetRef as bk, type SemanticAssetRefInput as bl, SemanticAssetRefSchema as bm, type SemanticStringType as bn, ServiceDefinitionSchema as bo, type ServiceId as bp, ServiceIdSchema as bq, type ServiceParams as br, type ServiceParamsValue as bs, type ServiceRefObject as bt, ServiceRefObjectSchema as bu, ServiceRefSchema as bv, ServiceRefStringSchema as bw, type ServiceType as bx, ServiceTypeSchema as by, type SessionEffect as bz, type Effect as c, persistenceModeAllowsOverrides as c$, UI_SLOTS as c0, VISUAL_STYLES as c1, type ValidateEffect as c2, type VisualStyle as c3, VisualStyleSchema as c4, type WatchEffect as c5, type WatchOptions as c6, asEntityId as c7, asEventId as c8, asOrbitalId as c9, isOrbitalId as cA, isPageId as cB, isPaletteEntryId as cC, isPhoneValue as cD, isRestService as cE, isRuntimeEntity as cF, isSExprEffect as cG, isSemanticStringType as cH, isSemanticStringValue as cI, isServiceId as cJ, isServiceReference as cK, isServiceReferenceObject as cL, isSocketService as cM, isThemeId as cN, isTraitId as cO, isUrlValue as cP, isUuidValue as cQ, isValidPatternType as cR, ledgerCurName as cS, ledgerRename as cT, ledgerResolveName as cU, mintId as cV, navigate as cW, notify as cX, parseAssetKey as cY, parseServiceRef as cZ, persist as c_, asPageId as ca, asPaletteEntryId as cb, asServiceId as cc, asThemeId as cd, asTraitId as ce, atomic as cf, callService as cg, createAssetKey as ch, deref as ci, deriveCollection as cj, despawn as ck, doEffects as cl, emit as cm, findService as cn, getDefaultAnimationsForRole as co, getServiceNames as cp, hasService as cq, idKindOf as cr, idPrefix as cs, isEffect as ct, isEmailValue as cu, isEntityId as cv, isEventId as cw, isFieldValue as cx, isFileValue as cy, isMcpService as cz, type EntityId as d, ref as d0, renderUI as d1, set as d2, spawn as d3, swap as d4, validateAssetAnimations as d5, watch as d6, type Entity as e, type EntityRow as f, type ServiceDefinition as g, type RenderBinding as h, type RenderUIEffect as i, ANIMATION_NAMES as j, ASSET_ASPECTS as k, ASSET_DIMENSIONS as l, type AgentEffect as m, type AnimationDef as n, type AnimationDefInput as o, AnimationDefSchema as p, type AnimationName as q, AnimationNameSchema as r, type ApplicationEffect as s, type ArrayEntityField as t, type Asset as u, type AssetAspect as v, AssetAspectSchema as w, type AssetCatalog as x, type AssetCatalogEntry as y, type AssetCatalogEntryInput as z };
6854
+ export { type ComposeEffect as $, type AnyPatternConfig as A, AssetCatalogEntrySchema as B, AssetCatalogSchema as C, type AssetDimension as D, type EntityField as E, type FieldValue as F, AssetDimensionSchema as G, AssetSchema as H, type IdentityLedger as I, type AssetUrl as J, type AtomicEffect as K, type BehaviorEffect as L, CAMERA_MODES as M, type CallServiceConfig as N, type OrbitalId as O, type PageId as P, type CallServiceEffect as Q, type RelationConfig as R, type ServiceRef as S, type TraitId as T, type UISlot as U, type Camera as V, type CameraMode as W, CameraModeSchema as X, CameraSchema as Y, type CheckpointLoadEffect as Z, type CheckpointSaveEffect as _, type EntityPersistence as a, type PatternPropsMap as a$, type DerefEffect as a0, type DespawnEffect as a1, type DoEffect as a2, ENTITY_ROLES as a3, type EffectInput as a4, EffectSchema as a5, type EmitConfig as a6, type EmitEffect as a7, type EntityData as a8, type EntityFieldInput as a9, type LedgerEntry as aA, LedgerEntrySchema as aB, type LedgerKind as aC, LedgerKindSchema as aD, type LlmEffect as aE, type LogEffect as aF, type McpServiceDef as aG, McpServiceDefSchema as aH, type MemoryEffect as aI, type NavigateBackEffect as aJ, type NavigateEffect as aK, type NavigateOptions as aL, type NnConfig as aM, type NnLayer as aN, type NotifyEffect as aO, type ObjectEntityField as aP, type OrbitalEntity as aQ, type OrbitalEntityInput as aR, OrbitalEntitySchema as aS, OrbitalIdSchema as aT, type OsEffect as aU, PATTERN_TYPES as aV, PageIdSchema as aW, type PaletteEntryId as aX, PaletteEntryIdSchema as aY, type PatternConfig as aZ, type PatternProps as a_, EntityFieldSchema as aa, EntityIdSchema as ab, EntityPersistenceSchema as ac, type EntityRole as ad, EntityRoleSchema as ae, EntitySchema as af, type EntityWith as ag, type EnumEntityField as ah, type EvaluateConfig as ai, type EvaluateEffect as aj, EventIdSchema as ak, FIELD_TYPES as al, type FetchEffect as am, type FetchOptions as an, type FetchResult as ao, type Field as ap, FieldSchema as aq, type FieldType as ar, FieldTypeSchema as as, type FileValue as at, FileValueSchema as au, type ForwardConfig as av, type ForwardEffect as aw, type IdForKind as ax, type IdKind as ay, IdentityLedgerSchema as az, type EventId as b, TraitIdSchema as b$, type PatternType as b0, type PersistData as b1, type PersistEffect as b2, type PersistEmitConfig as b3, type RefEffect as b4, RelationConfigSchema as b5, type RelationEntityField as b6, type RenderChildrenMap as b7, type RenderItemLambda as b8, type RenderUINode as b9, ServiceTypeSchema as bA, type SessionEffect as bB, type SetEffect as bC, type SheetProjection as bD, SheetProjectionSchema as bE, type SocketEvents as bF, SocketEventsSchema as bG, type SocketServiceDef as bH, SocketServiceDefSchema as bI, type SpawnEffect as bJ, type SpriteDirection as bK, SpriteDirectionSchema as bL, type SpriteSheetAtlas as bM, type SpriteSheetAtlasInput as bN, SpriteSheetAtlasSchema as bO, type SubTexture as bP, SubTextureSchema as bQ, type SwapEffect as bR, type TextureAtlas as bS, TextureAtlasSchema as bT, type ThemeId as bU, ThemeIdSchema as bV, type Tilesheet as bW, TilesheetSchema as bX, type TraceEffect as bY, type TrainConfig as bZ, type TrainEffect as b_, type ResolvedPatternProps as ba, type RestAuthConfig as bb, RestAuthConfigSchema as bc, type RestServiceDef as bd, RestServiceDefSchema as be, SEMANTIC_STRING_TYPES as bf, SERVICE_TYPES as bg, SHEET_PROJECTIONS as bh, SPRITE_DIRECTIONS as bi, type ScalarEntityField as bj, type ScenePos as bk, ScenePosSchema as bl, type SemanticAssetRef as bm, type SemanticAssetRefInput as bn, SemanticAssetRefSchema as bo, type SemanticStringType as bp, ServiceDefinitionSchema as bq, type ServiceId as br, ServiceIdSchema as bs, type ServiceParams as bt, type ServiceParamsValue as bu, type ServiceRefObject as bv, ServiceRefObjectSchema as bw, ServiceRefSchema as bx, ServiceRefStringSchema as by, type ServiceType as bz, type Effect as c, parseAssetKey as c$, type TypedEffect as c0, UISlotSchema as c1, UI_SLOTS as c2, VISUAL_STYLES as c3, type ValidateEffect as c4, type VisualStyle as c5, VisualStyleSchema as c6, type WatchEffect as c7, type WatchOptions as c8, asEntityId as c9, isFileValue as cA, isMcpService as cB, isOrbitalId as cC, isPageId as cD, isPaletteEntryId as cE, isPhoneValue as cF, isRestService as cG, isRuntimeEntity as cH, isSExprEffect as cI, isSemanticStringType as cJ, isSemanticStringValue as cK, isServiceId as cL, isServiceReference as cM, isServiceReferenceObject as cN, isSocketService as cO, isThemeId as cP, isTraitId as cQ, isUrlValue as cR, isUuidValue as cS, isValidPatternType as cT, ledgerCurName as cU, ledgerRename as cV, ledgerResolveName as cW, mintId as cX, navigate as cY, navigateBack as cZ, notify as c_, asEventId as ca, asOrbitalId as cb, asPageId as cc, asPaletteEntryId as cd, asServiceId as ce, asThemeId as cf, asTraitId as cg, atomic as ch, callService as ci, createAssetKey as cj, deref as ck, deriveCollection as cl, despawn as cm, doEffects as cn, emit as co, findService as cp, getDefaultAnimationsForRole as cq, getServiceNames as cr, hasService as cs, idKindOf as ct, idPrefix as cu, isEffect as cv, isEmailValue as cw, isEntityId as cx, isEventId as cy, isFieldValue as cz, type EntityId as d, parseServiceRef as d0, persist as d1, persistenceModeAllowsOverrides as d2, ref as d3, renderUI as d4, set as d5, spawn as d6, swap as d7, validateAssetAnimations as d8, watch as d9, type Entity as e, type EntityRow as f, type ServiceDefinition as g, type RenderBinding as h, type RenderUIEffect as i, ANIMATION_NAMES as j, ASSET_ASPECTS as k, ASSET_DIMENSIONS as l, type AgentEffect as m, type AnimationDef as n, type AnimationDefInput as o, AnimationDefSchema as p, type AnimationName as q, AnimationNameSchema as r, type ApplicationEffect as s, type ArrayEntityField as t, type Asset as u, type AssetAspect as v, AssetAspectSchema as w, type AssetCatalog as x, type AssetCatalogEntry as y, type AssetCatalogEntryInput as z };
@@ -1,4 +1,4 @@
1
- import { O as OrbitalSchema } from './schema-KdqDOMXm.js';
1
+ import { O as OrbitalSchema } from './schema-B648ulAY.js';
2
2
  import { S as SExpr } from './expression-Fk8bQWef.js';
3
3
 
4
4
  /**
@@ -1,7 +1,7 @@
1
- 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-mYXAkmBy.js';
2
- 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-mYXAkmBy.js';
3
- import { a as EntityPersistence, E as EntityField } from '../effect-CgDrWfKW.js';
4
- import { a as TraitReference } from '../trait-CesmHKZ2.js';
1
+ 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-j7OsANcy.js';
2
+ 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-j7OsANcy.js';
3
+ import { a as EntityPersistence, E as EntityField } from '../effect-DOqkIe2M.js';
4
+ import { a as TraitReference } from '../trait-C6Jqfflp.js';
5
5
  export { J as JsonValue } from '../expression-Fk8bQWef.js';
6
6
  import 'zod';
7
7
 
@@ -1,6 +1,6 @@
1
- import { O as OrbitalSchema, a as OrbitalDefinition } from '../schema-KdqDOMXm.js';
2
- import { h as CallSiteConfig, i as CallSiteConfigEntry, g as Trait } from '../trait-CesmHKZ2.js';
3
- import { E as EntityField, a as EntityPersistence } from '../effect-CgDrWfKW.js';
1
+ import { O as OrbitalSchema, a as OrbitalDefinition } from '../schema-B648ulAY.js';
2
+ import { h as CallSiteConfig, i as CallSiteConfigEntry, g as Trait } from '../trait-C6Jqfflp.js';
3
+ import { E as EntityField, a as EntityPersistence } from '../effect-DOqkIe2M.js';
4
4
  import { MakeTraitRefOpts } from '../builders.js';
5
5
  import '../expression-Fk8bQWef.js';
6
6
  import 'zod';