@stephen-netu/design-system 0.2.1 → 0.5.1

package/dist/spatial/d3-types.d.ts

@@ -0,0 +1,31 @@
+import type { ForceCell, ForceLink } from './force-canvas-types';
+export interface D3SimulationNode {
+    id: string;
+    index?: number;
+    x?: number;
+    y?: number;
+    vx?: number;
+    vy?: number;
+    fx?: number | null;
+    fy?: number | null;
+}
+export interface D3ForceLink<T extends D3SimulationNode = D3SimulationNode> {
+    source: T | string;
+    target: T | string;
+    distance?: number;
+}
+export interface D3Simulation<T extends D3SimulationNode = D3SimulationNode> {
+    force(name: string): unknown;
+    force(name: string, force: unknown): this;
+    nodes(): T[];
+    nodes(nodes: T[]): this;
+    alphaDecay(): number;
+    alphaDecay(decay: number): this;
+    velocityDecay(): number;
+    velocityDecay(decay: number): this;
+    on(event: string, listener: (() => void) | null): this;
+    stop(): void;
+}
+export declare function toD3Node(cell: ForceCell): D3SimulationNode;
+export declare function toD3Link(link: ForceLink): D3ForceLink;
+//# sourceMappingURL=d3-types.d.ts.map

package/dist/spatial/d3-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"d3-types.d.ts","sourceRoot":"","sources":["../../src/spatial/d3-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IACxE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC;IACnB,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IACzE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1C,KAAK,IAAI,CAAC,EAAE,CAAC;IACb,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;IACxB,UAAU,IAAI,MAAM,CAAC;IACrB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,IAAI,MAAM,CAAC;IACxB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IACvD,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,gBAAgB,CAW1D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,CAMrD"}

package/dist/spatial/d3-types.js

@@ -0,0 +1,19 @@
+export function toD3Node(cell) {
+    return {
+        id: cell.id,
+        index: cell.index,
+        x: cell.x,
+        y: cell.y,
+        vx: cell.vx,
+        vy: cell.vy,
+        fx: cell.fx,
+        fy: cell.fy,
+    };
+}
+export function toD3Link(link) {
+    return {
+        source: link.source,
+        target: link.target,
+        distance: link.distance,
+    };
+}

package/dist/spatial/index.js

@@ -15,3 +15,4 @@ export { CameraController } from './CameraController.svelte.js';
 //   import LodRenderer from '@kos/design-system/spatial/LodRenderer.svelte';
 //   import SnapZoomCamera from '@kos/design-system/spatial/SnapZoomCamera.svelte';
 //   import BspTilingCanvas from '@kos/design-system/spatial/BspTilingCanvas.svelte';
+//   import ParticleAssembleMark from '@kos/design-system/spatial/ParticleAssembleMark.svelte';

package/dist/spatial/particle-assemble-math.d.ts

@@ -0,0 +1,22 @@
+export interface Fit {
+    scale: number;
+    dx: number;
+    dy: number;
+}
+/** Fit a viewBoxWidth x viewBoxHeight shape, centered, into canvasWidth x canvasHeight. */
+export declare function fitScale(viewBoxWidth: number, viewBoxHeight: number, canvasWidth: number, canvasHeight: number, padRatio?: number): Fit;
+export declare function easeOutCubic(progress: number): number;
+export declare function lerp(a: number, b: number, t: number): number;
+export interface ParticleFrame {
+    x: number;
+    y: number;
+    alpha: number;
+}
+/** Position + alpha for a particle at a given eased progress (0..1). */
+export declare function particleFrame(particle: {
+    x: number;
+    y: number;
+    tx: number;
+    ty: number;
+}, eased: number): ParticleFrame;
+//# sourceMappingURL=particle-assemble-math.d.ts.map

package/dist/spatial/particle-assemble-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle-assemble-math.d.ts","sourceRoot":"","sources":["../../src/spatial/particle-assemble-math.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,2FAA2F;AAC3F,wBAAgB,QAAQ,CACtB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,QAAQ,SAAO,GACd,GAAG,CAKL;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAC3B,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAC1D,KAAK,EAAE,MAAM,GACZ,aAAa,CAMf"}

package/dist/spatial/particle-assemble-math.js

