@almadar/std 3.1.1 → 3.1.3

package/dist/exports/atoms/std-async.orb

@@ -416,5 +416,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Async operation behavior: idle, loading, success, error. Covers fetch, submit, retry, and polling patterns in one molecule. Pure function: params in, OrbitalDefinition out."
 }

package/dist/exports/atoms/std-browse.orb

@@ -169,5 +169,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Data grid browsing atom. Renders a list of entities with configurable item actions. The browsing view that molecules compose with modal/confirmation atoms."
 }

package/dist/exports/atoms/std-cache-aside.orb

@@ -877,5 +877,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Cache management behavior: empty, cached, stale with fetch/invalidate cycle. Pure function: params in, OrbitalDefinition out."
 }

package/dist/exports/atoms/std-circuit-breaker.orb

@@ -497,5 +497,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Circuit breaker pattern behavior: closed, open, halfOpen. Protects services from cascading failures with automatic recovery. Pure function: params in, OrbitalDefinition out."
 }

package/dist/exports/atoms/std-collision.orb

@@ -612,5 +612,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Game collision detection parameterized for any domain. Provides idle and detecting states for checking collisions between game entities. Tracks collision targets via entity fields. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/exports/atoms/std-combat-log.orb

@@ -141,5 +141,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Scrollable combat event log atom using the `combat-log` pattern. Displays timestamped combat events with icons and colors. Supports appending new events and clearing the log."
 }

package/dist/exports/atoms/std-combat.orb

@@ -406,5 +406,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Attack cycle behavior: ready, attacking, cooldown, defeated. Pure function: params in, OrbitalDefinition out."
 }

package/dist/exports/atoms/std-confirmation.orb

@@ -278,5 +278,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Confirmation dialog behavior parameterized for any domain. Provides a two-step confirm/cancel flow before performing destructive actions. The caller handles the actual action via emits/listens. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/exports/atoms/std-dialogue-box.orb

@@ -234,5 +234,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "RPG dialogue atom using the `dialogue-box` pattern. Shows speaker, portrait, typewriter text, and choices."
 }

package/dist/exports/atoms/std-display.orb

@@ -838,5 +838,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Read-only display molecule with loading/refresh. Single trait (display is self-contained, no modal atoms needed). Used for dashboards, stats panels, KPIs."
 }

package/dist/exports/atoms/std-drawer.orb

@@ -312,5 +312,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Drawer behavior parameterized for any domain. Provides a slide-out drawer that displays entity detail. Two states: closed and open, with transitions to toggle visibility. Similar to std-modal but renders to a \"drawer\" slot concept."
 }

package/dist/exports/atoms/std-filter.orb

@@ -438,5 +438,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Filter atom. Shows filter buttons per field with predefined values. Clicking a filter value transitions to filtered state. Clear resets."
 }

package/dist/exports/atoms/std-game-audio.orb

@@ -109,5 +109,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Game audio provider atom using the `game-audio-provider` pattern. Wraps child content with an audio context, providing sound playback and mute toggling."
 }

package/dist/exports/atoms/std-game-hud.orb

@@ -147,5 +147,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Heads-up display atom. Renders the `game-hud` pattern showing health, score, lives, and other stats."
 }

package/dist/exports/atoms/std-game-menu.orb

@@ -207,5 +207,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Game main menu atom using the `game-menu` pattern. Shows title, subtitle, and menu options (Start, Options, Credits, etc.)."
 }

package/dist/exports/atoms/std-game-over-screen.orb

@@ -191,5 +191,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Game over screen atom using the `game-over-screen` pattern. Shows final score, high score, and retry/quit actions."
 }

package/dist/exports/atoms/std-gameflow.orb

@@ -314,5 +314,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Game state management behavior: menu, playing, paused, gameover. Uses game UI patterns per state:   menu     -> game-menu (title, subtitle, Start Game button)   playing  -> game-hud (score, level stats)   paused   -> game-menu in modal (Resume, Quit buttons)   gameover -> game-over-screen (score, Play Again, Main Menu) Pure function: params in, OrbitalDefinition out."
 }

package/dist/exports/atoms/std-input.orb

@@ -625,5 +625,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Input state management parameterized for any domain. Provides idle, focused, and validating states with change tracking. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/exports/atoms/std-inventory-panel.orb

@@ -251,5 +251,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Grid-based inventory atom using the `inventory-panel` pattern. Shows items in a grid with select, use, and drop actions."
 }

package/dist/exports/atoms/std-isometric-canvas.orb

@@ -627,5 +627,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Isometric game renderer atom using the `isometric-canvas` pattern. Renders tiles, units, and features on an isometric grid. Handles tile clicks, unit clicks, and hover events."
 }

