@almadar/std 2.1.1 → 2.4.1

package/dist/behaviors/types.d.ts

@@ -1,4 +1,4 @@
-import { TraitCategory, Trait, SExpr } from '@almadar/core/types';
+import { TraitCategory, Trait, SExpr, Effect } from '@almadar/core/types';
 export { Effect, Entity, Event, Expression, Guard, Orbital, OrbitalSchema, State, StateMachine, Trait, TraitCategory, TraitDataEntity, TraitEntityField, TraitTick, Transition } from '@almadar/core/types';
 
 /**
@@ -10,6 +10,23 @@ export { Effect, Entity, Event, Expression, Guard, Orbital, OrbitalSchema, State
  * @packageDocumentation
  */
 
+/**
+ * Behavior schemas use raw UI tree objects in render-ui effects (e.g. { type: 'stack', ... })
+ * rather than strict AnyPatternConfig. Schema correctness is validated by `orbital validate`.
+ */
+type BehaviorEffect = Effect | ['render-ui', string, Record<string, unknown>] | ['render-ui', string, Record<string, unknown>, Record<string, unknown>] | ['render-ui', string, null];
+/**
+ * Behavior schemas may include a `theme` property and use raw UI trees in effects.
+ * This type provides basic shape checking while deferring strict validation to `orbital validate`.
+ */
+interface BehaviorSchema {
+    name: string;
+    description?: string;
+    theme?: Record<string, unknown>;
+    entities?: Record<string, unknown>[];
+    orbitals?: Record<string, unknown>[];
+    [key: string]: unknown;
+}
 /**
  * @deprecated Use OrbitalSchema directly. BehaviorTrait is kept for backward compatibility.
  */
@@ -52,4 +69,4 @@ declare function validateBehaviorEvents(behavior: BehaviorTrait): string[];
  */
 declare function validateBehaviorStates(behavior: BehaviorTrait): string[];
 
-export { type BehaviorMetadata, type BehaviorTrait, type ItemAction, getBehaviorMetadata, validateBehaviorEvents, validateBehaviorStates, validateBehaviorStructure };
+export { type BehaviorEffect, type BehaviorMetadata, type BehaviorSchema, type BehaviorTrait, type ItemAction, getBehaviorMetadata, validateBehaviorEvents, validateBehaviorStates, validateBehaviorStructure };