@@ -0,0 +1,26 @@
+// Pure math for ParticleAssembleMark — kept separate from the .svelte
+// RAF/canvas runner so it's unit-testable without a real canvas 2D context
+// (mirrors this dir's split between *-types.ts/simulation logic and the
+// thin canvas-runner .svelte components, e.g. ForceSimulation vs ForceCanvas).
+/** Fit a viewBoxWidth x viewBoxHeight shape, centered, into canvasWidth x canvasHeight. */
+export function fitScale(viewBoxWidth, viewBoxHeight, canvasWidth, canvasHeight, padRatio = 0.92) {
+    const scale = Math.min(canvasWidth / viewBoxWidth, canvasHeight / viewBoxHeight) * padRatio;
+    const dx = (canvasWidth - viewBoxWidth * scale) / 2;
+    const dy = (canvasHeight - viewBoxHeight * scale) / 2;
+    return { scale, dx, dy };
+}
+export function easeOutCubic(progress) {
+    const clamped = Math.min(1, Math.max(0, progress));
+    return 1 - Math.pow(1 - clamped, 3);
+}
+export function lerp(a, b, t) {
+    return a + (b - a) * t;
+}
+/** Position + alpha for a particle at a given eased progress (0..1). */
+export function particleFrame(particle, eased) {
+    return {
+        x: lerp(particle.x, particle.tx, eased),
+        y: lerp(particle.y, particle.ty, eased),
+        alpha: 0.3 + eased * 0.7
+    };
+}

package/dist/spatial/particle-assemble-math.test.js

@@ -0,0 +1,56 @@
+import { describe, it, expect } from 'vitest';
+import { fitScale, easeOutCubic, lerp, particleFrame } from './particle-assemble-math';
+describe('fitScale', () => {
+    it('centers a shape narrower than the canvas', () => {
+        const { scale, dx, dy } = fitScale(100, 100, 200, 200, 1);
+        expect(scale).toBe(2);
+        expect(dx).toBe(0);
+        expect(dy).toBe(0);
+    });
+    it('applies padRatio to shrink the fitted shape', () => {
+        const { scale, dx } = fitScale(100, 100, 200, 200, 0.5);
+        expect(scale).toBe(1);
+        expect(dx).toBe(50);
+    });
+    it('fits by the constraining dimension for non-square aspect ratios', () => {
+        const { scale, dx, dy } = fitScale(270, 305, 1000, 1000, 1);
+        // height is the tighter constraint (305 > 270), so scale is bound by height
+        expect(scale).toBeCloseTo(1000 / 305, 5);
+        expect(dx).toBeGreaterThan(0);
+        expect(dy).toBe(0);
+    });
+});
+describe('easeOutCubic', () => {
+    it('maps 0 to 0 and 1 to 1', () => {
+        expect(easeOutCubic(0)).toBe(0);
+        expect(easeOutCubic(1)).toBe(1);
+    });
+    it('clamps progress outside [0, 1]', () => {
+        expect(easeOutCubic(-0.5)).toBe(0);
+        expect(easeOutCubic(1.5)).toBe(1);
+    });
+    it('decelerates — front-loads more progress than a linear ramp', () => {
+        expect(easeOutCubic(0.5)).toBeGreaterThan(0.5);
+    });
+});
+describe('lerp', () => {
+    it('interpolates linearly', () => {
+        expect(lerp(0, 10, 0)).toBe(0);
+        expect(lerp(0, 10, 1)).toBe(10);
+        expect(lerp(0, 10, 0.5)).toBe(5);
+    });
+});
+describe('particleFrame', () => {
+    it('starts at the origin position with alpha 0.3 when eased is 0', () => {
+        const frame = particleFrame({ x: 10, y: 20, tx: 100, ty: 200 }, 0);
+        expect(frame.x).toBe(10);
+        expect(frame.y).toBe(20);
+        expect(frame.alpha).toBeCloseTo(0.3);
+    });
+    it('ends at the target position with alpha 1 when eased is 1', () => {
+        const frame = particleFrame({ x: 10, y: 20, tx: 100, ty: 200 }, 1);
+        expect(frame.x).toBe(100);
+        expect(frame.y).toBe(200);
+        expect(frame.alpha).toBeCloseTo(1);
+    });
+});