package/dist/exports/atoms/std-loading.orb

@@ -507,5 +507,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Loading behavior parameterized for any domain. Provides a multi-state loading lifecycle: idle, loading, success, error. Tracks async operation status with appropriate UI for each state."
 }

package/dist/exports/atoms/std-modal.orb

@@ -266,5 +266,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Modal overlay atom. Accepts content injection so molecules can control what renders inside the open state."
 }

package/dist/exports/atoms/std-movement.orb

@@ -1033,5 +1033,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Entity movement behavior: idle, moving, collision detection and resolution. Pure function: params in, OrbitalDefinition out."
 }

package/dist/exports/atoms/std-notification.orb

@@ -414,5 +414,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Notification behavior parameterized for any domain. Provides a show/hide notification display. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/exports/atoms/std-overworld.orb

@@ -479,5 +479,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Map/zone navigation behavior: exploring, transitioning, entered. Pure function: params in, OrbitalDefinition out."
 }

package/dist/exports/atoms/std-pagination.orb

@@ -327,5 +327,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Pagination behavior parameterized for any domain. Provides page/pageSize controls that paginate entity data. Single idle state with a self-loop that re-renders with the new page applied."
 }

package/dist/exports/atoms/std-physics2d.orb

@@ -415,5 +415,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "2D physics simulation parameterized for any domain. Provides idle and simulating states with force application and tick updates. Tracks position and velocity via entity fields. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/exports/atoms/std-platformer-canvas.orb

@@ -253,5 +253,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Side-scrolling platformer atom using the `platformer-canvas` pattern. Renders player, platforms, and handles movement events."
 }

package/dist/exports/atoms/std-quest.orb

@@ -976,5 +976,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Quest/objective tracking behavior: available, active, complete, failed. Pure function: params in, OrbitalDefinition out."
 }

package/dist/exports/atoms/std-rate-limiter.orb

@@ -634,5 +634,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Rate limiting parameterized for any domain. Provides open and throttled states for controlling request frequency. Tracks request count and throttle status via entity fields. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/exports/atoms/std-score-board.orb

@@ -234,5 +234,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Score display atom using the `score-board` pattern. Shows score, high score, combo, multiplier, level."
 }

package/dist/exports/atoms/std-score.orb

@@ -462,5 +462,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Score tracking parameterized for any domain. Provides a single-state machine with self-loops for adding, subtracting, resetting, and applying combo multipliers to a score. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/exports/atoms/std-search.orb

@@ -369,5 +369,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Search behavior parameterized for any domain. Provides a search input that filters entity data by query string. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/exports/atoms/std-selection.orb

@@ -755,5 +755,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Selection behavior parameterized for any domain. Provides item selection from a list with confirm/deselect controls. Three states: idle, selecting, selected with transitions for the full lifecycle."
 }

package/dist/exports/atoms/std-simulation-canvas.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "2D physics simulation renderer atom using the `simulation-canvas` pattern. Runs built-in Euler integration for educational presets (pendulum, spring, etc.). Supports start, stop, and reset controls."
 }

package/dist/exports/atoms/std-sort.orb

@@ -574,5 +574,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Sort atom. Shows sort-by buttons for each sortable field. Clicking a field name sorts by that field. Clicking again toggles direction."
 }

package/dist/exports/atoms/std-sprite.orb

@@ -152,5 +152,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Sprite renderer atom using the `sprite` pattern. Renders a single frame from a spritesheet with position and scale. Handles frame changes and click events."
 }

package/dist/exports/atoms/std-tabs.orb

@@ -270,5 +270,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Tab navigation atom. Uses the `tabs` pattern component with clickable tab headers. Each tab shows different entity data."
 }

package/dist/exports/atoms/std-timer.orb

@@ -1026,5 +1026,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Timer behavior parameterized for any domain. Provides a countdown timer with start, pause, resume, and reset controls. The state machine structure is fixed. The caller controls data and presentation."
 }

package/dist/exports/atoms/std-undo.orb

@@ -690,5 +690,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Undo/Redo atom using array operators as a stack. - PUSH: appends to undoStack, clears redoStack - UNDO: pops from undoStack, pushes to redoStack - REDO: pops from redoStack, pushes to undoStack - CLEAR: empties both stacks Entity fields: undoStack (array), redoStack (array), current (string)"
 }

package/dist/exports/atoms/std-wizard.orb

@@ -662,5 +662,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Multi-step wizard behavior parameterized for any domain. Generates a dynamic number of steps based on the `steps` parameter, with a review screen and completion view. Pure function: params in, OrbitalDefinition out."
 }

