@stephen-netu/design-system 0.1.0 → 0.2.1

package/src/n4-adaptive-manifold/types.ts

@@ -1,313 +0,0 @@
-// N4 Adaptive Manifold — Core Types
-// Pure TypeScript — no Svelte, no DOM dependencies
-// S-02: deterministic ordering, no HashMap/Set iteration
-
-import type { NodeLayout, LayoutResult } from '../n1-flow-canvas/types.js';
-
-// === Topology Kinds ===
-
-/** The active layout algorithm. Gravitational is the only registered provider. */
-export type LayoutAlgorithm = 'gravitational' | 'manifold';
-
-// === Node Status ===
-
-/** Visual treatment for nodes — maps to --n4-node-* design tokens. */
-export type NodeStatus =
-  | 'active'      // Brass glow, full opacity
-  | 'idle'        // Muted, reduced opacity
-  | 'blocked'     // Warning accent, dashed border
-  | 'completed'   // Faded, can be auto-hidden
-  | 'critical';   // Error accent, pulse animation
-
-// === Manifold Data Primitives ===
-
-/** A node in the adaptive manifold. Domain-agnostic — the canvas never inspects metadata. */
-export interface ManifoldNode {
-  /** Stable ID across snapshots. Same entity = same ID across domains. */
-  id: string;
-  /** Domain-defined type: 'task', 'agent', 'signal', 'capability', 'intent', etc. */
-  kind: string;
-  /** Display name. */
-  label: string;
-  /** Visual treatment — maps to design tokens. */
-  status: NodeStatus;
-  /** 0–1, influences node size and gravity. */
-  weight: number;
-  /** User has fixed this node's position. */
-  pinned: boolean;
-  /** Domain-specific, opaque to canvas. Exposed in click handlers. */
-  metadata: Record<string, unknown>;
-  /** Optional spatial hints — domain adapters can suggest, canvas can ignore. */
-  hint?: { x?: number; y?: number; cluster?: string; rotation_axis?: string | null };
-}
-
-/** An edge in the adaptive manifold. */
-export interface ManifoldEdge {
-  id: string;
-  /** Source node ID. */
-  source: string;
-  /** Target node ID. */
-  target: string;
-  /** Domain-defined relationship: 'depends_on', 'delegates_to', 'emits', etc. */
-  relation: string;
-  /** Whether the edge has direction (arrow). */
-  directed: boolean;
-  /** 0–1, influences edge visual weight and spring tension. */
-  strength: number;
-  /** If true, edge fades after animation (for signal pulses). */
-  transient: boolean;
-  /** Domain-specific, opaque to canvas. */
-  metadata: Record<string, unknown>;
-}
-
-/** Immutable snapshot of manifold data — the input to all layout providers. */
-export interface ManifoldSnapshot {
-  /** SOVEREIGN deterministic sequence — not wall clock. S-02 compliant. */
-  readonly sequence: number;
-  readonly nodes: ReadonlyArray<ManifoldNode>;
-  readonly edges: ReadonlyArray<ManifoldEdge>;
-  /** 'initial' = full graph, 'incremental' = delta (new nodes/edges only). */
-  readonly epoch: 'initial' | 'incremental';
-}
-
-// === Node Style Registry ===
-
-/** Maps node `kind` strings to visual treatment. Registered by consuming apps, not the canvas. */
-export interface NodeStyleEntry {
-  /** Icon identifier (e.g. lucide icon name). */
-  icon: string;
-  /** Node shape for rendering. */
-  shape: 'rounded-rect' | 'hexagon' | 'diamond' | 'pill' | 'rect' | 'circle';
-  /** CSS custom property name for accent color (e.g. '--n4-kind-task'). */
-  accentVar: string;
-}
-
-export type NodeStyleRegistry = Record<string, NodeStyleEntry>;
-
-// ManifoldDomain (tab-per-domain adapter pattern) was removed per
-// pinnacle-garden-observer-001 ADR. All entity types coexist on one composite canvas.
-// Old per-domain adapters in consuming apps (tasksAdapter, agentsAdapter, etc.) are dead code.
-
-// === Layout Preferences ===
-
-/** User/adaptive preferences that influence topology selection and rendering. */
-export interface LayoutPreferences {
-  /** Lock to a specific algorithm, bypassing the classifier. null = auto. */
-  lockedAlgorithm: LayoutAlgorithm | null;
-  /** Animate transitions between layouts. Default true. */
-  animate: boolean;
-  /** Morph transition duration in ms. Default 600. */
-  morphDurationMs: number;
-  /** Easing curve identifier. Default 'easeInOutCubic'. */
-  easing: EasingCurve;
-}
-
-export type EasingCurve =
-  | 'linear'
-  | 'easeInOutCubic'
-  | 'easeOutExpo'
-  | 'spring';
-
-/** Default layout preferences — auto-classify, animate, 600ms easeInOutCubic. */
-export const DEFAULT_LAYOUT_PREFERENCES: LayoutPreferences = {
-  lockedAlgorithm: null,
-  animate: true,
-  morphDurationMs: 600,
-  easing: 'easeInOutCubic',
-};
-
-// === Algorithm Provider Interface ===
-
-/**
- * Each layout algorithm has an AlgorithmProvider that computes node positions.
- * Providers are stateless — all context comes from arguments.
- * Implementations must be deterministic given the same snapshot + dimensions.
- */
-export interface AlgorithmProvider {
-  /** The layout algorithm this provider implements. */
-  readonly algorithm: LayoutAlgorithm;
-
-  /**
-   * Compute a layout for the given snapshot within the given canvas bounds.
-   * Returns a LayoutResult with positions and BFS order.
-   * May be async (e.g. ELK runs a web worker).
-   */
-  layout(
-    snapshot: ManifoldSnapshot,
-    canvasWidth: number,
-    canvasHeight: number,
-  ): Promise<LayoutResult>;
-}
-
-// === Classifier ===
-
-/** Topology metrics computed once per classification. */
-export interface TopologyMetrics {
-  nodeCount: number;
-  edgeCount: number;
-  edgeDensity: number;
-  maxDepth: number;
-  rootCount: number;
-  cycleCount: number;
-  componentCount: number;
-  maxClusterSize: number;
-}
-
-/** Result of topology classification — recommended algorithm with reasoning. */
-export interface ClassificationResult {
-  /** Recommended layout algorithm. */
-  recommended: LayoutAlgorithm;
-  /** Confidence 0–1 of the recommendation. */
-  confidence: number;
-  /** Human-readable reason. */
-  reason: string;
-  /** All algorithms ranked by fitness, descending. */
-  ranked: Array<{ algorithm: LayoutAlgorithm; fitness: number }>;
-  /** Computed topology metrics. */
-  metrics: TopologyMetrics;
-}
-
-// === Transition / Animation ===
-
-/** Named animation moment types from the ADR. */
-export type AnimationMomentKind =
-  | 'settle'    // Initial layout or incremental update
-  | 'morph'     // Layout algorithm switch
-  | 'pulse'     // Transient edge signal
-  | 'arrive'    // New node added
-  | 'depart'    // Node removed
-  | 'focus';    // User clicked a node
-
-/** A single frame in a layout transition animation. */
-export interface AnimationFrame {
-  /** Interpolated positions at this frame. */
-  positions: Map<string, NodeLayout>;
-  /** Progress 0→1 through the transition. */
-  progress: number;
-  /** Elapsed ms since transition start. */
-  elapsedMs: number;
-}
-
-/** Easing function: takes t (0→1), returns eased t (0→1). */
-export type EasingFn = (t: number) => number;
-
-// === Suggestion ===
-
-/** A layout suggestion to show the user when the classifier disagrees with current view. */
-export interface LayoutSuggestion {
-  /** Suggested algorithm to switch to. */
-  algorithm: LayoutAlgorithm;
-  /** Confidence 0–1 of the suggestion. */
-  confidence: number;
-  /** Human-readable reason. */
-  reason: string;
-  /** Whether the user has dismissed this suggestion. */
-  dismissed: boolean;
-  /** Whether the user has pinned their current layout. */
-  pinned: boolean;
-}
-
-// === Resolved Theme Colors ===
-
-/** Colors resolved from --n4-* CSS tokens at mount time via getComputedStyle. */
-export interface ResolvedThemeColors {
-  canvasBg: string;
-  nodeActive: string;
-  nodeIdle: string;
-  nodeBlocked: string;
-  nodeCompleted: string;
-  nodeCritical: string;
-  nodeBg: string;
-  nodeBorder: string;
-  nodeText: string;
-  edgeColor: string;
-  edgeActive: string;
-  pulseColor: string;
-  pulseCritical: string;
-}
-
-// === Garden Observer Types ===
-
-/** Inferred phase in the perceive-think-act-sync loop */
-export type LoopPhase = 'perceive' | 'think' | 'act' | 'sync' | 'idle';
-
-/**
- * Canonical event shape consumed by the Pinnacle canvas.
- *
- * Note: the ADR also specified `entry: SigchainEntry`, but that type lives in
- * SOVEREIGN — the design-system cannot take that dependency. `sequence` provides
- * the same S-04 auditability anchor. Consumers needing the raw sigchain entry
- * should carry it separately alongside the PinnacleEvent.
- */
-export interface PinnacleEvent {
-  /** Which agent this event concerns */
-  agentId: string;
-  /** Task/capability being interacted with, if any */
-  targetId: string | null;
-  /** Inferred loop phase */
-  loopPhase: LoopPhase;
-  /** Sigchain sequence number (deterministic ordering, not wall clock) */
-  sequence: number;
-}
-
-/** Visual parameters for a single FLOW phase */
-export interface PhaseVisualParams {
-  /** Canvas background tint */
-  background: string;
-  /** 0-1 multiplier on indicator layer brightness */
-  brightness: number;
-  /** 0-1 multiplier on indicator opacity */
-  indicatorIntensity: number;
-  /** Seconds per ambient pulse cycle */
-  ambientPulseSpeed: number;
-  /** 0-1 desaturation factor (0 = full desaturation for freeze) */
-  saturation: number;
-}
-
-/** Maps FLOW phases to visual parameters — the theming contract */
-export interface PhaseTheme {
-  seed: PhaseVisualParams;
-  sprout: PhaseVisualParams;
-  go: PhaseVisualParams;
-  consult: PhaseVisualParams;
-  weed: PhaseVisualParams;
-  freeze: PhaseVisualParams;
-  compost: PhaseVisualParams;
-  prune: PhaseVisualParams;
-}
-
-/** Configuration for the gravitational force simulation */
-export interface GravitationalConfig {
-  /** 0-1: how strongly role pulls toward zone */
-  roleGravityStrength: number;
-  /** 0-1: how strongly current work pulls agent toward target */
-  interactionPullStrength: number;
-  /** Velocity decay per tick (0-1, higher = more damping) */
-  damping: number;
-  /** Minimum node separation in pixels */
-  collisionRadius: number;
-  /** Subtle random motion amplitude when idle */
-  ambientDrift: number;
-}
-
-export const DEFAULT_GRAVITATIONAL_CONFIG: GravitationalConfig = {
-  roleGravityStrength: 0.3,
-  interactionPullStrength: 0.6,
-  damping: 0.85,
-  collisionRadius: 45,
-  ambientDrift: 0.5,
-};
-
-/** Per-node indicator state for the compositing layer */
-export interface NodeIndicatorState {
-  /** Current loop phase (drives animation) */
-  loopPhase: LoopPhase;
-  /** Milliseconds in current phase (for pulse timing) */
-  phaseElapsedMs: number;
-  /** Target node ID if perceive/act trace is active */
-  traceTargetId: string | null;
-}
-
-// === Re-export n1 types for convenience ===
-
-export type { NodeLayout, LayoutResult } from '../n1-flow-canvas/types.js';