package/dist/ssr-import-clean.test.js

@@ -0,0 +1,37 @@
+/**
+ * F-30a: Verify that key modules import cleanly without browser-API violations.
+ *
+ * vitest-setup.ts injects a localStorage mock and jsdom provides window/document,
+ * which can mask SSR violations. This test verifies that pure logic modules
+ * (no DOM, no browser-only APIs) import and execute without errors.
+ */
+import { describe, it, expect } from 'vitest';
+describe('F-30a import-clean (pure modules)', () => {
+    it('quality module imports cleanly (module-scope singletons)', async () => {
+        const mod = await import('./t0-transport/quality');
+        expect(mod.startQualityMonitoring).toBeDefined();
+        expect(mod.subscribeQuality).toBeDefined();
+        expect(mod.getCurrentMetrics).toBeDefined();
+    });
+    it('n1-flow-canvas utils are pure and import cleanly', async () => {
+        const mod = await import('./n1-flow-canvas/utils');
+        expect(mod.nodeHitTest).toBeDefined();
+        expect(mod.domEventToCanvasCoords).toBeDefined();
+        expect(mod.parseMentionEdges).toBeDefined();
+        expect(mod.parseGroupedSequenceEdges).toBeDefined();
+    });
+    it('n4 classifier is pure and import cleanly', async () => {
+        const mod = await import('./n4-adaptive-manifold/classifier');
+        expect(mod.classifyTopology).toBeDefined();
+        expect(mod.computeMetrics).toBeDefined();
+    });
+    it('n4 transition is pure and import cleanly', async () => {
+        const mod = await import('./n4-adaptive-manifold/transition');
+        expect(mod.EASING_FUNCTIONS).toBeDefined();
+        expect(mod.TransitionAnimator).toBeDefined();
+    });
+    it('n4 graph-state is pure and import cleanly', async () => {
+        const mod = await import('./n1-flow-canvas/graph-state.svelte');
+        expect(mod.GraphState).toBeDefined();
+    });
+});

package/dist/t0-transport/fs.d.ts

@@ -0,0 +1,12 @@
+export { isTauri } from './invoke';
+/** Thrown when no Tauri runtime (or no fs plugin) is available. */
+export declare class FsUnavailableError extends Error {
+    constructor(operation: string, cause?: unknown);
+}
+/** Read a text file. Rejects with FsUnavailableError outside a Tauri host. */
+export declare function readTextFile(path: string): Promise<string>;
+/** Write a text file. Rejects with FsUnavailableError outside a Tauri host — never a silent no-op. */
+export declare function writeTextFile(path: string, contents: string): Promise<void>;
+/** Last-modified time in epoch ms, or null when the backend can't provide one. */
+export declare function getMtimeMs(path: string): Promise<number | null>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/t0-transport/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/t0-transport/fs.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,mEAAmE;AACnE,qBAAa,kBAAmB,SAAQ,KAAK;gBAChC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAQ9C;AAsBD,8EAA8E;AAC9E,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhE;AAED,sGAAsG;AACtG,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF;AAED,kFAAkF;AAClF,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIrE"}

package/dist/t0-transport/fs.js