package/dist/behaviors/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../behaviors/types.ts"],"names":[],"mappings":"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","file":"types.js","sourcesContent":["/**\n * Standard Behaviors Types\n *\n * Standard Behaviors are reusable OrbitalSchema definitions with a `std-` naming convention.\n * Each behavior is a self-contained .orb file that can function independently.\n *\n * @packageDocumentation\n */\n\nimport type {\n  SExpr,\n  RequiredField,\n  Effect,\n  Expression,\n  Trait,\n  TraitCategory,\n  StateMachine,\n  State,\n  Event,\n  Transition,\n  Guard,\n  TraitTick,\n  TraitDataEntity,\n  TraitEntityField,\n  TraitEventListener,\n  OrbitalSchema,\n  Orbital,\n  Entity,\n} from '@almadar/core/types';\n\n// Re-export core types for use in behaviors\nexport type {\n  Effect,\n  Expression,\n  Trait,\n  StateMachine,\n  State,\n  Event,\n  Transition,\n  Guard,\n  TraitTick,\n  TraitDataEntity,\n  TraitEntityField,\n  TraitCategory,\n  OrbitalSchema,\n  Orbital,\n  Entity,\n};\n\n// ============================================================================\n// Legacy Type Aliases (for backward compatibility only)\n// ============================================================================\n\n/**\n * @deprecated Use OrbitalSchema directly. BehaviorTrait is kept for backward compatibility.\n */\nexport type BehaviorTrait = Trait;\n\n// ============================================================================\n// Item Action (for render_ui props)\n// ============================================================================\n\nexport interface ItemAction {\n  label: string;\n  event?: string;\n  navigatesTo?: string;\n  placement?: 'row' | 'bulk' | 'card' | 'footer' | 'header';\n  variant?: 'primary' | 'secondary' | 'ghost' | 'danger';\n  showWhen?: SExpr | string;\n}\n\n// ============================================================================\n// Behavior Metadata (for quick lookup and documentation)\n// ============================================================================\n\n/**\n * Behavior metadata extracted from a Trait for documentation purposes\n */\nexport interface BehaviorMetadata {\n  name: string;\n  category?: TraitCategory;\n  description: string;\n  states: string[];\n  events: string[];\n  tickCount: number;\n  transitionCount: number;\n  hasDataEntities: boolean;\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Extract metadata from a BehaviorTrait for documentation\n */\nexport function getBehaviorMetadata(behavior: BehaviorTrait): BehaviorMetadata {\n  const sm = behavior.stateMachine;\n\n  // Core types: State is always an object with name\n  const states: string[] = (sm?.states || []).map(s => s.name);\n\n  // Core types: Event is always an object with key\n  const events: string[] = (sm?.events || []).map(e => e.key);\n\n  return {\n    name: behavior.name,\n    category: behavior.category,\n    description: behavior.description || '',\n    states,\n    events,\n    tickCount: behavior.ticks?.length || 0,\n    transitionCount: sm?.transitions?.length || 0,\n    hasDataEntities: (behavior.dataEntities?.length || 0) > 0,\n  };\n}\n\n/**\n * Validate behavior structure\n */\nexport function validateBehaviorStructure(behavior: BehaviorTrait): string[] {\n  const errors: string[] = [];\n\n  if (!behavior.name) {\n    errors.push('Behavior must have a name');\n  }\n\n  if (!behavior.name.startsWith('std/')) {\n    errors.push(`Behavior name should start with 'std/' (got: ${behavior.name})`);\n  }\n\n  const sm = behavior.stateMachine;\n  if (sm) {\n    if (!sm.states || sm.states.length === 0) {\n      errors.push('State machine must have at least one state');\n    }\n\n    // Core types: check initial state using isInitial flag on State\n    const hasInitialState = sm.states?.some(s => s.isInitial);\n    if (!hasInitialState) {\n      errors.push('State machine must have an initial state (set isInitial: true on one state)');\n    }\n  }\n\n  return errors;\n}\n\n/**\n * Validate behavior events match transitions\n */\nexport function validateBehaviorEvents(behavior: BehaviorTrait): string[] {\n  const errors: string[] = [];\n  const sm = behavior.stateMachine;\n  if (!sm) return errors;\n\n  // Core types: Event is always an object with key\n  const declaredEvents = new Set(\n    (sm.events || []).map(e => e.key)\n  );\n\n  const transitionEvents = new Set(\n    (sm.transitions || []).map(t => t.event)\n  );\n\n  for (const event of transitionEvents) {\n    if (event && !declaredEvents.has(event)) {\n      errors.push(`Transition uses undeclared event: ${event}`);\n    }\n  }\n\n  return errors;\n}\n\n/**\n * Validate behavior states match transitions\n */\nexport function validateBehaviorStates(behavior: BehaviorTrait): string[] {\n  const errors: string[] = [];\n  const sm = behavior.stateMachine;\n  if (!sm) return errors;\n\n  // Core types: State is always an object with name\n  const declaredStates = new Set(\n    (sm.states || []).map(s => s.name)\n  );\n\n  for (const t of sm.transitions || []) {\n    // Core types: from and to are both strings\n    if (t.from && !declaredStates.has(t.from)) {\n      errors.push(`Transition from undeclared state: ${t.from}`);\n    }\n\n    if (t.to && !declaredStates.has(t.to)) {\n      errors.push(`Transition to undeclared state: ${t.to}`);\n    }\n  }\n\n  return errors;\n}\n"]}
+{"version":3,"sources":["../../behaviors/types.ts"],"names":[],"mappings":";AAuHO,SAAS,oBAAoB,QAAA,EAA2C;AAC7E,EAAA,MAAM,KAAK,QAAA,CAAS,YAAA;AAGpB,EAAA,MAAM,MAAA,GAAA,CAAoB,IAAI,MAAA,IAAU,IAAI,GAAA,CAAI,CAAA,CAAA,KAAK,EAAE,IAAI,CAAA;AAG3D,EAAA,MAAM,MAAA,GAAA,CAAoB,IAAI,MAAA,IAAU,IAAI,GAAA,CAAI,CAAA,CAAA,KAAK,EAAE,GAAG,CAAA;AAE1D,EAAA,OAAO;AAAA,IACL,MAAM,QAAA,CAAS,IAAA;AAAA,IACf,UAAU,QAAA,CAAS,QAAA;AAAA,IACnB,WAAA,EAAa,SAAS,WAAA,IAAe,EAAA;AAAA,IACrC,MAAA;AAAA,IACA,MAAA;AAAA,IACA,SAAA,EAAW,QAAA,CAAS,KAAA,EAAO,MAAA,IAAU,CAAA;AAAA,IACrC,eAAA,EAAiB,EAAA,EAAI,WAAA,EAAa,MAAA,IAAU,CAAA;AAAA,IAC5C,eAAA,EAAA,CAAkB,QAAA,CAAS,YAAA,EAAc,MAAA,IAAU,CAAA,IAAK;AAAA,GAC1D;AACF;AAKO,SAAS,0BAA0B,QAAA,EAAmC;AAC3E,EAAA,MAAM,SAAmB,EAAC;AAE1B,EAAA,IAAI,CAAC,SAAS,IAAA,EAAM;AAClB,IAAA,MAAA,CAAO,KAAK,2BAA2B,CAAA;AAAA,EACzC;AAEA,EAAA,IAAI,CAAC,QAAA,CAAS,IAAA,CAAK,UAAA,CAAW,MAAM,CAAA,EAAG;AACrC,IAAA,MAAA,CAAO,IAAA,CAAK,CAAA,6CAAA,EAAgD,QAAA,CAAS,IAAI,CAAA,CAAA,CAAG,CAAA;AAAA,EAC9E;AAEA,EAAA,MAAM,KAAK,QAAA,CAAS,YAAA;AACpB,EAAA,IAAI,EAAA,EAAI;AACN,IAAA,IAAI,CAAC,EAAA,CAAG,MAAA,IAAU,EAAA,CAAG,MAAA,CAAO,WAAW,CAAA,EAAG;AACxC,MAAA,MAAA,CAAO,KAAK,4CAA4C,CAAA;AAAA,IAC1D;AAGA,IAAA,MAAM,kBAAkB,EAAA,CAAG,MAAA,EAAQ,IAAA,CAAK,CAAA,CAAA,KAAK,EAAE,SAAS,CAAA;AACxD,IAAA,IAAI,CAAC,eAAA,EAAiB;AACpB,MAAA,MAAA,CAAO,KAAK,6EAA6E,CAAA;AAAA,IAC3F;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;AAKO,SAAS,uBAAuB,QAAA,EAAmC;AACxE,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,MAAM,KAAK,QAAA,CAAS,YAAA;AACpB,EAAA,IAAI,CAAC,IAAI,OAAO,MAAA;AAGhB,EAAA,MAAM,iBAAiB,IAAI,GAAA;AAAA,IAAA,CACxB,GAAG,MAAA,IAAU,IAAI,GAAA,CAAI,CAAA,CAAA,KAAK,EAAE,GAAG;AAAA,GAClC;AAEA,EAAA,MAAM,mBAAmB,IAAI,GAAA;AAAA,IAAA,CAC1B,GAAG,WAAA,IAAe,IAAI,GAAA,CAAI,CAAA,CAAA,KAAK,EAAE,KAAK;AAAA,GACzC;AAEA,EAAA,KAAA,MAAW,SAAS,gBAAA,EAAkB;AACpC,IAAA,IAAI,KAAA,IAAS,CAAC,cAAA,CAAe,GAAA,CAAI,KAAK,CAAA,EAAG;AACvC,MAAA,MAAA,CAAO,IAAA,CAAK,CAAA,kCAAA,EAAqC,KAAK,CAAA,CAAE,CAAA;AAAA,IAC1D;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;AAKO,SAAS,uBAAuB,QAAA,EAAmC;AACxE,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,MAAM,KAAK,QAAA,CAAS,YAAA;AACpB,EAAA,IAAI,CAAC,IAAI,OAAO,MAAA;AAGhB,EAAA,MAAM,iBAAiB,IAAI,GAAA;AAAA,IAAA,CACxB,GAAG,MAAA,IAAU,IAAI,GAAA,CAAI,CAAA,CAAA,KAAK,EAAE,IAAI;AAAA,GACnC;AAEA,EAAA,KAAA,MAAW,CAAA,IAAK,EAAA,CAAG,WAAA,IAAe,EAAC,EAAG;AAEpC,IAAA,IAAI,EAAE,IAAA,IAAQ,CAAC,eAAe,GAAA,CAAI,CAAA,CAAE,IAAI,CAAA,EAAG;AACzC,MAAA,MAAA,CAAO,IAAA,CAAK,CAAA,kCAAA,EAAqC,CAAA,CAAE,IAAI,CAAA,CAAE,CAAA;AAAA,IAC3D;AAEA,IAAA,IAAI,EAAE,EAAA,IAAM,CAAC,eAAe,GAAA,CAAI,CAAA,CAAE,EAAE,CAAA,EAAG;AACrC,MAAA,MAAA,CAAO,IAAA,CAAK,CAAA,gCAAA,EAAmC,CAAA,CAAE,EAAE,CAAA,CAAE,CAAA;AAAA,IACvD;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT","file":"types.js","sourcesContent":["/**\n * Standard Behaviors Types\n *\n * Standard Behaviors are reusable OrbitalSchema definitions with a `std-` naming convention.\n * Each behavior is a self-contained .orb file that can function independently.\n *\n * @packageDocumentation\n */\n\nimport type {\n  SExpr,\n  RequiredField,\n  Effect,\n  Expression,\n  Trait,\n  TraitCategory,\n  StateMachine,\n  State,\n  Event,\n  Transition,\n  Guard,\n  TraitTick,\n  TraitDataEntity,\n  TraitEntityField,\n  TraitEventListener,\n  OrbitalSchema,\n  Orbital,\n  Entity,\n} from '@almadar/core/types';\n\n// Re-export core types for use in behaviors\nexport type {\n  Effect,\n  Expression,\n  Trait,\n  StateMachine,\n  State,\n  Event,\n  Transition,\n  Guard,\n  TraitTick,\n  TraitDataEntity,\n  TraitEntityField,\n  TraitCategory,\n  OrbitalSchema,\n  Orbital,\n  Entity,\n};\n\n// ============================================================================\n// Behavior-local types (permissive wrappers for schema authoring)\n// ============================================================================\n\n/**\n * Behavior schemas use raw UI tree objects in render-ui effects (e.g. { type: 'stack', ... })\n * rather than strict AnyPatternConfig. Schema correctness is validated by `orbital validate`.\n */\nexport type BehaviorEffect = Effect | ['render-ui', string, Record<string, unknown>] | ['render-ui', string, Record<string, unknown>, Record<string, unknown>] | ['render-ui', string, null];\n\n/**\n * Behavior schemas may include a `theme` property and use raw UI trees in effects.\n * This type provides basic shape checking while deferring strict validation to `orbital validate`.\n */\nexport interface BehaviorSchema {\n  name: string;\n  description?: string;\n  theme?: Record<string, unknown>;\n  entities?: Record<string, unknown>[];\n  orbitals?: Record<string, unknown>[];\n  [key: string]: unknown;\n}\n\n// ============================================================================\n// Legacy Type Aliases (for backward compatibility only)\n// ============================================================================\n\n/**\n * @deprecated Use OrbitalSchema directly. BehaviorTrait is kept for backward compatibility.\n */\nexport type BehaviorTrait = Trait;\n\n// ============================================================================\n// Item Action (for render_ui props)\n// ============================================================================\n\nexport interface ItemAction {\n  label: string;\n  event?: string;\n  navigatesTo?: string;\n  placement?: 'row' | 'bulk' | 'card' | 'footer' | 'header';\n  variant?: 'primary' | 'secondary' | 'ghost' | 'danger';\n  showWhen?: SExpr | string;\n}\n\n// ============================================================================\n// Behavior Metadata (for quick lookup and documentation)\n// ============================================================================\n\n/**\n * Behavior metadata extracted from a Trait for documentation purposes\n */\nexport interface BehaviorMetadata {\n  name: string;\n  category?: TraitCategory;\n  description: string;\n  states: string[];\n  events: string[];\n  tickCount: number;\n  transitionCount: number;\n  hasDataEntities: boolean;\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Extract metadata from a BehaviorTrait for documentation\n */\nexport function getBehaviorMetadata(behavior: BehaviorTrait): BehaviorMetadata {\n  const sm = behavior.stateMachine;\n\n  // Core types: State is always an object with name\n  const states: string[] = (sm?.states || []).map(s => s.name);\n\n  // Core types: Event is always an object with key\n  const events: string[] = (sm?.events || []).map(e => e.key);\n\n  return {\n    name: behavior.name,\n    category: behavior.category,\n    description: behavior.description || '',\n    states,\n    events,\n    tickCount: behavior.ticks?.length || 0,\n    transitionCount: sm?.transitions?.length || 0,\n    hasDataEntities: (behavior.dataEntities?.length || 0) > 0,\n  };\n}\n\n/**\n * Validate behavior structure\n */\nexport function validateBehaviorStructure(behavior: BehaviorTrait): string[] {\n  const errors: string[] = [];\n\n  if (!behavior.name) {\n    errors.push('Behavior must have a name');\n  }\n\n  if (!behavior.name.startsWith('std/')) {\n    errors.push(`Behavior name should start with 'std/' (got: ${behavior.name})`);\n  }\n\n  const sm = behavior.stateMachine;\n  if (sm) {\n    if (!sm.states || sm.states.length === 0) {\n      errors.push('State machine must have at least one state');\n    }\n\n    // Core types: check initial state using isInitial flag on State\n    const hasInitialState = sm.states?.some(s => s.isInitial);\n    if (!hasInitialState) {\n      errors.push('State machine must have an initial state (set isInitial: true on one state)');\n    }\n  }\n\n  return errors;\n}\n\n/**\n * Validate behavior events match transitions\n */\nexport function validateBehaviorEvents(behavior: BehaviorTrait): string[] {\n  const errors: string[] = [];\n  const sm = behavior.stateMachine;\n  if (!sm) return errors;\n\n  // Core types: Event is always an object with key\n  const declaredEvents = new Set(\n    (sm.events || []).map(e => e.key)\n  );\n\n  const transitionEvents = new Set(\n    (sm.transitions || []).map(t => t.event)\n  );\n\n  for (const event of transitionEvents) {\n    if (event && !declaredEvents.has(event)) {\n      errors.push(`Transition uses undeclared event: ${event}`);\n    }\n  }\n\n  return errors;\n}\n\n/**\n * Validate behavior states match transitions\n */\nexport function validateBehaviorStates(behavior: BehaviorTrait): string[] {\n  const errors: string[] = [];\n  const sm = behavior.stateMachine;\n  if (!sm) return errors;\n\n  // Core types: State is always an object with name\n  const declaredStates = new Set(\n    (sm.states || []).map(s => s.name)\n  );\n\n  for (const t of sm.transitions || []) {\n    // Core types: from and to are both strings\n    if (t.from && !declaredStates.has(t.from)) {\n      errors.push(`Transition from undeclared state: ${t.from}`);\n    }\n\n    if (t.to && !declaredStates.has(t.to)) {\n      errors.push(`Transition to undeclared state: ${t.to}`);\n    }\n  }\n\n  return errors;\n}\n"]}

