@weasel-js/labkit 0.7.2 → 1.0.0

package/dist/index.d.ts

@@ -7,8 +7,8 @@ export { C as CanvasCapability, a as CanvasLayer, D as DragDropCapability, b as
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { S as StorageAdapter, W as WorkspaceRecord, e as SavedSnapshot } from './_dts/useExperimentState-eSvpwV_P.js';
-export { C as CreateLabStoreOptions, E as ExperimentStateHandle, b as LabStoreContext, c as LabStoreProvider, d as LabStoreState, U as UndoStack, f as WorkspaceIdContext, g as WorkspaceIdProvider, i as createMemoryAdapter, l as localStorageAdapter, n as noneAdapter, s as sessionStorageAdapter, u as urlHashAdapter, j as useExperimentState, k as useLabStore, m as useWorkspaceId } from './_dts/useExperimentState-eSvpwV_P.js';
+import { S as StorageAdapter, o as LabMode, W as WorkspaceRecord, e as SavedSnapshot } from './_dts/useExperimentState-CJn2hHzd.js';
+export { C as CreateLabStoreOptions, E as ExperimentStateHandle, b as LabStoreContext, c as LabStoreProvider, d as LabStoreState, U as UndoStack, f as WorkspaceIdContext, g as WorkspaceIdProvider, i as createMemoryAdapter, l as localStorageAdapter, n as noneAdapter, s as sessionStorageAdapter, u as urlHashAdapter, j as useExperimentState, k as useLabStore, m as useWorkspaceId } from './_dts/useExperimentState-CJn2hHzd.js';
 export { LayerList, LayerListProps } from './layers/index.js';
 export { FpsMeter, ScaleIndicator, ScaleIndicatorProps, Sidebar, SidebarProps, StatusBar, StatusBarProps, Toolbar, ToolbarProps } from './primitives/index.js';
 export { LayerStack, LayerStackItem, LayerStackProps } from './ui/layers/index.js';
@@ -42,18 +42,18 @@ interface LabProps {
     defaultInstrument: string;
     storage?: StorageAdapter | null;
     storageKey?: string;
-    theme?: 'auto' | 'light' | 'interstellar';
+    mode?: LabMode;
     /**
      * Optional list of CSS colors used to compose the interstellar theme's
      * cosmic backdrop. Each color becomes one radial-gradient blob on the
      * dark void base. Order maps to a fixed spread of positions; extras wrap
-     * around. Ignored unless `theme="interstellar"` is active.
+     * around. Ignored unless the resolved mode is dark.
      */
     nebula?: readonly string[];
     title?: string;
     children?: ReactNode;
 }
-declare function Lab({ instruments, defaultInstrument, storage, storageKey, theme, nebula, title, children, }: LabProps): react_jsx_runtime.JSX.Element;
+declare function Lab({ instruments, defaultInstrument, storage, storageKey, mode, nebula, title, children, }: LabProps): react_jsx_runtime.JSX.Element;
 
 interface LabContextValue {
     instruments: Instrument[];
@@ -66,13 +66,12 @@ interface LabContextValue {
     saveSnapshot: (workspaceId: string, name?: string) => void;
     loadSnapshot: (workspaceId: string, snapshotId: string) => void;
     deleteSnapshot: (snapshotId: string) => void;
-    theme: 'auto' | 'light' | 'interstellar';
-    setTheme: (t: 'auto' | 'light' | 'interstellar') => void;
+    mode: LabMode;
+    setMode: (m: LabMode) => void;
 }
 declare const LabContext: react.Context<LabContextValue | null>;
 declare function useLabContext(): LabContextValue;
 
-type LabTheme = 'auto' | 'light' | 'interstellar';
 interface LabShellProps {
     title: string;
     children: ReactNode;
@@ -80,16 +79,41 @@ interface LabShellProps {
     header?: ReactNode;
     /** Optional content rendered into the footer. */
     footer?: ReactNode;
-    /** Theme override. "auto" (default) follows prefers-color-scheme. */
-    theme?: LabTheme;
+    /** Color mode. "auto" (default) follows prefers-color-scheme. */
+    mode?: LabMode;
 }
-declare function LabShell({ title, children, header, footer, theme }: LabShellProps): react_jsx_runtime.JSX.Element;
+declare function LabShell({ title, children, header, footer, mode }: LabShellProps): react_jsx_runtime.JSX.Element;
 
 interface WorkspaceGridProps {
     children: ReactNode;
 }
 declare function WorkspaceGrid({ children }: WorkspaceGridProps): react_jsx_runtime.JSX.Element;
 
+type TokenValue = string | number | readonly (string | number)[];
+interface RawToken {
+    readonly type: string;
+    readonly value: TokenValue;
+    /** Render the referenced color at this alpha, 0–1. */
+    readonly alpha?: number | undefined;
+    readonly description?: string | undefined;
+}
+type FlatTokens = Record<string, RawToken>;
+
+interface Theme {
+    readonly name: string;
+    readonly extends: Theme | null;
+    readonly defaultMode: string;
+    readonly tokens: FlatTokens;
+    readonly modes: Readonly<Record<string, FlatTokens>>;
+}
+
+/**
+ * labkit's theme: a cosmic dark and a warm parchment light, extending the
+ * built-in weasel theme. Authored as DTCG and loaded at import time — the
+ * interchange path a theme exported from a design tool would take.
+ */
+declare const interstellarTheme: Theme;
+
 type CurveMark = {
     kind: 'band';
     x: [number, number];
@@ -406,5 +430,5 @@ declare function cloneWorkspace(workspaces: WorkspaceRecord[], id: string): Work
 declare function closeWorkspace(workspaces: WorkspaceRecord[], id: string): WorkspaceRecord[];
 declare function resetWorkspace(workspaces: WorkspaceRecord[], id: string, instruments: Instrument[]): WorkspaceRecord[];
 
-export { CheckboxRow, ColorRow, ConfigField, CurveField, DefaultSidebar, DefaultStatusBar, DefaultToolbar, EffectCard, EffectCardList, Instrument, Lab, LabContext, LabShell, NumberRow, PropertyGroup, PropertyList, PropertyPanel, PropertyRow, SavedSnapshot, SelectRow, SliderRow, StorageAdapter, Subpanel, TextRow, ToggleRow, Workspace, WorkspaceChrome, WorkspaceGrid, WorkspaceRecord, addWorkspace, cloneWorkspace, closeWorkspace, defineInstrument, detectCapabilities, gridDims, resetWorkspace, useLabContext, validateConfigSchema };
-export type { CapabilityFlags, CheckboxRowProps, ColorRowProps, CurveFieldProps, CurveMark, DefaultSidebarProps, DefaultStatusBarProps, DefaultToolbarProps, EffectCardListItem, EffectCardListProps, EffectCardProps, GridDims, LabContextValue, LabProps, LabShellProps, LabTheme, NumberRowProps, PropertyGroupProps, PropertyListPack, PropertyListProps, PropertyPanelProps, PropertyRowLayout, PropertyRowProps, PropertyRowVariant, SelectRowProps, SidebarSlot, SliderRowProps, StatusBarSlot, SubpanelProps, TextRowProps, ToggleRowProps, ToolbarSlot, ValidationResult, WorkspaceChromeProps, WorkspaceGridProps, WorkspaceProps, WorkspaceSidebarContext, WorkspaceStatusBarContext, WorkspaceToolbarContext };
+export { CheckboxRow, ColorRow, ConfigField, CurveField, DefaultSidebar, DefaultStatusBar, DefaultToolbar, EffectCard, EffectCardList, Instrument, Lab, LabContext, LabMode, LabShell, NumberRow, PropertyGroup, PropertyList, PropertyPanel, PropertyRow, SavedSnapshot, SelectRow, SliderRow, StorageAdapter, Subpanel, TextRow, ToggleRow, Workspace, WorkspaceChrome, WorkspaceGrid, WorkspaceRecord, addWorkspace, cloneWorkspace, closeWorkspace, defineInstrument, detectCapabilities, gridDims, interstellarTheme, resetWorkspace, useLabContext, validateConfigSchema };
+export type { CapabilityFlags, CheckboxRowProps, ColorRowProps, CurveFieldProps, CurveMark, DefaultSidebarProps, DefaultStatusBarProps, DefaultToolbarProps, EffectCardListItem, EffectCardListProps, EffectCardProps, GridDims, LabContextValue, LabProps, LabShellProps, NumberRowProps, PropertyGroupProps, PropertyListPack, PropertyListProps, PropertyPanelProps, PropertyRowLayout, PropertyRowProps, PropertyRowVariant, SelectRowProps, SidebarSlot, SliderRowProps, StatusBarSlot, SubpanelProps, TextRowProps, ToggleRowProps, ToolbarSlot, ValidationResult, WorkspaceChromeProps, WorkspaceGridProps, WorkspaceProps, WorkspaceSidebarContext, WorkspaceStatusBarContext, WorkspaceToolbarContext };