package/dist/exports/molecules/std-builder-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `builder-board` pattern for the playing state."
 }

package/dist/exports/molecules/std-cart.orb

@@ -587,5 +587,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Shopping cart molecule. Composes atoms: - Cart-specific browse trait (empty/hasItems/checkout states) - stdModal for the add-item form (responds to ADD_ITEM)"
 }

package/dist/exports/molecules/std-classifier-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `classifier-board` pattern for the playing state."
 }

package/dist/exports/molecules/std-debugger-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `debugger-board` pattern for the playing state."
 }

package/dist/exports/molecules/std-detail.orb

@@ -585,5 +585,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Browse + Create + View molecule. Composes atoms: - stdBrowse: data-grid with View item action and Create header action - stdModal: create form (responds to CREATE) - stdModal: view detail (responds to VIEW) No edit/delete from list. Used for feeds, ledgers, galleries."
 }

package/dist/exports/molecules/std-event-handler-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `event-handler-board` pattern for the playing state."
 }

package/dist/exports/molecules/std-geospatial.orb

@@ -645,5 +645,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Location selection molecule. Composes atoms via shared event bus: - stdBrowse: location list with \"Select\" item action (fires SELECT) - stdModal: select/view location detail (responds to SELECT) - stdConfirmation: confirm location selection (responds to CONFIRM_SELECT) No emits/listens wiring. Traits on the same page share the event bus. Only the trait with a matching transition from its current state responds."
 }

package/dist/exports/molecules/std-inventory.orb

@@ -849,5 +849,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Item collection molecule. Composes atoms via shared event bus: - stdBrowse: data-grid with item actions (fires ADD_ITEM, USE_ITEM, DROP) - stdModal (add): create form for adding items (responds to ADD_ITEM) - stdModal (use): item detail for using items (responds to USE_ITEM) - stdConfirmation: drop confirmation (responds to DROP) No emits/listens wiring. Traits on the same page share the event bus. Only the trait with a matching transition from its current state responds."
 }

package/dist/exports/molecules/std-list.orb

@@ -5,7 +5,8 @@
       "name": "ItemOrbital",
       "entity": {
         "name": "Item",
-        "persistence": "runtime",
+        "persistence": "persistent",
+        "collection": "items",
         "fields": [
           {
             "name": "id",
@@ -950,5 +951,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "CRUD list molecule. Composes atoms via shared event bus: - stdBrowse: data-grid with item actions (fires CREATE, VIEW, EDIT, DELETE) - stdModal (x3): create form, edit form, detail view (responds to matching events) - stdConfirmation: delete confirmation (responds to DELETE) No emits/listens wiring. Traits on the same page share the event bus. Only the trait with a matching transition from its current state responds."
 }

package/dist/exports/molecules/std-messaging.orb

@@ -581,5 +581,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Messaging molecule. Composes atoms via shared event bus: - stdBrowse: message list with \"Compose\" header action, \"View\" item action - stdModal (compose): compose/send message form (COMPOSE -> SEND) - stdModal (view): view message detail (VIEW with id payload) No emits/listens wiring. Traits on the same page share the event bus. Only the trait with a matching transition from its current state responds."
 }

package/dist/exports/molecules/std-negotiator-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `negotiator-board` pattern for the playing state."
 }

package/dist/exports/molecules/std-platformer-game.orb

@@ -492,5 +492,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Side-scrolling platformer game molecule. Composes game atoms into a two-trait orbital: 1. PlatformerFlow trait (primary): menu -> playing -> paused -> gameover    Renders game-menu, platformer-canvas, game-over-screen per state. 2. PlatformerCanvas trait (secondary): extracted from stdPlatformerCanvas,    INIT render-ui removed (standalone: false pattern) so the flow trait    owns the main render slot."
 }

package/dist/exports/molecules/std-puzzle-game.orb

@@ -523,5 +523,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Puzzle game molecule. Composes game atoms into a two-trait orbital: 1. PuzzleFlow trait (primary): menu -> playing -> paused -> gameover    Renders game-menu, game-canvas-2d with score-board, game-over-screen. 2. PuzzleScore trait (secondary): extracted from stdScoreBoard,    INIT render-ui removed (standalone: false pattern) so the flow trait    owns the main render slot."
 }

package/dist/exports/molecules/std-sequencer-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `sequencer-board` pattern for the playing state."
 }

package/dist/exports/molecules/std-simulator-game.orb

@@ -179,5 +179,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Educational game molecule: menu -> playing -> complete. Uses the `simulator-board` pattern for the playing state."
 }