package/dist/behaviors/ui-interaction.d.ts

@@ -1,10 +1,16 @@
-import { OrbitalSchema } from '@almadar/core/types';
+import { BehaviorSchema } from './types.js';
+import '@almadar/core/types';
 
 /**
  * UI Interaction Behaviors
  *
  * Standard behaviors for common UI interaction patterns.
- * Each behavior is a self-contained OrbitalSchema that can function as a standalone .orb file.
+ * Each behavior is a self-contained OrbitalSchema that passes orbital validate
+ * with 0 errors and 0 warnings when exported as a standalone .orb file.
+ *
+ * Uses molecule-first UI composition: stack, typography, icon, button, badge,
+ * divider, data-grid, data-list, search-input, meter, stats, form-section,
+ * progress-bar, wizard-progress, tabs.
  *
  * @packageDocumentation
  */
@@ -12,18 +18,18 @@ import { OrbitalSchema } from '@almadar/core/types';
 /**
  * std-list - The core behavior for displaying and interacting with entity collections.
  *
- * States: Browsing → Creating/Viewing/Editing/Deleting
- * Implements complete CRUD operations with modal/drawer UI patterns.
+ * States: browsing -> creating/viewing/editing/deleting
+ * Implements complete CRUD operations with modal UI.
  */
-declare const LIST_BEHAVIOR: OrbitalSchema;
-declare const DETAIL_BEHAVIOR: OrbitalSchema;
-declare const FORM_BEHAVIOR: OrbitalSchema;
-declare const MODAL_BEHAVIOR: OrbitalSchema;
-declare const DRAWER_BEHAVIOR: OrbitalSchema;
-declare const TABS_BEHAVIOR: OrbitalSchema;
-declare const WIZARD_BEHAVIOR: OrbitalSchema;
-declare const MASTER_DETAIL_BEHAVIOR: OrbitalSchema;
-declare const FILTER_BEHAVIOR: OrbitalSchema;
-declare const UI_INTERACTION_BEHAVIORS: OrbitalSchema[];
+declare const LIST_BEHAVIOR: BehaviorSchema;
+declare const DETAIL_BEHAVIOR: BehaviorSchema;
+declare const FORM_BEHAVIOR: BehaviorSchema;
+declare const MODAL_BEHAVIOR: BehaviorSchema;
+declare const DRAWER_BEHAVIOR: BehaviorSchema;
+declare const TABS_BEHAVIOR: BehaviorSchema;
+declare const WIZARD_BEHAVIOR: BehaviorSchema;
+declare const MASTER_DETAIL_BEHAVIOR: BehaviorSchema;
+declare const FILTER_BEHAVIOR: BehaviorSchema;
+declare const UI_INTERACTION_BEHAVIORS: BehaviorSchema[];
 
 export { DETAIL_BEHAVIOR, DRAWER_BEHAVIOR, FILTER_BEHAVIOR, FORM_BEHAVIOR, LIST_BEHAVIOR, MASTER_DETAIL_BEHAVIOR, MODAL_BEHAVIOR, TABS_BEHAVIOR, UI_INTERACTION_BEHAVIORS, WIZARD_BEHAVIOR };