@weasel-js/forge 1.5.0

package/dist/frame/index.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/frame/frame.css"],"sourcesContent":["html,\nbody {\n  margin: 0;\n}\n\n.fg-frame {\n  box-sizing: border-box;\n}\n\n.fg-frame--centered {\n  display: flex;\n  align-items: center;\n  justify-content: center;\n  min-height: 100vh;\n}\n\n.fg-frame--padded {\n  padding: 16px;\n}\n\n.fg-frame--fullscreen {\n  padding: 0;\n}\n\n.fg-frame__fault {\n  margin: 0;\n  padding: 16px;\n  white-space: pre-wrap;\n  border: 1px solid #f2b8b5;\n  border-radius: 4px;\n  background: #fdecea;\n  color: #8c1d18;\n  font: 13px/1.4 ui-monospace, SFMono-Regular, Menlo, monospace;\n}\n"],"mappings":";AAAA;AACA;AACE,UAAQ;AACV;AAEA,CAAC;AACC,cAAY;AACd;AAEA,CAAC;AACC,WAAS;AACT,eAAa;AACb,mBAAiB;AACjB,cAAY;AACd;AAEA,CAAC;AACC,WAAS;AACX;AAEA,CAAC;AACC,WAAS;AACX;AAEA,CAAC;AACC,UAAQ;AACR,WAAS;AACT,eAAa;AACb,UAAQ,IAAI,MAAM;AAClB,iBAAe;AACf,cAAY;AACZ,SAAO;AACP;AAAA,IAAM,IAAI,CAAC,IAAI,YAAY;AAAA,IAAE,cAAc;AAAA,IAAE,KAAK;AAAA,IAAE;AACtD;","names":[]}

package/dist/frame/index.d.ts

@@ -0,0 +1,24 @@
+import { F as FrameSetup, L as LoadedStory } from '../FrameController-Ba3LaWfq.js';
+export { b as StartFrameOptions, r as reportImportFault, s as startFrame } from '../FrameController-Ba3LaWfq.js';
+import '@weasel-js/labkit/config';
+import 'react';
+
+interface FrameImporters {
+    [file: string]: () => Promise<Record<string, unknown>>;
+}
+interface FrameIndexEntry {
+    id: string;
+    file: string;
+    exportName: string;
+}
+interface MountFrameOptions {
+    index: readonly FrameIndexEntry[];
+    importers: FrameImporters;
+    root: string;
+    setup?: FrameSetup;
+    load?: (mod: Record<string, unknown>, file: string, root: string, parameters?: Record<string, unknown>) => LoadedStory[];
+}
+/** The frame document's entry: takes the shell's port, loads the story named by the hash, and starts it. */
+declare function mountFrame(options: MountFrameOptions): Promise<void>;
+
+export { type FrameImporters, type FrameIndexEntry, FrameSetup, type MountFrameOptions, mountFrame };

package/dist/frame/index.js

@@ -0,0 +1,8 @@
+export { mountFrame, reportImportFault, startFrame } from '../chunk-KKF7ZX5E.js';
+import '../chunk-2GXKNXTJ.js';
+import '../chunk-UZCXH724.js';
+import '../chunk-O5OQZQRZ.js';
+import '../chunk-KKVTFMWV.js';
+import '../chunk-IOBG7GZQ.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/frame/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { f } from '@weasel-js/labkit/config';
+export { G as GlobalDeclaration, a as GlobalDeclarations, S as ShellConfig, d as defineFrameConfig, b as defineShellConfig } from './config-DdumOfyd.js';
+import { M as MetaSpec, S as StorySpec } from './FrameController-Ba3LaWfq.js';
+export { D as Decorator, F as FrameSetup, L as LoadedStory, P as PlayContext, a as StoryContext } from './FrameController-Ba3LaWfq.js';
+import '@weasel-js/labkit';
+import 'react';
+
+declare function meta(spec: MetaSpec): MetaSpec;
+declare function story<C = Record<string, never>, S = undefined>(spec: StorySpec<C, S>): StorySpec<C, S>;
+
+export { MetaSpec, StorySpec, meta, story };

package/dist/index.js

@@ -0,0 +1,14 @@
+export { meta, story } from './chunk-2GXKNXTJ.js';
+export { f } from '@weasel-js/labkit/config';
+
+// src/config.ts
+function defineFrameConfig(config) {
+  return config;
+}
+function defineShellConfig(config) {
+  return config;
+}
+
+export { defineFrameConfig, defineShellConfig };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"names":[],"mappings":";;;;AAcO,SAAS,kBAAkB,MAAA,EAAgC;AAChE,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,kBAAkB,MAAA,EAAkC;AAClE,EAAA,OAAO,MAAA;AACT","file":"index.js","sourcesContent":["import type { LabContribution } from '@weasel-js/labkit';\nimport type { ControlRenderer } from '@weasel-js/labkit/config';\nimport type { FrameSetup } from './frame/FrameController';\nimport type { GlobalDeclarations } from './shell/globals';\n\n/** A shell config module: what the workshop adds to the lab. Only the workshop page imports it. */\nexport interface ShellConfig {\n  labChrome?: readonly LabContribution[];\n  controls?: Record<string, ControlRenderer>;\n  /** Globals the lab's header sets for every story, each pinnable per trial. Frames apply them with `applyGlobals`. */\n  globals?: GlobalDeclarations;\n}\n\n/** A frame config module's default export. Only frame documents import it, so its CSS stays out of the workshop. */\nexport function defineFrameConfig(config: FrameSetup): FrameSetup {\n  return config;\n}\n\n/** A shell config module's default export. */\nexport function defineShellConfig(config: ShellConfig): ShellConfig {\n  return config;\n}\n"]}