package/dist/exports/molecules/std-turn-based-battle.orb

@@ -439,5 +439,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Turn-based strategy game molecule (Fire Emblem, XCOM style). Composes game atoms into a two-trait orbital: 1. BattleFlow trait (primary): menu -> playing -> paused -> gameover    Renders game-menu, game-hud + combat-log, game-over-screen per state. 2. BattleLog trait (secondary): idle state, combat-log pattern.    Only renders when LOG_EVENT fires from the shared event bus. Composition pattern: extractTrait from atom orbitals, assemble into one orbital with one shared entity and one page."
 }

package/dist/exports/organisms/std-api-gateway.orb

@@ -2292,5 +2292,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "API gateway management organism. Composes: stdList(Route) + stdCircuitBreaker(Backend) + stdDisplay(Analytics) Pages: /routes (initial), /backends, /analytics"
 }

package/dist/exports/organisms/std-arcade-game.orb

@@ -829,5 +829,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Arcade game organism. Composes: stdGameflow(ArcadeState) + stdGameCanvas2d(ArcadeCanvas)         + stdScoreBoard(ArcadeScore) + stdGameHud(ArcadeHud) Pages: /game (initial), /scores"
 }

package/dist/exports/organisms/std-booking-system.orb

@@ -3973,5 +3973,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Booking system organism. Composes molecules via compose: - stdList(Provider): provider directory with CRUD - stdWizard(Booking): booking wizard - stdList(Appointment): appointment list with CRUD - stdDisplay(Schedule): schedule overview dashboard Cross-orbital connections: - BOOK: ProviderBrowse -> BookingWizard - CONFIRM: BookingWizard -> AppointmentBrowse"
 }

package/dist/exports/organisms/std-cicd-pipeline.orb

@@ -2210,5 +2210,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "CI/CD pipeline organism. Composes: stdList(Build) + stdDisplay(Stage) + stdAsync(Deployment) Pages: /builds (initial), /stages, /deploy"
 }

package/dist/exports/organisms/std-cms.orb

@@ -2640,5 +2640,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Content management organism. Composes molecules via compose: - stdList(Article): article management with CRUD - stdDetail(MediaAsset): media library browse + view - stdList(Category): category management Cross-orbital connections: - PUBLISH: ArticleBrowse -> MediaAssetBrowse - CATEGORIZE: ArticleBrowse -> CategoryBrowse"
 }

package/dist/exports/organisms/std-coding-academy.orb

@@ -1390,5 +1390,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Coding academy organism. Composes: stdSequencerGame(SeqChallenge) + stdBuilderGame(BuildChallenge)         + stdEventHandlerGame(EventChallenge) + stdDisplay(StudentProgress) Pages: /sequencer (initial), /builder, /events, /progress"
 }

package/dist/exports/organisms/std-crm.orb

@@ -3537,5 +3537,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Customer relationship management organism. Composes molecules via compose: - stdList(Contact): CRUD list of contacts - stdList(Deal): CRUD list of deals - stdDisplay(Pipeline): read-only pipeline dashboard - stdMessaging(Note): notes/communication thread Pages: /contacts (initial), /deals, /pipeline, /notes Connections: CONVERT_LEAD (contacts->deals), CLOSE_DEAL (deals->pipeline)"
 }

package/dist/exports/organisms/std-devops-dashboard.orb

@@ -3130,5 +3130,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "DevOps monitoring organism. Composes: stdCircuitBreaker(ServiceNode) + stdDisplay(AlertMetric)         + stdList(LogEntry) + stdDisplay(SystemMetric) Pages: /services (initial), /alerts, /logs, /metrics"
 }

package/dist/exports/organisms/std-ecommerce.orb

@@ -3739,5 +3739,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "E-commerce organism. Composes molecules via compose: - stdList(Product): product catalog with CRUD - stdCart(CartItem): shopping cart with add/remove - stdWizard(Checkout): checkout wizard - stdList(OrderRecord): order history Cross-orbital connections: - ADD_TO_CART: ProductBrowse -> CartItemCartBrowse - CHECKOUT_STARTED: CartItemCartBrowse -> CheckoutWizard - ORDER_PLACED: CheckoutWizard -> OrderRecordBrowse"
 }

package/dist/exports/organisms/std-finance-tracker.orb

@@ -2381,5 +2381,6 @@
         }
       ]
     }
-  ]
+  ],
+  "description": "Finance tracker organism. Composes: stdList(Transaction) + stdDisplay(FinanceSummary) + stdDetail(FinanceReport) Pages: /transactions (initial), /summary, /reports"
 }