package/src/p0-primitives/tokens/index.ts

@@ -1,6 +0,0 @@
-// Design token imports — theme variants
-// Import the active theme in your app root
-
-// Re-export for direct CSS import
-// Usage: import '@kos/design-system/p0-primitives/tokens/control-room.css'
-export {};

package/src/p0-primitives/types/index.ts

@@ -1,123 +0,0 @@
-// 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';
-
-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';
-  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;
-}

package/src/p0-primitives/types/plugin-types.ts

@@ -1,74 +0,0 @@
-// 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
-
-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;
-}

package/src/p0-primitives/utils/index.ts

@@ -1,39 +0,0 @@
-// Utility functions for the design system
-
-/**
- * Class name merger - combines class names, filtering out falsy values
- */
-export function cn(...classes: (string | undefined | null | false)[]): string {
-  return classes.filter(Boolean).join(' ');
-}
-
-/**
- * Debounce function
- */
-export function debounce<T extends (...args: any[]) => any>(
-  fn: T,
-  delay: number
-): (...args: Parameters<T>) => void {
-  let timeoutId: ReturnType<typeof setTimeout>;
-  return (...args: Parameters<T>) => {
-    clearTimeout(timeoutId);
-    timeoutId = setTimeout(() => fn(...args), delay);
-  };
-}
-
-/**
- * Throttle function
- */
-export function throttle<T extends (...args: any[]) => any>(
-  fn: T,
-  limit: number
-): (...args: Parameters<T>) => void {
-  let inThrottle: boolean;
-  return (...args: Parameters<T>) => {
-    if (!inThrottle) {
-      fn(...args);
-      inThrottle = true;
-      setTimeout(() => (inThrottle = false), limit);
-    }
-  };
-}

