@stephen-netu/design-system 0.1.0 → 0.2.0

package/dist/p0-primitives/types/index.d.ts

@@ -0,0 +1,113 @@
+export * from './plugin-types';
+export * from './geometry';
+import type { Snippet } from 'svelte';
+export interface ButtonProps {
+    variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
+    size?: 'sm' | 'md' | 'lg';
+    type?: 'button' | 'submit' | 'reset';
+    disabled?: boolean;
+    loading?: boolean;
+    class?: string;
+    onclick?: (e: MouseEvent) => void;
+    children?: Snippet;
+    iconLeading?: Snippet;
+    iconTrailing?: Snippet;
+}
+export interface InputProps {
+    value?: string;
+    type?: 'text' | 'search' | 'password' | 'email' | 'url';
+    placeholder?: string;
+    disabled?: boolean;
+    error?: boolean;
+    class?: string;
+    id?: string;
+    name?: string;
+    iconLeading?: Snippet;
+    iconTrailing?: Snippet;
+}
+export interface CardProps {
+    variant?: 'elevated' | 'flat' | 'interactive' | 'glass' | 'metal' | 'hazard';
+    selected?: boolean;
+    class?: string;
+    onclick?: (e: MouseEvent) => void;
+    onkeydown?: (e: KeyboardEvent) => void;
+    children?: Snippet;
+    header?: Snippet;
+    footer?: Snippet;
+}
+export interface BadgeProps {
+    variant?: 'status' | 'count' | 'dot' | 'outline';
+    color?: 'accent' | 'success' | 'warning' | 'error' | 'info' | 'neutral';
+    size?: 'sm' | 'md' | 'lg';
+    class?: string;
+    children?: Snippet;
+}
+export interface ToggleProps {
+    checked?: boolean;
+    disabled?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    class?: string;
+    onchange?: (checked: boolean) => void;
+    label?: Snippet;
+}
+export interface SpinnerProps {
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    color?: 'accent' | 'muted' | 'white';
+    class?: string;
+}
+export interface TabsProps {
+    tabs: Array<{
+        id: string;
+        label: string | Snippet;
+        disabled?: boolean;
+        icon?: Snippet;
+    }>;
+    activeId?: string;
+    class?: string;
+    fullWidth?: boolean;
+    onchange?: (id: string) => void;
+}
+export interface ModalProps {
+    isOpen?: boolean;
+    title?: string;
+    class?: string;
+    onClose?: () => void;
+    showCloseButton?: boolean;
+    closeOnOverlayClick?: boolean;
+    closeOnEscape?: boolean;
+    zIndex?: number;
+    children?: Snippet;
+    headerActions?: Snippet;
+    footer?: Snippet;
+}
+export interface TooltipProps {
+    content: string | Snippet;
+    position?: 'top' | 'right' | 'bottom' | 'left';
+    delayMs?: number;
+    class?: string;
+    trigger: Snippet;
+}
+export interface DropdownItem {
+    id: string;
+    label: string;
+    icon?: Snippet;
+    shortcut?: string;
+    disabled?: boolean;
+    danger?: boolean;
+}
+export interface DropdownProps {
+    items: DropdownItem[];
+    trigger: Snippet;
+    align?: 'left' | 'right' | 'center';
+    width?: string;
+    class?: string;
+    onselect?: (item: DropdownItem) => void;
+}
+export interface AvatarProps {
+    src?: string;
+    name?: string;
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    status?: 'online' | 'offline' | 'away' | 'busy' | 'typing' | null;
+    class?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/p0-primitives/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/p0-primitives/types/index.ts"],"names":[],"mappings":"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"}

package/dist/p0-primitives/types/index.js

@@ -0,0 +1,5 @@
+// Shared type definitions for the design system
+// These types mirror the actual Props interfaces in each component.
+// Keep in sync with component $props() definitions.
+export * from './plugin-types';
+export * from './geometry';

package/dist/p0-primitives/types/plugin-types.d.ts

@@ -0,0 +1,46 @@
+import type { Component } from 'svelte';
+/**
+ * Plugin capability — domain:action format.
+ * Known domains are typed; unknown capabilities fall through to string (Named escape hatch).
+ */
+export type KnownCapability = 'view:spatial' | 'view:agora' | 'view:sovereign' | 'view:terminal' | 'storage:read' | 'storage:write' | 'net:access' | 'fs:access' | 'agent:interact' | 'p2p.connect' | 'p2p.messaging' | 'persistence.local' | 'persistence.sovereign' | 'knowledge.search' | 'knowledge.ingest' | 'llm.chat' | 'llm.embeddings' | 'identity.read' | 'identity.manage';
+/** Any capability string — unknown domains map to PluginCapability::Named(_) in Rust. */
+export type PluginCapability = KnownCapability | (string & {});
+/** Lazy component factory — returns a dynamic import promise */
+export type ViewFactory = () => Promise<{
+    default: Component;
+}>;
+/** Plugin view declarations */
+export interface PluginViews {
+    /** Primary app view rendered in the shell viewport */
+    main: ViewFactory;
+    /** Optional settings panel */
+    settings?: ViewFactory;
+}
+/**
+ * Plugin manifest — the canonical frontend contract.
+ *
+ * Build-time generated from leap-plugin.toml via generate-plugin-registry.ts.
+ * Synchronized with Rust: e0-plugin-primitives::PluginManifest
+ */
+export interface PluginManifest {
+    /** Unique plugin identifier (e.g., 'agora', 'atelier', 'ryu') */
+    id: string;
+    /** Human-readable display name */
+    name: string;
+    /** Short description shown in plugin store / tooltips */
+    description: string;
+    /** Icon name from the design system icon set (e.g., 'MessageCircle') */
+    icon: string;
+    /** Optional keyboard shortcut (e.g., 'Ctrl+Shift+A') */
+    shortcut?: string;
+    /** Integration tier (0=external, 1=built-in, 2=core, 3=sovereign) */
+    tier?: number;
+    /** Capabilities this plugin provides to the capability graph */
+    provides: PluginCapability[];
+    /** Capabilities this plugin requires from the shell/runtime */
+    requires: PluginCapability[];
+    /** View factories for lazy-loading components */
+    views: PluginViews;
+}
+//# sourceMappingURL=plugin-types.d.ts.map

package/dist/p0-primitives/types/plugin-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../../../src/p0-primitives/types/plugin-types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,YAAY,GACZ,gBAAgB,GAChB,eAAe,GACf,cAAc,GACd,eAAe,GACf,YAAY,GACZ,WAAW,GACX,gBAAgB,GAChB,aAAa,GACb,eAAe,GACf,mBAAmB,GACnB,uBAAuB,GACvB,kBAAkB,GAClB,kBAAkB,GAClB,UAAU,GACV,gBAAgB,GAChB,eAAe,GACf,iBAAiB,CAAC;AAEtB,yFAAyF;AACzF,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE/D,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAEhE,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,IAAI,EAAE,WAAW,CAAC;IAClB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,iDAAiD;IACjD,KAAK,EAAE,WAAW,CAAC;CACpB"}

package/dist/p0-primitives/types/plugin-types.js

@@ -0,0 +1,7 @@
+// Plugin manifest types — capability-first app integration contract
+// Apps declare capabilities via typed manifest; shell aggregates at build time.
+//
+// Synchronized with: SOVEREIGN/effectors/e0-plugin-primitives/src/lib.rs
+// Canonical Rust types: PluginManifest, TauriSubstrateExtension, ShellExtension
+// See ADR: .gears/_realm/adr/2026-04-18-plugin-contract-unification.md
+export {};

package/dist/p0-primitives/utils/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Class name merger - combines class names, filtering out falsy values
+ */
+export declare function cn(...classes: (string | undefined | null | false)[]): string;
+/**
+ * Debounce function
+ */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Throttle function
+ */
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, limit: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/p0-primitives/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/p0-primitives/utils/index.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC,EAAE,GAAG,MAAM,CAE5E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAMlC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CASlC"}

package/dist/p0-primitives/utils/index.js

@@ -0,0 +1,30 @@
+// Utility functions for the design system
+/**
+ * Class name merger - combines class names, filtering out falsy values
+ */
+export function cn(...classes) {
+    return classes.filter(Boolean).join(' ');
+}
+/**
+ * Debounce function
+ */
+export function debounce(fn, delay) {
+    let timeoutId;
+    return (...args) => {
+        clearTimeout(timeoutId);
+        timeoutId = setTimeout(() => fn(...args), delay);
+    };
+}
+/**
+ * Throttle function
+ */
+export function throttle(fn, limit) {
+    let inThrottle;
+    return (...args) => {
+        if (!inThrottle) {
+            fn(...args);
+            inThrottle = true;
+            setTimeout(() => (inThrottle = false), limit);
+        }
+    };
+}

package/dist/platform/hud-protocol.d.ts

@@ -0,0 +1,14 @@
+export type HudIndicator = 'nominal' | 'degraded' | 'offline';
+export interface HudContribution {
+    /** Stable ID, e.g. "ryu:spark", "agora:peers" */
+    id: string;
+    /** Short display label */
+    label: string;
+    /** Rendered value — string or number */
+    value: string | number;
+    /** Visual state */
+    indicator: HudIndicator;
+    /** Lower = left-most in HUD bar */
+    priority: number;
+}
+//# sourceMappingURL=hud-protocol.d.ts.map

package/dist/platform/hud-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hud-protocol.d.ts","sourceRoot":"","sources":["../../src/platform/hud-protocol.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,mBAAmB;IACnB,SAAS,EAAE,YAAY,CAAC;IACxB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/platform/hud-protocol.js

@@ -0,0 +1,6 @@
+// Platform HUD Protocol — cross-boundary telemetry contract
+//
+// Plugins (Ryu, Agora, etc.) emit hud:contribution Tauri events.
+// LEAP's hudStore collects them; LeapHud renders them generically.
+// See: .gears/_realm/architecture/leap-compositor-protocol-001.md
+export {};

package/dist/platform/index.d.ts

@@ -0,0 +1,2 @@
+export type { HudIndicator, HudContribution } from './hud-protocol';
+//# sourceMappingURL=index.d.ts.map

package/dist/platform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/{src/platform/index.ts → dist/platform/index.js}

@@ -1,3 +1,2 @@
 // Platform — cross-boundary protocols between LEAP shell and plugins
-
-export type { HudIndicator, HudContribution } from './hud-protocol';
+export {};

package/dist/s0-lifecycle/CanvasRenderContext.d.ts

@@ -0,0 +1,20 @@
+import type { Rect, Point, Size } from '../p0-primitives/types/geometry';
+import type { RenderContext, TextStyle, ClipRegion } from './RenderContext';
+export declare class CanvasRenderContext implements RenderContext {
+    readonly viewportSize: Size;
+    readonly scale: number;
+    readonly maxTextureDimension: number | null;
+    private ctx;
+    private commands;
+    constructor(canvas: HTMLCanvasElement);
+    drawRect(rect: Rect, color: string): void;
+    drawText(position: Point, text: string, style: TextStyle): void;
+    drawImage(src: string, bounds: Rect): void;
+    pushClip(clip: ClipRegion): void;
+    popClip(): void;
+    pushTransform(matrix: DOMMatrix | number[]): void;
+    popTransform(): void;
+    /** Flush all accumulated draw commands to the canvas in zindex order. */
+    flush(): void;
+}
+//# sourceMappingURL=CanvasRenderContext.d.ts.map

package/dist/s0-lifecycle/CanvasRenderContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasRenderContext.d.ts","sourceRoot":"","sources":["../../src/s0-lifecycle/CanvasRenderContext.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAe,MAAM,iBAAiB,CAAC;AAEzF,qBAAa,mBAAoB,YAAW,aAAa;IACvD,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEnD,OAAO,CAAC,GAAG,CAA2B;IACtC,OAAO,CAAC,QAAQ,CAAqB;gBAEzB,MAAM,EAAE,iBAAiB;IAQrC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzC,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAI/D,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI;IAI1C,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIhC,OAAO,IAAI,IAAI;IAIf,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,IAAI;IAMjD,YAAY,IAAI,IAAI;IAIpB,yEAAyE;IACzE,KAAK,IAAI,IAAI;CA6Cd"}

package/dist/s0-lifecycle/CanvasRenderContext.js

@@ -0,0 +1,90 @@
+// S0 Lifecycle — Canvas 2D concrete RenderContext
+// Wraps HTMLCanvasElement CanvasRenderingContext2D to implement RenderContext.
+// All draw calls are batched within a single beginPath/restore cycle per frame.
+export class CanvasRenderContext {
+    viewportSize;
+    scale;
+    maxTextureDimension = null;
+    ctx;
+    commands = [];
+    constructor(canvas) {
+        const ctx = canvas.getContext('2d');
+        if (!ctx)
+            throw new Error('Cannot get 2D context from canvas');
+        this.ctx = ctx;
+        this.viewportSize = { width: canvas.width, height: canvas.height };
+        this.scale = window.devicePixelRatio ?? 1;
+    }
+    drawRect(rect, color) {
+        this.commands.push({ type: 'rect', rect, color });
+    }
+    drawText(position, text, style) {
+        this.commands.push({ type: 'text', position, text, style });
+    }
+    drawImage(src, bounds) {
+        this.commands.push({ type: 'image', src, bounds });
+    }
+    pushClip(clip) {
+        this.commands.push({ type: 'clip', clip, action: 'push' });
+    }
+    popClip() {
+        this.commands.push({ type: 'clip', action: 'pop' });
+    }
+    pushTransform(matrix) {
+        const mat = Array.isArray(matrix) ? matrix : null;
+        const domMat = Array.isArray(matrix) ? null : matrix;
+        this.commands.push({ type: 'transform', action: 'push', matrix: mat, domMatrix: domMat });
+    }
+    popTransform() {
+        this.commands.push({ type: 'transform', action: 'pop' });
+    }
+    /** Flush all accumulated draw commands to the canvas in zindex order. */
+    flush() {
+        const c = this.ctx;
+        c.clearRect(0, 0, this.viewportSize.width, this.viewportSize.height);
+        const sorted = [...this.commands].sort((a, b) => (a.zindex ?? 0) - (b.zindex ?? 0));
+        for (const cmd of sorted) {
+            if (cmd.type === 'rect') {
+                c.fillStyle = cmd.color;
+                const r = cmd.rect;
+                c.fillRect(r.x, r.y, r.width, r.height);
+            }
+            else if (cmd.type === 'text') {
+                const s = cmd.style;
+                c.font = `${s.fontWeight ?? 400} ${s.fontSize ?? 14}px ${s.fontFamily ?? 'var(--font-mono, monospace)'}`;
+                c.fillStyle = s.color ?? '#e8e0d0';
+                const p = cmd.position;
+                c.fillText(cmd.text, p.x, p.y);
+            }
+            else if (cmd.type === 'clip') {
+                if (cmd.action === 'push') {
+                    c.save();
+                    const clip = cmd.clip;
+                    c.beginPath();
+                    c.rect(clip.bounds.x, clip.bounds.y, clip.bounds.width, clip.bounds.height);
+                    c.clip();
+                }
+                else {
+                    c.restore();
+                }
+            }
+            else if (cmd.type === 'transform') {
+                if (cmd.action === 'push') {
+                    c.save();
+                    if (cmd.domMatrix) {
+                        c.setTransform(cmd.domMatrix);
+                    }
+                    else if (cmd.matrix) {
+                        const m = cmd.matrix;
+                        c.transform(m[0], m[1], m[2], m[3], m[4], m[5]);
+                    }
+                }
+                else {
+                    c.restore();
+                }
+            }
+            // 'image' type: implement with ImageBitmap cache if needed later
+        }
+        this.commands = [];
+    }
+}

package/dist/s0-lifecycle/ConstraintContext.d.ts

@@ -0,0 +1,27 @@
+export interface SizeConstraint {
+    /** Minimum width in pixels */
+    min: number;
+    /** Preferred/ideal width in pixels */
+    preferred: number;
+    /** Maximum width in pixels (Infinity = unbounded) */
+    max: number;
+}
+export interface SizeConstraints {
+    width: SizeConstraint;
+    height: SizeConstraint;
+}
+/**
+ * ConstraintContext is provided during the constraint-solving phase.
+ * Components query available space and declare their size requirements.
+ */
+export interface ConstraintContext {
+    /** Available viewport/container dimensions */
+    readonly available: SizeConstraints;
+    /** Current scale factor (1.0 = native, >1 = zoomed in) */
+    readonly scale: number;
+    /** Request a specific size for this component */
+    constrain(width: number, height: number): SizeConstraints;
+    /** Query the constraint for a child slot by key */
+    childConstraint(key: string): SizeConstraints | undefined;
+}
+//# sourceMappingURL=ConstraintContext.d.ts.map

package/dist/s0-lifecycle/ConstraintContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConstraintContext.d.ts","sourceRoot":"","sources":["../../src/s0-lifecycle/ConstraintContext.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IAEpC,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,iDAAiD;IACjD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAAC;IAE1D,mDAAmD;IACnD,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;CAC3D"}

package/dist/s0-lifecycle/ConstraintContext.js

@@ -0,0 +1,3 @@
+// S0 Lifecycle — Constraint Context
+// Provides size constraint information during the layout calculation phase.
+export {};

package/dist/s0-lifecycle/InteractionContext.d.ts

@@ -0,0 +1,38 @@
+export type EventOutcome = 'consumed' | 'propagated';
+export interface InteractionEvent {
+    /** DOM event type */
+    readonly type: string;
+    /** Native DOM event (for advanced use) */
+    readonly nativeEvent: Event;
+    /** Whether this event has been consumed */
+    readonly consumed: boolean;
+    /** The component-local coordinates of the event */
+    readonly position?: {
+        x: number;
+        y: number;
+    };
+    /** Keyboard modifiers active during event */
+    readonly modifiers?: {
+        shift: boolean;
+        ctrl: boolean;
+        alt: boolean;
+        meta: boolean;
+    };
+}
+/**
+ * InteractionContext is provided during the event handling phase.
+ * Components receive events and decide whether to consume or propagate them.
+ */
+export interface InteractionContext {
+    /** The event being dispatched */
+    readonly event: InteractionEvent;
+    /** Consume the event — stops propagation to ancestors */
+    consume(): void;
+    /** Request focus for this component */
+    requestFocus(): void;
+    /** Release focus from this component */
+    releaseFocus(): void;
+    /** Request the platform show a soft keyboard (mobile) */
+    requestSoftKeyboard(): void;
+}
+//# sourceMappingURL=InteractionContext.d.ts.map

package/dist/s0-lifecycle/InteractionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractionContext.d.ts","sourceRoot":"","sources":["../../src/s0-lifecycle/InteractionContext.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,YAAY,CAAC;AAEjB,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;IAC5B,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,KAAK,EAAE,OAAO,CAAC;QACf,IAAI,EAAE,OAAO,CAAC;QACd,GAAG,EAAE,OAAO,CAAC;QACb,IAAI,EAAE,OAAO,CAAC;KACf,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IAEjC,yDAAyD;IACzD,OAAO,IAAI,IAAI,CAAC;IAEhB,uCAAuC;IACvC,YAAY,IAAI,IAAI,CAAC;IAErB,wCAAwC;IACxC,YAAY,IAAI,IAAI,CAAC;IAErB,yDAAyD;IACzD,mBAAmB,IAAI,IAAI,CAAC;CAC7B"}

package/dist/s0-lifecycle/InteractionContext.js

@@ -0,0 +1,3 @@
+// S0 Lifecycle — Interaction Context
+// Provides event dispatch and consumption during the interaction phase.
+export {};

package/dist/s0-lifecycle/LayoutContext.d.ts

@@ -0,0 +1,19 @@
+import type { Rect, Size } from '../p0-primitives/types/geometry';
+export type { Rect, Size } from '../p0-primitives/types/geometry';
+/**
+ * LayoutContext is provided after the constraint phase resolves.
+ * Components learn their final bounds and can request repaints.
+ */
+export interface LayoutContext {
+    /** The resolved bounds for this component */
+    readonly bounds: Rect;
+    /** Request a repaint of this component (marks dirty) */
+    requestRepaint(): void;
+    /** Request a repaint after a specific delay (for animations) */
+    requestRepaintAt(delayMs: number): void;
+    /** Get the bounds of a child by key */
+    childBounds(key: string): Rect | undefined;
+    /** Window/viewport size */
+    readonly viewportSize: Size;
+}
+//# sourceMappingURL=LayoutContext.d.ts.map

package/dist/s0-lifecycle/LayoutContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutContext.d.ts","sourceRoot":"","sources":["../../src/s0-lifecycle/LayoutContext.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAElE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IAEtB,wDAAwD;IACxD,cAAc,IAAI,IAAI,CAAC;IAEvB,gEAAgE;IAChE,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC,uCAAuC;IACvC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAE3C,2BAA2B;IAC3B,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;CAC7B"}

package/dist/s0-lifecycle/LayoutContext.js

@@ -0,0 +1,3 @@
+// S0 Lifecycle — Layout Context
+// Provides bounds and position information after constraint resolution.
+export {};

package/dist/s0-lifecycle/Lifecycle.d.ts

@@ -0,0 +1,60 @@
+import type { ConstraintContext, SizeConstraints } from './ConstraintContext';
+import type { LayoutContext } from './LayoutContext';
+import type { InteractionContext, EventOutcome } from './InteractionContext';
+import type { RenderContext } from './RenderContext';
+/**
+ * Lifecycle — the core component interface for phased rendering.
+ *
+ * Each method corresponds to a distinct phase in the component's
+ * per-frame lifecycle. Not all phases must be implemented; default
+ * no-op implementations allow selective override.
+ *
+ * Usage in Svelte 5:
+ *   Components typically wrap a Lifecycle implementation via $state
+ *   and delegate lifecycle calls from Svelte's reactive hooks.
+ */
+export interface Lifecycle {
+    /**
+     * Phase 1: Constraint solving.
+     * Query available space and return size requirements.
+     * Called before layout.
+     */
+    constrain?(ctx: ConstraintContext): SizeConstraints;
+    /**
+     * Phase 2: Layout resolution.
+     * Receive final bounds after constraint solving.
+     * Position children, request repaints if needed.
+     */
+    layout?(ctx: LayoutContext): void;
+    /**
+     * Phase 3: Interaction handling.
+     * Receive an input event and decide whether to consume it.
+     * Return 'consumed' to stop propagation, 'propagated' to continue.
+     */
+    interact?(ctx: InteractionContext): EventOutcome;
+    /**
+     * Phase 4: Rendering.
+     * Issue draw commands to the scene via RenderContext.
+     * This is the only phase that produces visual output.
+     */
+    render?(ctx: RenderContext): void;
+}
+/**
+ * Helper type: a Lifecycle phase name.
+ */
+export type LifecyclePhase = 'constrain' | 'layout' | 'interact' | 'render';
+/**
+ * Phase execution order (deterministic).
+ */
+export declare const LIFECYCLE_PHASES: readonly LifecyclePhase[];
+/**
+ * Execute all implemented phases on a Lifecycle instance in order.
+ * Skips phases that are not implemented (undefined).
+ */
+export declare function executeLifecycle(lifecycle: Lifecycle, contexts: {
+    constrain: ConstraintContext;
+    layout: LayoutContext;
+    interact?: InteractionContext;
+    render: RenderContext;
+}): EventOutcome | undefined;
+//# sourceMappingURL=Lifecycle.d.ts.map

package/dist/s0-lifecycle/Lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lifecycle.d.ts","sourceRoot":"","sources":["../../src/s0-lifecycle/Lifecycle.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,SAAS,CAAC,CAAC,GAAG,EAAE,iBAAiB,GAAG,eAAe,CAAC;IAEpD;;;;OAIG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;IAElC;;;;OAIG;IACH,QAAQ,CAAC,CAAC,GAAG,EAAE,kBAAkB,GAAG,YAAY,CAAC;IAEjD;;;;OAIG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAK5C,CAAC;AAEX;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE;IACR,SAAS,EAAE,iBAAiB,CAAC;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,MAAM,EAAE,aAAa,CAAC;CACvB,GACA,YAAY,GAAG,SAAS,CAkB1B"}

package/dist/s0-lifecycle/Lifecycle.js

@@ -0,0 +1,38 @@
+// S0 Lifecycle — Component Lifecycle Interface
+// Defines the phased lifecycle that components implement.
+//
+// Lifecycle phases (executed in order):
+//   1. constrain  — Compute size requirements from available space
+//   2. layout     — Receive resolved bounds, position children
+//   3. interact   — Handle input events, consume or propagate
+//   4. render     — Issue draw commands to scene graph
+//
+// This is the core abstraction: any component with structured
+// layout/event/render behavior implements Lifecycle.
+/**
+ * Phase execution order (deterministic).
+ */
+export const LIFECYCLE_PHASES = [
+    'constrain',
+    'layout',
+    'interact',
+    'render',
+];
+/**
+ * Execute all implemented phases on a Lifecycle instance in order.
+ * Skips phases that are not implemented (undefined).
+ */
+export function executeLifecycle(lifecycle, contexts) {
+    let outcome;
+    // Phase 1: Constrain (always runs if implemented)
+    lifecycle.constrain?.(contexts.constrain);
+    // Phase 2: Layout (always runs if implemented)
+    lifecycle.layout?.(contexts.layout);
+    // Phase 3: Interact (only if event context provided)
+    if (contexts.interact) {
+        outcome = lifecycle.interact?.(contexts.interact);
+    }
+    // Phase 4: Render (always runs if implemented)
+    lifecycle.render?.(contexts.render);
+    return outcome;
+}