package/dist/shell/index.css

@@ -0,0 +1,198 @@
+/* src/shell/shell.css */
+.fg-empty {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: var(--wzl-space-xs);
+  min-height: 100vh;
+  padding-inline: var(--wzl-space-md);
+  background: var(--wzl-surface-sunken);
+  color: var(--wzl-fg);
+}
+.fg-empty__title {
+  margin: 0;
+  font-weight: var(--wzl-font-weight-bold);
+}
+.fg-empty__globs {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  font-family: var(--wzl-font-mono);
+  font-size: var(--wzl-font-size-sm);
+}
+.fg-frame-host {
+  position: relative;
+  width: 100%;
+  height: 100%;
+}
+.fg-frame-view {
+  display: block;
+  width: 100%;
+  height: 100%;
+  border: 0;
+}
+.fg-fault {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  flex-direction: column;
+  gap: var(--wzl-space-xs);
+  padding: var(--wzl-space-md);
+  overflow: auto;
+  background: var(--wzl-surface-sunken);
+  color: var(--wzl-fg);
+  font-family: var(--wzl-font-mono);
+  font-size: var(--wzl-font-size-sm);
+}
+.fg-fault__phase {
+  color: var(--wzl-danger);
+  font-weight: var(--wzl-font-weight-bold);
+  text-transform: uppercase;
+}
+.fg-fault__message {
+  margin: 0;
+  white-space: pre-wrap;
+}
+.fg-tree {
+  display: flex;
+  flex-direction: column;
+  gap: var(--wzl-space-xs);
+  padding: 0 var(--wzl-space-xs) var(--wzl-space-xs);
+  border-bottom: var(--wzl-border-w) solid var(--wzl-line-subtle);
+  color: var(--wzl-fg);
+}
+.fg-tree__heading {
+  margin: 0;
+  padding-block: var(--wzl-space-xs);
+  color: var(--wzl-fg-muted);
+  font-family: var(--wzl-font-display);
+  font-size: var(--wzl-font-size-sm);
+  font-weight: var(--wzl-font-weight-normal);
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+.fg-route-miss {
+  margin: 0;
+  color: var(--wzl-danger);
+  font-size: var(--wzl-font-size-sm);
+}
+.fg-tree__filter {
+  box-sizing: border-box;
+  width: 100%;
+}
+.fg-tree__items,
+.fg-tree__group {
+  display: flex;
+  flex-direction: column;
+}
+.fg-tree__items {
+  font-size: var(--wzl-font-size-sm);
+}
+.fg-tree__group {
+  padding-inline-start: var(--wzl-space-sm);
+}
+.fg-tree__node {
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+  outline: none;
+}
+.fg-tree__item {
+  display: flex;
+  align-items: center;
+  gap: var(--wzl-space-xs);
+  padding: calc(var(--wzl-space-xs) / 2) var(--wzl-space-xs);
+  border-radius: var(--wzl-radius-sm);
+  overflow: hidden;
+  color: inherit;
+  text-decoration: none;
+  white-space: nowrap;
+  cursor: pointer;
+}
+.fg-tree__label {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.fg-tree__item:hover {
+  background: var(--wzl-surface-hover);
+}
+.fg-tree__story:focus-visible,
+.fg-tree__node:focus-visible > .fg-tree__folder {
+  outline: var(--wzl-line-width) solid var(--wzl-accent);
+  outline-offset: calc(-1 * var(--wzl-line-width));
+}
+.fg-tree__item[aria-current=true] {
+  color: var(--wzl-accent);
+}
+.fg-tree__folder::before {
+  content: "";
+  flex: none;
+  width: 0.35em;
+  height: 0.35em;
+  border: solid currentColor;
+  border-width: 0 1.5px 1.5px 0;
+  transform: rotate(-45deg);
+}
+.fg-tree__node[aria-expanded=true] > .fg-tree__folder::before {
+  transform: rotate(45deg);
+}
+.fg-tree__story {
+  padding-inline-start: calc(var(--wzl-space-xs) * 2 + 0.35em);
+}
+.lk-trial.fg-flash {
+  outline: var(--wzl-line-width) solid var(--wzl-accent);
+  outline-offset: calc(-1 * var(--wzl-line-width));
+  animation: fg-flash 600ms ease-out forwards;
+}
+@keyframes fg-flash {
+  from {
+    outline-color: var(--wzl-accent);
+  }
+  to {
+    outline-color: transparent;
+  }
+}
+@media (prefers-reduced-motion: reduce) {
+  .lk-trial.fg-flash {
+    animation: none;
+  }
+}
+.fg-css-vars {
+  display: flex;
+  flex-direction: column;
+  gap: var(--wzl-space-xs);
+}
+.fg-css-vars__list {
+  display: flex;
+  flex-direction: column;
+  gap: var(--wzl-space-xs);
+  max-height: 60vh;
+  overflow: auto;
+}
+.fg-css-vars__empty {
+  margin: 0;
+  color: var(--wzl-fg-muted);
+  font-size: var(--wzl-font-size-sm);
+}
+.fg-css-var {
+  display: flex;
+  align-items: flex-end;
+  gap: var(--wzl-space-xs);
+  font-family: var(--wzl-font-mono);
+}
+.fg-css-var__rows {
+  flex: 1;
+  min-width: 0;
+}
+.fg-globals {
+  display: flex;
+  align-items: center;
+  gap: var(--wzl-space-xs);
+}
+.fg-globals__select {
+  font-size: var(--wzl-font-size-sm);
+}
+/*# sourceMappingURL=index.css.map */

package/dist/shell/index.css.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shell/shell.css"],"sourcesContent":[".fg-empty {\n  display: flex;\n  flex-direction: column;\n  align-items: center;\n  justify-content: center;\n  gap: var(--wzl-space-xs);\n  min-height: 100vh;\n  padding-inline: var(--wzl-space-md);\n  background: var(--wzl-surface-sunken);\n  color: var(--wzl-fg);\n}\n\n.fg-empty__title {\n  margin: 0;\n  font-weight: var(--wzl-font-weight-bold);\n}\n\n.fg-empty__globs {\n  margin: 0;\n  padding: 0;\n  list-style: none;\n  font-family: var(--wzl-font-mono);\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-frame-host {\n  position: relative;\n  width: 100%;\n  height: 100%;\n}\n\n.fg-frame-view {\n  display: block;\n  width: 100%;\n  height: 100%;\n  border: 0;\n}\n\n.fg-fault {\n  position: absolute;\n  inset: 0;\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n  padding: var(--wzl-space-md);\n  overflow: auto;\n  background: var(--wzl-surface-sunken);\n  color: var(--wzl-fg);\n  font-family: var(--wzl-font-mono);\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-fault__phase {\n  color: var(--wzl-danger);\n  font-weight: var(--wzl-font-weight-bold);\n  text-transform: uppercase;\n}\n\n.fg-fault__message {\n  margin: 0;\n  white-space: pre-wrap;\n}\n\n.fg-tree {\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n  padding: 0 var(--wzl-space-xs) var(--wzl-space-xs);\n  border-bottom: var(--wzl-border-w) solid var(--wzl-line-subtle);\n  color: var(--wzl-fg);\n}\n\n.fg-tree__heading {\n  margin: 0;\n  padding-block: var(--wzl-space-xs);\n  color: var(--wzl-fg-muted);\n  font-family: var(--wzl-font-display);\n  font-size: var(--wzl-font-size-sm);\n  font-weight: var(--wzl-font-weight-normal);\n  letter-spacing: 0.08em;\n  text-transform: uppercase;\n}\n\n.fg-route-miss {\n  margin: 0;\n  color: var(--wzl-danger);\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-tree__filter {\n  box-sizing: border-box;\n  width: 100%;\n}\n\n.fg-tree__items,\n.fg-tree__group {\n  display: flex;\n  flex-direction: column;\n}\n\n.fg-tree__items {\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-tree__group {\n  padding-inline-start: var(--wzl-space-sm);\n}\n\n.fg-tree__node {\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  outline: none;\n}\n\n.fg-tree__item {\n  display: flex;\n  align-items: center;\n  gap: var(--wzl-space-xs);\n  padding: calc(var(--wzl-space-xs) / 2) var(--wzl-space-xs);\n  border-radius: var(--wzl-radius-sm);\n  overflow: hidden;\n  color: inherit;\n  text-decoration: none;\n  white-space: nowrap;\n  cursor: pointer;\n}\n\n/* text-overflow does not reach a flex container's anonymous text box, so the label clips itself. */\n.fg-tree__label {\n  min-width: 0;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  white-space: nowrap;\n}\n\n.fg-tree__item:hover {\n  background: var(--wzl-surface-hover);\n}\n\n/* A folder item holds its group, so its ring goes on its own row rather than around the subtree. */\n.fg-tree__story:focus-visible,\n.fg-tree__node:focus-visible > .fg-tree__folder {\n  outline: var(--wzl-line-width) solid var(--wzl-accent);\n  outline-offset: calc(-1 * var(--wzl-line-width));\n}\n\n.fg-tree__item[aria-current='true'] {\n  color: var(--wzl-accent);\n}\n\n/* Drawn with borders rather than a glyph, which would join the item's accessible name. */\n.fg-tree__folder::before {\n  content: '';\n  flex: none;\n  width: 0.35em;\n  height: 0.35em;\n  border: solid currentColor;\n  border-width: 0 1.5px 1.5px 0;\n  transform: rotate(-45deg);\n}\n\n.fg-tree__node[aria-expanded='true'] > .fg-tree__folder::before {\n  transform: rotate(45deg);\n}\n\n.fg-tree__story {\n  padding-inline-start: calc(var(--wzl-space-xs) * 2 + 0.35em);\n}\n\n.lk-trial.fg-flash {\n  outline: var(--wzl-line-width) solid var(--wzl-accent);\n  outline-offset: calc(-1 * var(--wzl-line-width));\n  animation: fg-flash 600ms ease-out forwards;\n}\n\n@keyframes fg-flash {\n  from {\n    outline-color: var(--wzl-accent);\n  }\n  to {\n    outline-color: transparent;\n  }\n}\n\n@media (prefers-reduced-motion: reduce) {\n  .lk-trial.fg-flash {\n    animation: none;\n  }\n}\n\n.fg-css-vars {\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n}\n\n.fg-css-vars__list {\n  display: flex;\n  flex-direction: column;\n  gap: var(--wzl-space-xs);\n  max-height: 60vh;\n  overflow: auto;\n}\n\n.fg-css-vars__empty {\n  margin: 0;\n  color: var(--wzl-fg-muted);\n  font-size: var(--wzl-font-size-sm);\n}\n\n.fg-css-var {\n  display: flex;\n  align-items: flex-end;\n  gap: var(--wzl-space-xs);\n  font-family: var(--wzl-font-mono);\n}\n\n.fg-css-var__rows {\n  flex: 1;\n  min-width: 0;\n}\n\n.fg-globals {\n  display: flex;\n  align-items: center;\n  gap: var(--wzl-space-xs);\n}\n\n.fg-globals__select {\n  font-size: var(--wzl-font-size-sm);\n}\n"],"mappings":"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","names":[]}

package/dist/shell/index.d.ts

@@ -0,0 +1,51 @@
+import { I as IndexEntry, c as FromFrame } from '../FrameController-Ba3LaWfq.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { StorageAdapter, InstrumentList } from '@weasel-js/labkit';
+import { S as ShellConfig, a as GlobalDeclarations } from '../config-DdumOfyd.js';
+import * as react from 'react';
+import '@weasel-js/labkit/config';
+
+interface WorkshopProps {
+    index: readonly IndexEntry[];
+    frameUrl: string;
+    config?: ShellConfig;
+    /** The story globs the index was built from, named when it is empty. */
+    stories?: readonly string[];
+    storageKey?: string;
+    storage?: StorageAdapter;
+}
+declare function Workshop({ index, frameUrl, config, stories, storageKey, storage }: WorkshopProps): react_jsx_runtime.JSX.Element;
+
+interface MountWorkshopOptions extends WorkshopProps {
+    /** Default: the document's `#root`. */
+    container?: HTMLElement;
+}
+interface MountedWorkshop {
+    /** Swaps in a re-indexed story list, as the vite plugin's `forge:index` event carries. */
+    setIndex(index: readonly IndexEntry[]): void;
+    unmount(): void;
+}
+declare function mountWorkshop({ container, ...props }: MountWorkshopOptions): MountedWorkshop;
+
+/** The lab's global values, which a trial's pins override. A change reaches open frames without replacing instruments. */
+declare const StoryGlobalsContext: react.Context<Readonly<Record<string, unknown>>>;
+
+type Ready = Extract<FromFrame, {
+    type: 'ready';
+}>;
+
+interface StoryRegistry {
+    instruments: InstrumentList;
+    /** Called by FrameView. Replaces the story's instrument only when `ready.schema`, layout or viewport differ from what it holds. */
+    onReady: (entry: IndexEntry, ready: Ready) => void;
+}
+/**
+ * One instrument per story in `index`, each schema holding a `$globals` group for `globals`. The lab's global values
+ * reach the frames through `StoryGlobalsContext`, not through here.
+ */
+declare function useStoryRegistry(index: readonly IndexEntry[], options: {
+    frameUrl: string;
+    globals?: GlobalDeclarations;
+}): StoryRegistry;
+
+export { type MountWorkshopOptions, type MountedWorkshop, StoryGlobalsContext, type StoryRegistry, Workshop, type WorkshopProps, mountWorkshop, useStoryRegistry };