@@ -0,0 +1,55 @@
+// T0 Transport — file persistence over the optional Tauri FS plugin.
+//
+// Follows the same optional-peer pattern as invoke.ts: a literal dynamic
+// import of the Tauri module, guarded at runtime by isTauri(). In a non-Tauri
+// environment every operation rejects with FsUnavailableError — callers must
+// surface that state instead of pretending the operation succeeded.
+//
+// NOTE: deliberately NOT re-exported from the t0-transport barrel. The barrel
+// is reachable from the root package export; keeping fs.ts subpath-only means
+// consumers who never import the editor never make their bundler resolve
+// '@tauri-apps/plugin-fs' (an optional peer). Import it directly:
+//   import { readTextFile, writeTextFile } from '<pkg>/t0-transport/fs' (internal: '../t0-transport/fs')
+import { isTauri } from './invoke';
+export { isTauri } from './invoke';
+/** Thrown when no Tauri runtime (or no fs plugin) is available. */
+export class FsUnavailableError extends Error {
+    constructor(operation, cause) {
+        super(`File ${operation} unavailable: no Tauri runtime detected. ` +
+            'Persistence requires a Tauri host with @tauri-apps/plugin-fs installed.');
+        this.name = 'FsUnavailableError';
+        if (cause !== undefined)
+            this.cause = cause;
+    }
+}
+async function loadFs(operation) {
+    if (!isTauri())
+        throw new FsUnavailableError(operation);
+    try {
+        // @tauri-apps/plugin-fs is an optional peer. Using an indirect specifier
+        // so TypeScript and bundlers treat this as a fully dynamic import — no
+        // static module resolution, no build-time error on missing package.
+        const spec = '@tauri-apps/plugin-fs';
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return await import(/* @vite-ignore */ spec);
+    }
+    catch (cause) {
+        throw new FsUnavailableError(operation, cause);
+    }
+}
+/** Read a text file. Rejects with FsUnavailableError outside a Tauri host. */
+export async function readTextFile(path) {
+    const fs = await loadFs('read');
+    return fs.readTextFile(path);
+}
+/** Write a text file. Rejects with FsUnavailableError outside a Tauri host — never a silent no-op. */
+export async function writeTextFile(path, contents) {
+    const fs = await loadFs('write');
+    await fs.writeTextFile(path, contents);
+}
+/** Last-modified time in epoch ms, or null when the backend can't provide one. */
+export async function getMtimeMs(path) {
+    const fs = await loadFs('stat');
+    const info = await fs.stat(path);
+    return info?.mtime ? new Date(info.mtime).getTime() : null;
+}

package/dist/t0-transport/index.d.ts

@@ -2,5 +2,6 @@ export { invoke, isTauri, isTauriReady, awaitTauriReady } from './invoke';
 export { createEventBus, type EventBus } from './events';
 export { TransportError, TransportErrorCode } from './error';
 export { createConnectionTracker, type ConnectionState } from './connection';
+export { createSubstrateConnection, type CreateSubstrateConnectionOptions, type SubstrateConnection, type SubstrateState, } from './substrate.svelte';
 export { startQualityMonitoring, stopQualityMonitoring, recordPingStart, recordPingEnd, subscribeQuality, getCurrentMetrics, createQualityMonitor, getQualityColor, getQualityLabel, type QualityMetrics, type QualitySample, type QualityLevel, type QualityMonitor, } from './quality';
 //# sourceMappingURL=index.d.ts.map

package/dist/t0-transport/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/t0-transport/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAG7E,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/t0-transport/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EACL,yBAAyB,EACzB,KAAK,gCAAgC,EACrC,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC"}

package/dist/t0-transport/index.js

@@ -3,5 +3,6 @@ export { invoke, isTauri, isTauriReady, awaitTauriReady } from './invoke';
 export { createEventBus } from './events';
 export { TransportError, TransportErrorCode } from './error';
 export { createConnectionTracker } from './connection';
+export { createSubstrateConnection, } from './substrate.svelte';
 // New from NNJAS port - Connection quality monitoring
 export { startQualityMonitoring, stopQualityMonitoring, recordPingStart, recordPingEnd, subscribeQuality, getCurrentMetrics, createQualityMonitor, getQualityColor, getQualityLabel, } from './quality';

package/dist/t0-transport/invoke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/t0-transport/invoke.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,QAAQ,CAAC,EAAE,CAAC,CAAC;CACd;AAOD;;GAEG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzF,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,CAAC,GACV,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAUxD"}
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/t0-transport/invoke.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,QAAQ,CAAC,EAAE,CAAC,CAAC;CACd;AAYD;;GAEG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzF,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,CAAC,GACV,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAGtC;AAED;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAUxD"}

package/dist/t0-transport/invoke.js