package/src/platform/hud-protocol.ts

@@ -1,20 +0,0 @@
-// 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 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;
-}

package/src/s0-state/create-store.ts

@@ -1,84 +0,0 @@
-// Base store factory using Svelte 5 runes
-// This provides reactive state management without Svelte 4's writable/readable
-
-export interface PersistenceConfig {
-  key: string;
-  storage: 'localStorage' | 'IndexedDB';
-  serialize?: (value: unknown) => string;
-  deserialize?: (value: string) => unknown;
-}
-
-export interface StoreOptions<T> {
-  initial: T;
-  persist?: PersistenceConfig;
-  debug?: boolean;
-}
-
-interface Store<T> {
-  readonly value: T;
-  set(value: T): void;
-  update(fn: (value: T) => T): void;
-  subscribe(fn: (value: T) => void): () => void;
-}
-
-/**
- * Create a reactive store using Svelte 5 runes
- */
-export function createStore<T>(options: StoreOptions<T>): Store<T> {
-  let value = $state(options.initial);
-  const subscribers = new Set<(value: T) => void>();
-
-  // Handle persistence
-  if (options.persist) {
-    if (typeof window !== 'undefined' && options.persist.storage === 'localStorage') {
-      const stored = localStorage.getItem(options.persist.key);
-      if (stored) {
-        try {
-          const deserialized = options.persist.deserialize
-            ? options.persist.deserialize(stored)
-            : JSON.parse(stored);
-          value = deserialized as T;
-        } catch (e) {
-          console.warn('[store] Failed to deserialize stored value for key:', options.persist.key, e);
-        }
-      }
-
-      // Set up effect to persist changes.
-      // $effect.root() so this works whether createStore() is called at module
-      // level (outside any component) or inside a component.
-      $effect.root(() => {
-        $effect(() => {
-          const serialized = options.persist!.serialize
-            ? options.persist!.serialize(value)
-            : JSON.stringify(value);
-          localStorage.setItem(options.persist!.key, serialized);
-        });
-      });
-    }
-  }
-
-  function set(newValue: T) {
-    value = newValue;
-    if (options.debug) {
-      console.log(`[store] Set:`, value);
-    }
-    subscribers.forEach(fn => fn(value));
-  }
-
-  function update(fn: (value: T) => T) {
-    set(fn(value));
-  }
-
-  function subscribe(fn: (value: T) => void) {
-    subscribers.add(fn);
-    fn(value); // Immediate call with current value
-    return () => subscribers.delete(fn);
-  }
-
-  return {
-    get value() { return value; },
-    set,
-    update,
-    subscribe,
-  };
-}