@plures/design-dojo 0.2.0

package/dist/motion/spring.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Spring physics engine for Svelte animations.
+ *
+ * Based on damped harmonic oscillator:
+ *   F = -kx - cv
+ *   where k = stiffness, c = damping, x = displacement, v = velocity
+ *
+ * This is what makes UI feel physical instead of robotic.
+ */
+export interface SpringConfig {
+    /** Restoring force strength. Higher = snappier. Default: 300 */
+    stiffness: number;
+    /** Resistance to motion. Higher = less bouncy. Default: 24 */
+    damping: number;
+    /** Inertia. Higher = heavier feel. Default: 1 */
+    mass: number;
+    /** Velocity threshold to consider "at rest". Default: 0.01 */
+    restThreshold: number;
+}
+export declare const SPRING_PRESETS: {
+    /** Gentle hover, focus ring expansion */
+    readonly gentle: {
+        readonly stiffness: 120;
+        readonly damping: 14;
+        readonly mass: 1;
+        readonly restThreshold: 0.01;
+    };
+    /** Button press, toggle switch */
+    readonly snappy: {
+        readonly stiffness: 300;
+        readonly damping: 24;
+        readonly mass: 1;
+        readonly restThreshold: 0.01;
+    };
+    /** Playful bounce, notification pop */
+    readonly bouncy: {
+        readonly stiffness: 400;
+        readonly damping: 10;
+        readonly mass: 1;
+        readonly restThreshold: 0.01;
+    };
+    /** Modal open, panel slide */
+    readonly heavy: {
+        readonly stiffness: 200;
+        readonly damping: 30;
+        readonly mass: 1.5;
+        readonly restThreshold: 0.01;
+    };
+    /** Tooltip, popover */
+    readonly quick: {
+        readonly stiffness: 500;
+        readonly damping: 30;
+        readonly mass: 0.5;
+        readonly restThreshold: 0.01;
+    };
+};
+export type SpringPreset = keyof typeof SPRING_PRESETS;
+interface SpringState {
+    value: number;
+    velocity: number;
+    target: number;
+    done: boolean;
+}
+/**
+ * Simulate one frame of spring physics.
+ * @param dt Time delta in seconds
+ */
+export declare function springStep(state: SpringState, config: SpringConfig, dt: number): SpringState;
+/**
+ * Create a spring animation that calls `onUpdate` each frame.
+ * Returns a controller to change target or stop.
+ */
+export declare function createSpring(initial: number, config: (SpringConfig | SpringPreset) | undefined, onUpdate: (value: number) => void): {
+    /** Set a new target value. Animation starts automatically. */
+    set(target: number): void;
+    /** Jump to value immediately (no animation). */
+    jump(value: number): void;
+    /** Add velocity impulse (e.g., from a flick gesture). */
+    impulse(velocity: number): void;
+    /** Stop animation. */
+    stop(): void;
+    /** Get current value. */
+    readonly value: number;
+    /** Whether the spring has settled. */
+    readonly done: boolean;
+};
+export {};

package/dist/primitives/Button.svelte.d.ts

@@ -0,0 +1 @@
+export { SvelteComponent as default } from 'svelte';

package/dist/primitives/SearchInput.svelte.d.ts

@@ -0,0 +1 @@
+export { SvelteComponent as default } from 'svelte';

package/dist/primitives/Toggle.svelte.d.ts

@@ -0,0 +1 @@
+export { SvelteComponent as default } from 'svelte';

package/dist/primitives/search-input-types.d.ts

@@ -0,0 +1,7 @@
+/** Shared type definitions for SearchInput. */
+export interface SearchResult {
+    text: string;
+    score: number;
+    id?: string;
+    meta?: Record<string, unknown>;
+}

package/dist/surfaces/ChatPane.svelte.d.ts

@@ -0,0 +1 @@
+export { SvelteComponent as default } from 'svelte';

package/dist/surfaces/ChatPane.types.d.ts

@@ -0,0 +1,8 @@
+/** Message shape for the ChatPane component. */
+export interface ChatMessage {
+    id: string;
+    author: string;
+    content: string;
+    timestamp: Date;
+    type?: "user" | "agent" | "system";
+}

package/dist/surfaces/GlassPanel.svelte.d.ts

@@ -0,0 +1 @@
+export { SvelteComponent as default } from 'svelte';

package/dist/useTui.d.ts

@@ -0,0 +1,25 @@
+/**
+ * useTui — Shared composable for propagating `tui` mode through a component tree.
+ *
+ * Usage (parent component):
+ *   import { provideTui } from '../useTui.js';
+ *   let { tui = false } = $props();
+ *   provideTui(() => tui);
+ *
+ * Usage (child component):
+ *   import { useTui } from '../useTui.js';
+ *   const getTui = useTui();
+ *   // Access reactively: getTui()  or  const isTui = $derived(getTui());
+ */
+/**
+ * Provide TUI mode to all descendant components.
+ * Pass a reactive getter (e.g. `() => tui`) so children receive updates.
+ * Call at component initialization (not inside $effect).
+ */
+export declare function provideTui(getTui: () => boolean): void;
+/**
+ * Consume TUI mode from the nearest ancestor that called `provideTui`.
+ * Falls back to `() => false` when no ancestor provides context.
+ * Call at component initialization (not inside $effect).
+ */
+export declare function useTui(): () => boolean;

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@plures/design-dojo",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./tokens.css": "./dist/tokens.css",
+    "./tui-tokens.css": "./dist/tui-tokens.css"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "preview": "vite preview",
+    "check": "svelte-check --tsconfig ./tsconfig.json",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build"
+  },
+  "peerDependencies": {
+    "svelte": "^5.0.0"
+  },
+  "devDependencies": {
+    "@storybook/addon-essentials": "^8.5.0",
+    "@storybook/addon-svelte-csf": "^5.0.0",
+    "@storybook/svelte": "^8.5.0",
+    "@storybook/sveltekit": "^8.5.0",
+    "@sveltejs/vite-plugin-svelte": "^5.0.0",
+    "@tsconfig/svelte": "^5.0.0",
+    "storybook": "^8.5.0",
+    "svelte": "^5.0.0",
+    "svelte-check": "^4.0.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0",
+    "vite-plugin-dts": "^4.5.4"
+  }
+}