@@ -1,6 +1,7 @@
 // Type-safe invoke wrapper for Tauri commands
 async function getTauriInvoke() {
-    const mod = await import('@tauri-apps/api/core');
+    const spec = '@tauri-apps/api/core';
+    const mod = await import(/* @vite-ignore */ spec);
     return mod.invoke;
 }
 /**
@@ -26,7 +27,9 @@ export function isTauri() {
  * Use for conditional rendering. Use awaitTauriReady() for init paths.
  */
 export function isTauriReady() {
-    return typeof window !== 'undefined' && window.__TAURI_INTERNALS__ != null;
+    if (typeof window === 'undefined')
+        return false;
+    return window.__TAURI_INTERNALS__ != null;
 }
 /**
  * Polls until window.__TAURI_INTERNALS__ is available (up to 5 seconds).

package/dist/t0-transport/quality.d.ts

@@ -1,8 +1,17 @@
 /**
- * Connection Quality Monitoring
+ * Connection Quality Monitoring (F-29 — module-scope singleton).
  *
- * A generalized version of NNJAS quality.ts for the LEAP design system.
- * Monitors WebSocket/connection quality with latency tracking.
+ * Holds module-scope mutable state (metrics, pingId, interval, subscribers).
+ * startQualityMonitoring() uses setInterval; consume via subscribeQuality()
+ * for reactive updates in components.
+ *
+ * @module t0-transport/quality
+ * @example
+ * ```ts
+ * import { startQualityMonitoring, subscribeQuality } from '@kos/design-system/t0-transport';
+ * startQualityMonitoring();
+ * const unsub = subscribeQuality(m => console.log(m.quality));
+ * ```
  */
 export type QualityLevel = 'excellent' | 'good' | 'fair' | 'poor' | 'disconnected';
 export interface QualitySample {

package/dist/t0-transport/quality.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/t0-transport/quality.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,IAAI,IAAI,IAAI,CAAC;IACb,UAAU,IAAI,cAAc,CAAC;IAC7B,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACpE;AA2DD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAQ7D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAQ7D;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAkB7C;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAM5C;AAED,wBAAgB,eAAe,IAAI,MAAM,CAGtC;AAEH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAmBlE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CASxF;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAoHrD"}
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/t0-transport/quality.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,cAAc,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,IAAI,IAAI,IAAI,CAAC;IACb,UAAU,IAAI,cAAc,CAAC;IAC7B,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACpE;AA2DD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAQ7D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAQ7D;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAsB7C;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAM5C;AAED,wBAAgB,eAAe,IAAI,MAAM,CAGtC;AAEH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAmBlE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CASxF;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAoHrD"}

package/dist/t0-transport/quality.js

@@ -1,12 +1,21 @@
 /**
- * Connection Quality Monitoring
+ * Connection Quality Monitoring (F-29 — module-scope singleton).
  *
- * A generalized version of NNJAS quality.ts for the LEAP design system.
- * Monitors WebSocket/connection quality with latency tracking.
+ * Holds module-scope mutable state (metrics, pingId, interval, subscribers).
+ * startQualityMonitoring() uses setInterval; consume via subscribeQuality()
+ * for reactive updates in components.
+ *
+ * @module t0-transport/quality
+ * @example
+ * ```ts
+ * import { startQualityMonitoring, subscribeQuality } from '@kos/design-system/t0-transport';
+ * startQualityMonitoring();
+ * const unsub = subscribeQuality(m => console.log(m.quality));
+ * ```
  */
 const SAMPLE_WINDOW = 60; // 60 seconds of history
 const PING_INTERVAL = 5000; // Ping every 5 seconds
-const MAX_HISTORY = 12; // Keep last 12 samples
+const MAX_HISTORY = Math.max(12, Math.ceil(SAMPLE_WINDOW * 1000 / PING_INTERVAL)); // 60s window → 12 samples at 5s interval
 let metrics = {
     latency: null,
     jitter: null,
@@ -88,6 +97,10 @@ export function startQualityMonitoring() {
                     lost: true
                 });
                 pingStartTime = null;
+                // Trim to bounded size — interval runs every 1s so history can grow fast
+                if (metrics.history.length > MAX_HISTORY) {
+                    metrics.history = metrics.history.slice(-MAX_HISTORY);
+                }
                 updateMetrics();
             }
         }

package/dist/t0-transport/substrate.svelte.d.ts

@@ -0,0 +1,27 @@
+export type SubstrateState = {
+    status: 'starting';
+} | {
+    status: 'connected';
+    seqno: number;
+} | {
+    status: 'reconnecting';
+    attempt: number;
+} | {
+    status: 'failed';
+    reason: string;
+};
+export interface SubstrateConnection {
+    state: SubstrateState;
+    init(): Promise<void>;
+    retry(): Promise<void>;
+    destroy(): void;
+    isDegraded: boolean;
+    retryLabel: string;
+}
+export interface CreateSubstrateConnectionOptions {
+    getStateCommand?: string;
+    stateEvent?: string;
+    retryCommand?: string;
+}
+export declare function createSubstrateConnection(options?: CreateSubstrateConnectionOptions): SubstrateConnection;
+//# sourceMappingURL=substrate.svelte.d.ts.map

package/dist/t0-transport/substrate.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"substrate.svelte.d.ts","sourceRoot":"","sources":["../../src/t0-transport/substrate.svelte.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,IAAI,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gCAAgC;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAwDD,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,gCAAqC,GAC7C,mBAAmB,CAErB"}

package/dist/t0-transport/substrate.svelte.js

@@ -0,0 +1,55 @@
+import { listen } from '@tauri-apps/api/event';
+import { awaitTauriReady, invoke } from './invoke';
+class SubstrateConnectionImpl {
+    options;
+    state = $state({ status: 'starting' });
+    unlisten = null;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    get isDegraded() {
+        return this.state.status === 'reconnecting' || this.state.status === 'failed';
+    }
+    get retryLabel() {
+        return this.state.status === 'failed' ? 'Retry' : 'Reconnecting';
+    }
+    async init() {
+        this.destroy();
+        const ready = await awaitTauriReady();
+        if (!ready) {
+            console.warn('[SubstrateConnection] Tauri bridge not available — skipping listeners');
+            return;
+        }
+        // Register listener FIRST: prevents missing a Connected transition that fires
+        // while invoke() is in-flight (the race that caused the persistent OFFLINE overlay).
+        this.unlisten = await listen(this.options.stateEvent ?? 'substrate:state', (event) => {
+            this.state = event.payload;
+        });
+        try {
+            this.state = await invoke(this.options.getStateCommand ?? 'substrate_get_state');
+        }
+        catch (error) {
+            // A failed *read* of supervisor state is not a connection failure — don't
+            // paint the degraded overlay on it. Stay non-degraded (`starting`) and let
+            // the `substrate:state` listener deliver the real state.
+            console.warn('[SubstrateConnection] substrate_get_state read failed; awaiting events', error);
+            this.state = { status: 'starting' };
+        }
+    }
+    async retry() {
+        this.state = { status: 'reconnecting', attempt: 0 };
+        try {
+            await invoke(this.options.retryCommand ?? 'substrate_retry');
+        }
+        catch (error) {
+            this.state = { status: 'failed', reason: error instanceof Error ? error.message : 'Unable to retry substrate connection' };
+        }
+    }
+    destroy() {
+        this.unlisten?.();
+        this.unlisten = null;
+    }
+}
+export function createSubstrateConnection(options = {}) {
+    return new SubstrateConnectionImpl(options);
+}

package/dist/u0-primitives/LockIndicator.svelte

@@ -121,8 +121,7 @@
 <style>
   .lock-indicator {
     position: relative;
-    background: var(--color-bg-panel, var(--color-bg-panel-token, #181c20));
-    border-radius: var(--radius-md, 4px);
+    background: var(--color-bg-panel, #181c20);
     overflow: hidden;
   }
 
@@ -151,7 +150,7 @@
   .lock-avatar {
     width: 28px;
     height: 28px;
-    border-radius: var(--radius-full, 9999px);
+    border-radius: var(--radius-full); /* avatar — intentionally round */
     flex-shrink: 0;
   }
 
@@ -186,20 +185,23 @@
   }
 
   .lock-request-btn {
-    padding: var(--space-1, 0.25rem) var(--space-2, 0.5rem);
-    background: var(--color-accent-subtle, var(--color-accent-muted));
-    color: var(--color-accent, var(--color-accent));
-    border: 1px solid var(--color-accent, var(--color-accent));
-    border-radius: var(--radius-sm, 2px);
-    font-size: var(--text-xs, 0.75rem);
+    padding: 3px 8px;
+    background: var(--color-accent-subtle);
+    color: var(--color-accent);
+    border: 1px solid var(--color-accent);
+    font-family: var(--font-mono);
+    font-size: var(--ui-label, 10px);
+    letter-spacing: 0.06em;
+    text-transform: uppercase;
     cursor: pointer;
-    transition: all 0.15s ease;
+    transition: background var(--transition-fast) linear, color var(--transition-fast) linear;
     flex-shrink: 0;
   }
 
+  /* Hover fill justified: confirms destructive intent (same logic as toggle thumb) */
   .lock-request-btn:hover {
     background: var(--color-accent);
-    color: var(--color-text-inverse);
+    color: var(--color-bg-app);
   }
 
   .lock-bar {
@@ -214,10 +216,10 @@
   .lock-spinner {
     width: 16px;
     height: 16px;
-    border: 2px solid var(--color-accent, var(--color-accent));
-    border-top-color: transparent;
-    border-radius: var(--radius-full, 9999px);
-    animation: spin 1s linear infinite;
+    border: 1.5px solid var(--border-default);
+    border-top-color: var(--color-accent);
+    border-right-color: var(--color-accent);
+    animation: spin 0.7s linear infinite;
   }
 
   @keyframes spin {

package/dist/u0-primitives/VerticalToolbar.svelte

@@ -112,14 +112,14 @@
     align-items: center;
     justify-content: center;
     width: 36px;
-    height: 36px;
+    height: var(--ui-control-h, 36px);
     padding: 0;
     background: transparent;
     border: 1px solid transparent;
-    border-radius: var(--radius-md, 4px);
-    color: var(--color-text-muted, var(--color-text-muted-token, #6b6558));
+    border-radius: 0;
+    color: var(--color-text-muted, #6b6558);
     cursor: pointer;
-    transition: all 0.15s ease;
+    transition: color var(--transition-fast) linear, background var(--transition-fast) linear;
   }
 
   .toolbar-item:hover:not(:disabled) {
@@ -138,16 +138,15 @@
     border-color: var(--color-accent-muted, var(--color-accent-muted));
   }
 
+  /* Active live-edge on the left — accent as functional state indicator */
   .toolbar-item.active::before {
     content: '';
     position: absolute;
     left: 0;
-    top: 50%;
-    transform: translateY(-50%);
-    width: 3px;
-    height: 20px;
-    background: var(--color-accent, var(--color-accent));
-    border-radius: 0 2px 2px 0;
+    top: 0;
+    bottom: 0;
+    width: 2px;
+    background: var(--color-accent);
   }
 
   .toolbar-item:disabled {
@@ -168,34 +167,38 @@
     height: 100%;
   }
 
+  /* Badge fill justified: count is a functional readout (unread count), not decoration */
   .toolbar-badge {
     position: absolute;
     top: 2px;
     right: 2px;
     min-width: 14px;
     height: 14px;
-    padding: 0 4px;
-    background: var(--color-accent, var(--color-accent));
-    color: var(--color-bg-app, #141414);
-    font-size: 10px;
-    font-weight: 600;
-    border-radius: var(--radius-full, 9999px);
+    padding: 0 3px;
+    background: var(--color-accent);
+    color: var(--color-bg-app, #0a0b0c);
+    font-family: var(--font-mono);
+    font-size: 9px;
+    font-weight: 700;
+    border-radius: 0;
     display: flex;
     align-items: center;
     justify-content: center;
+    font-variant-numeric: tabular-nums;
   }
 
   .toolbar-tooltip {
     position: absolute;
-    padding: var(--space-1, 0.25rem) var(--space-2, 0.5rem);
-    background: var(--color-bg-panel-elevated, #2a2a2a);
-    color: var(--color-text-primary, #f2efe9);
-    font-size: var(--text-xs, 0.75rem);
+    padding: 3px 7px;
+    background: var(--color-bg-panel-elevated);
+    color: var(--color-text-primary);
+    font-family: var(--font-mono);
+    font-size: var(--ui-label, 10px);
+    letter-spacing: 0.05em;
     white-space: nowrap;
-    border-radius: var(--radius-md, 4px);
+    border: 1px solid var(--border-default);
     pointer-events: none;
     z-index: 1000;
-    box-shadow: var(--shadow-md, 0 4px 6px rgba(0,0,0,0.3));
   }
 
   .toolbar-tooltip.tooltip-right {