@plures/design-dojo 0.5.0 → 0.5.1

package/dist/lib/app/CanvasBreadcrumb.types.d.ts

@@ -0,0 +1,7 @@
+/** A single segment in a canvas navigation path. */
+export interface CanvasPathSegment {
+    /** Unique identifier (typically the node id that was entered). */
+    id: string;
+    /** Human-readable label shown in the breadcrumb. */
+    label: string;
+}

package/dist/lib/app/ProcedureCanvas.types.d.ts

@@ -0,0 +1,58 @@
+/** A single port on a canvas node (input or output). */
+export interface Port {
+    id: string;
+    label: string;
+}
+export type NodeType = "event" | "procedure" | "action" | "condition" | "gate";
+export type NodeStatus = "active" | "inactive" | "error";
+/** A node on the procedure canvas. */
+export interface CanvasNode {
+    id: string;
+    type: NodeType;
+    label: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    config: Record<string, unknown>;
+    ports: {
+        inputs: Port[];
+        outputs: Port[];
+    };
+    status?: NodeStatus;
+    /**
+     * Optional nested canvas. When present the node can be double-clicked
+     * (or activated via the context menu) to drill into its sub-canvas.
+     */
+    subCanvas?: ProcedureCanvasState;
+}
+/** A directed edge connecting an output port to an input port. */
+export interface CanvasEdge {
+    id: string;
+    from: {
+        nodeId: string;
+        port: string;
+    };
+    to: {
+        nodeId: string;
+        port: string;
+    };
+    label?: string;
+}
+/** Full canvas state, suitable for persistence. */
+export interface ProcedureCanvasState {
+    nodes: CanvasNode[];
+    edges: CanvasEdge[];
+    viewport: {
+        x: number;
+        y: number;
+        zoom: number;
+    };
+}
+/** Ephemeral draft edge while the user is dragging from a port. */
+export interface DraftEdge {
+    fromNodeId: string;
+    fromPort: string;
+    toX: number;
+    toY: number;
+}

package/dist/lib/app/Realm.types.d.ts

@@ -0,0 +1,21 @@
+/** Realm type — personal sovereign data, a work org, or a sub-realm. */
+export type RealmType = "personal" | "org" | "sub-realm";
+/**
+ * A realm represents an isolated PluresDB topic partition.
+ * Switching realms changes which database partition the agent reads from —
+ * this is physical isolation, not a policy filter.
+ */
+export interface Realm {
+    id: string;
+    name: string;
+    type: RealmType;
+    /** Accent color for the app chrome when this realm is active. */
+    color: string;
+    icon?: string;
+    /** PluresDB Hyperswarm topic key. */
+    topicKey: string;
+    unreadCount: number;
+    lastActive: Date;
+    /** Active channel IDs in this realm. */
+    channels: string[];
+}

package/dist/lib/app/SemanticConversation.types.d.ts

@@ -0,0 +1,43 @@
+/** A semantic tag auto-generated from embedding cluster analysis. */
+export interface SemanticTag {
+    /** Auto-generated label derived from cluster centroid. */
+    label: string;
+    /** Number of messages in this cluster. */
+    count: number;
+    /** Timestamp (ms since epoch) of the most recent message in this cluster. */
+    recency: number;
+    /** Nested sub-clusters for drill-down navigation. */
+    subtags?: SemanticTag[];
+    /** PluresDB message IDs belonging to this cluster. */
+    messageIds: string[];
+}
+/** A single message that has been assigned to a semantic cluster. */
+export interface ClusteredMessage {
+    id: string;
+    content: string;
+    author: string;
+    timestamp: Date;
+    type: "user" | "agent" | "system";
+    /** Pre-computed 2-D projection coordinates for graph layout (0–1 range). */
+    x?: number;
+    y?: number;
+}
+/** A group of messages that share semantic similarity above a threshold. */
+export interface ConversationCluster {
+    id: string;
+    tags: SemanticTag[];
+    messages: ClusteredMessage[];
+    /** Average intra-cluster cosine similarity (0–1). */
+    similarity: number;
+    timespan: {
+        start: Date;
+        end: Date;
+    };
+}
+/** A directed edge between two messages in a ConversationGraph. */
+export interface SimilarityEdge {
+    sourceId: string;
+    targetId: string;
+    /** Cosine similarity score (0–1). */
+    score: number;
+}

package/dist/lib/app/SemanticSearchInput.types.d.ts

@@ -0,0 +1,15 @@
+/** Search mode selected by the current input prefix. */
+export type SearchMode = "semantic" | "tag" | "entity" | "command";
+/** A single result returned by the onquery callback. */
+export interface SemanticSearchResult {
+    id: string;
+    text: string;
+    category: string;
+    timestamp: Date;
+    /** Cosine / vector similarity in [0, 1]. */
+    similarity: number;
+    /** Optional short excerpt shown on hover/keyboard focus. */
+    snippet?: string;
+    /** Optional emoji or single-char icon displayed before the text. */
+    icon?: string;
+}

package/dist/lib/app/SubCanvas.types.d.ts

@@ -0,0 +1,16 @@
+/** Position and size of a SubCanvas on a canvas surface. */
+export interface SubCanvasBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Full serialisable state of a SubCanvas node. */
+export interface SubCanvasState extends SubCanvasBounds {
+    id: string;
+    label: string;
+    /** Nesting depth — 0 = top-level department, 1 = team, 2 = primitive group, … */
+    depth?: number;
+    /** If set, identifies another canvas linked to this node; consumers can use this ID to handle navigation externally. */
+    linkedCanvasId?: string;
+}

package/dist/lib/app/Sync.types.d.ts

@@ -0,0 +1,33 @@
+/** Operating system identifier for a peer device. */
+export type PeerOS = "windows" | "macos" | "linux" | "android" | "ios";
+/** Overall sync status shown in the SyncIndicator. */
+export type SyncStatus = "synced" | "syncing" | "offline" | "conflict";
+/** Connection and sync state of an individual peer device. */
+export type PeerStatus = "connected" | "syncing" | "offline" | "conflict";
+/** Direction of data flow for a sync operation. */
+export type SyncDirection = "push" | "pull" | "bidirectional";
+/** PluresDB record type being synchronised. */
+export type SyncRecordType = "memory" | "procedure" | "state" | "ledger";
+/** A remote peer device visible over Hyperswarm. */
+export interface Peer {
+    id: string;
+    name: string;
+    os: PeerOS;
+    lastSyncAt: Date;
+    /** Round-trip latency in milliseconds. */
+    latencyMs: number;
+    status: PeerStatus;
+    syncDirection: SyncDirection;
+}
+/** A single discrete sync event (one batch of records exchanged). */
+export interface SyncEvent {
+    id: string;
+    timestamp: Date;
+    peerId: string;
+    /** PluresDB record type that was synced. */
+    type: SyncRecordType;
+    /** Number of records exchanged. */
+    count: number;
+    /** Whether records flowed in to this device or out to the peer. */
+    direction: "in" | "out";
+}

package/dist/lib/disclosure/Accordion.svelte.d.ts

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

package/dist/lib/feedback/Badge.svelte.d.ts

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

package/dist/lib/feedback/Callout.svelte.d.ts

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

package/dist/lib/feedback/EmptyState.svelte.d.ts

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

package/dist/lib/feedback/ProgressBar.svelte.d.ts

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

package/dist/lib/forms/FileUpload.svelte.d.ts

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

package/dist/lib/forms/RadioGroup.svelte.d.ts

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

package/dist/lib/icons/NerdFont.svelte.d.ts

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

package/dist/lib/index.d.ts

@@ -0,0 +1,76 @@
+export { default as Button } from './primitives/Button.svelte';
+export { default as Input } from './primitives/Input.svelte';
+export { default as MarkdownEditor } from './primitives/MarkdownEditor.svelte';
+export type { MarkdownEditorMode } from './primitives/MarkdownEditor.types.js';
+export { default as Select } from './primitives/Select.svelte';
+export { default as Toggle } from './primitives/Toggle.svelte';
+export { default as Text } from './primitives/Text.svelte';
+export { default as SearchInput } from './primitives/SearchInput.svelte';
+export type { SearchResult } from './primitives/search-input-types';
+export type { ContextMenuItem, ContextMenuActionItem, ContextMenuSeparatorItem } from './primitives/ContextMenu.types.js';
+export { default as Box } from './layout/Box.svelte';
+export { default as SplitPane } from './layout/SplitPane.svelte';
+export { default as StatusBar } from './layout/StatusBar.svelte';
+export { default as StatusBarItem } from './layout/StatusBarItem.svelte';
+export { default as StatusBarSpacer } from './layout/StatusBarSpacer.svelte';
+export { default as Tabs } from './layout/Tabs.svelte';
+export { default as Sidebar } from './layout/Sidebar.svelte';
+export { default as TitleBar } from './layout/TitleBar.svelte';
+export type { Tab } from './layout/Tabs.types.js';
+export { default as Tooltip } from './overlays/Tooltip.svelte';
+export { default as Popover } from './overlays/Popover.svelte';
+export { default as Dialog } from './overlays/Dialog.svelte';
+export { default as Toast } from './overlays/Toast.svelte';
+export { default as Menu } from './overlays/Menu.svelte';
+export { default as ContextMenu } from './overlays/ContextMenu.svelte';
+export type { MenuItem } from './overlays/Menu.types.js';
+export { default as Table } from './data/Table.svelte';
+export { default as List } from './data/List.svelte';
+export { default as ListItem } from './data/ListItem.svelte';
+export { default as GlassPanel } from './surfaces/GlassPanel.svelte';
+export { default as Pane } from './surfaces/Pane.svelte';
+export { default as ChatPane } from './surfaces/ChatPane.svelte';
+export type { ChatMessage } from './surfaces/ChatPane.types.js';
+export { default as ProgressBar } from './feedback/ProgressBar.svelte';
+export { default as Badge } from './feedback/Badge.svelte';
+export { default as Callout } from './feedback/Callout.svelte';
+export { default as EmptyState } from './feedback/EmptyState.svelte';
+export { default as RadioGroup } from './forms/RadioGroup.svelte';
+export { default as FileUpload } from './forms/FileUpload.svelte';
+export { default as Accordion } from './disclosure/Accordion.svelte';
+export { createSpring, SPRING_PRESETS } from './motion/spring.js';
+export { default as NerdFont } from './icons/NerdFont.svelte';
+export { useTui, provideTui } from './useTui';
+export { default as ChatView } from './app/ChatView.svelte';
+export type { ChatViewMessage, ChatViewMode } from './app/ChatView.types.js';
+export { default as ChatInput } from './app/ChatInput.svelte';
+export { default as MemorySidebar } from './app/MemorySidebar.svelte';
+export type { Memory, MemoryCategory } from './app/MemorySidebar.types.js';
+export { default as SettingsPanel } from './app/SettingsPanel.svelte';
+export type { AgentSettings, ModelConfig, ChannelConfig, ChannelType } from './app/SettingsPanel.types.js';
+export { default as ProcedureEditor } from './app/ProcedureEditor.svelte';
+export type { Procedure } from './app/ProcedureEditor.types.js';
+export { default as ProcedureCanvas } from './app/ProcedureCanvas.svelte';
+export { default as ProcedureNode } from './app/ProcedureNode.svelte';
+export { default as ProcedureInspector } from './app/ProcedureInspector.svelte';
+export type { CanvasNode, CanvasEdge, Port, NodeType, NodeStatus, ProcedureCanvasState, DraftEdge } from './app/ProcedureCanvas.types.js';
+export { default as CanvasBreadcrumb } from './app/CanvasBreadcrumb.svelte';
+export type { CanvasPathSegment } from './app/CanvasBreadcrumb.types.js';
+export { default as FirstRunWizard } from './app/FirstRunWizard.svelte';
+export type { WizardData, WizardStep } from './app/FirstRunWizard.types.js';
+export { default as TagCloud } from './app/TagCloud.svelte';
+export { default as ConversationGraph } from './app/ConversationGraph.svelte';
+export { default as SemanticTimeline } from './app/SemanticTimeline.svelte';
+export type { SemanticTag, ClusteredMessage, ConversationCluster, SimilarityEdge } from './app/SemanticConversation.types.js';
+export { default as SemanticSearchInput } from './app/SemanticSearchInput.svelte';
+export type { SearchMode, SemanticSearchResult } from './app/SemanticSearchInput.types.js';
+export { default as RealmSwitcher } from './app/RealmSwitcher.svelte';
+export { default as WorkModeToggle } from './app/WorkModeToggle.svelte';
+export { default as RealmIndicator } from './app/RealmIndicator.svelte';
+export type { RealmType, Realm } from './app/Realm.types.js';
+export { default as SyncIndicator } from './app/SyncIndicator.svelte';
+export { default as PeerStatusPanel } from './app/PeerStatusPanel.svelte';
+export { default as SyncTimeline } from './app/SyncTimeline.svelte';
+export type { Peer, SyncEvent, SyncStatus, PeerStatus, SyncDirection, SyncRecordType, PeerOS } from './app/Sync.types.js';
+export { default as SubCanvas } from './app/SubCanvas.svelte';
+export type { SubCanvasBounds, SubCanvasState } from './app/SubCanvas.types.js';

package/dist/lib/layout/Box.svelte.d.ts

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

package/dist/lib/layout/Sidebar.svelte.d.ts

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

package/dist/lib/layout/SplitPane.svelte.d.ts

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

package/dist/lib/layout/StatusBar.svelte.d.ts

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

package/dist/lib/layout/StatusBarItem.svelte.d.ts

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

package/dist/lib/layout/StatusBarSpacer.svelte.d.ts

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

package/dist/lib/layout/Tabs.svelte.d.ts

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

package/dist/lib/layout/Tabs.types.d.ts

@@ -0,0 +1,10 @@
+export interface Tab {
+    /** Unique key. */
+    key: string;
+    /** Display label. */
+    label: string;
+    /** Optional icon or leading character. */
+    icon?: string;
+    /** Whether this tab is disabled. */
+    disabled?: boolean;
+}

package/dist/lib/layout/TitleBar.svelte.d.ts

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

package/dist/{layout → lib/layout}/index.d.ts

@@ -3,3 +3,7 @@ export { default as SplitPane } from './SplitPane.svelte';
 export { default as StatusBar } from './StatusBar.svelte';
 export { default as StatusBarItem } from './StatusBarItem.svelte';
 export { default as StatusBarSpacer } from './StatusBarSpacer.svelte';
+export { default as Tabs } from './Tabs.svelte';
+export { default as Sidebar } from './Sidebar.svelte';
+export { default as TitleBar } from './TitleBar.svelte';
+export type { Tab } from './Tabs.types.js';

package/dist/lib/overlays/ContextMenu.svelte.d.ts

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

package/dist/lib/overlays/Dialog.svelte.d.ts

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

package/dist/lib/overlays/Menu.svelte.d.ts

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

package/dist/lib/overlays/Menu.types.d.ts

@@ -0,0 +1,14 @@
+export interface MenuItem {
+    /** Unique key. */
+    key: string;
+    /** Display label. */
+    label: string;
+    /** Optional keyboard shortcut hint. */
+    shortcut?: string;
+    /** Optional icon or leading character. */
+    icon?: string;
+    /** Separator line before this item. */
+    separator?: boolean;
+    /** Whether this item is non-interactive. */
+    disabled?: boolean;
+}

package/dist/lib/overlays/Popover.svelte.d.ts

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

package/dist/lib/overlays/Toast.svelte.d.ts

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

package/dist/lib/overlays/Tooltip.svelte.d.ts

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

package/dist/lib/overlays/index.d.ts

@@ -0,0 +1,7 @@
+export { default as Tooltip } from './Tooltip.svelte';
+export { default as Popover } from './Popover.svelte';
+export { default as Dialog } from './Dialog.svelte';
+export { default as Toast } from './Toast.svelte';
+export { default as Menu } from './Menu.svelte';
+export { default as ContextMenu } from './ContextMenu.svelte';
+export type { MenuItem } from './Menu.types.js';

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

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

package/dist/lib/primitives/ContextMenu.svelte.d.ts

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

package/dist/lib/primitives/ContextMenu.types.d.ts

@@ -0,0 +1,22 @@
+/** A separator item in a ContextMenu (visual rule / divider only). */
+export type ContextMenuSeparatorItem = {
+    /** When true the item renders as a visual rule / divider. */
+    separator: true;
+};
+/** An actionable item in a ContextMenu. */
+export type ContextMenuActionItem = {
+    /** When true the item renders as a visual rule / divider. */
+    separator?: false;
+    /** Unique identifier for the item. Not required on separator rows. */
+    id: string;
+    /** Display label. */
+    label: string;
+    /** Optional leading icon (Unicode character, emoji, or Nerd Font glyph). */
+    icon?: string;
+    /** Keyboard shortcut hint shown on the right. */
+    shortcut?: string;
+    /** When true the item is shown but cannot be activated. */
+    disabled?: boolean;
+};
+/** A single item in a ContextMenu. */
+export type ContextMenuItem = ContextMenuSeparatorItem | ContextMenuActionItem;

package/dist/lib/primitives/Input.svelte.d.ts

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

package/dist/lib/primitives/MarkdownEditor.svelte.d.ts

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

package/dist/lib/primitives/MarkdownEditor.types.d.ts

@@ -0,0 +1 @@
+export type MarkdownEditorMode = "edit" | "preview" | "split";

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

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

package/dist/lib/primitives/Select.svelte.d.ts

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

package/dist/lib/primitives/Text.svelte.d.ts

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

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

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

package/dist/{primitives → lib/primitives}/index.d.ts

@@ -1,5 +1,7 @@
 export { default as Button } from './Button.svelte';
 export { default as Input } from './Input.svelte';
+export { default as MarkdownEditor } from './MarkdownEditor.svelte';
+export type { MarkdownEditorMode } from './MarkdownEditor.types.js';
 export { default as Select } from './Select.svelte';
 export { default as Toggle } from './Toggle.svelte';
 export { default as Text } from './Text.svelte';

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

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

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

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

package/dist/lib/surfaces/Pane.svelte.d.ts

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

package/dist/telemetry/correlation.d.ts

@@ -0,0 +1,11 @@
+/**
+ * correlation — Lightweight correlation ID utilities for design-dojo telemetry.
+ *
+ * Correlation IDs link related spans across component boundaries and async
+ * operations without including any personally-identifiable information.
+ */
+/**
+ * Generate a UUID v4 correlation ID suitable for use in URLs and logs.
+ * Uses crypto.randomUUID when available, falls back to crypto.getRandomValues.
+ */
+export declare function generateCorrelationId(): string;

package/dist/telemetry/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @plures/design-dojo — telemetry module
+ *
+ * Provides OpenTelemetry instrumentation utilities for design-dojo components.
+ *
+ * The module uses `@opentelemetry/api` which is a no-op by default — spans are
+ * only recorded once a consumer app registers an OTel SDK provider.  See
+ * docs/telemetry.md for setup instructions.
+ *
+ * @example
+ * ```ts
+ * import { createComponentTracer } from "@plures/design-dojo/telemetry";
+ *
+ * const tracer = createComponentTracer("MyButton", { variant: "solid" });
+ * tracer.recordInteraction("click", "success");
+ * ```
+ */
+export { createComponentTracer, SpanAttributes } from './tracer.js';
+export type { ComponentTracer, ComponentAttributes, EventOutcome } from './tracer.js';
+export { shouldSample, TELEMETRY_ENABLED, SAMPLE_RATE } from './sampling.js';
+export { generateCorrelationId } from './correlation.js';

package/dist/telemetry/index.js

@@ -0,0 +1,101 @@
+import { trace as f, INVALID_SPAN_CONTEXT as O, SpanStatusCode as N } from "@opentelemetry/api";
+const _ = { BASE_URL: "/", DEV: !1, MODE: "production", PROD: !0, SSR: !1 }, d = (() => {
+  try {
+    const t = _;
+    if ((t == null ? void 0 : t.VITE_OTEL_ENABLED) === "false") return !1;
+  } catch {
+  }
+  return !0;
+})(), u = (() => {
+  try {
+    const t = _, e = t == null ? void 0 : t.VITE_OTEL_SAMPLE_RATE;
+    if (e !== void 0) {
+      const a = parseFloat(e);
+      if (!isNaN(a) && a >= 0 && a <= 1) return a;
+    }
+  } catch {
+  }
+  return 1;
+})();
+function p() {
+  return d ? u >= 1 ? !0 : u <= 0 ? !1 : Math.random() < u : !1;
+}
+function S() {
+  if (typeof crypto < "u" && typeof crypto.randomUUID == "function")
+    return crypto.randomUUID();
+  if (typeof crypto < "u" && typeof crypto.getRandomValues == "function") {
+    const t = new Uint8Array(16);
+    crypto.getRandomValues(t), t[6] = t[6] & 15 | 64, t[8] = t[8] & 63 | 128;
+    const e = Array.from(t).map((a) => a.toString(16).padStart(2, "0")).join("");
+    return `${e.slice(0, 8)}-${e.slice(8, 12)}-${e.slice(12, 16)}-${e.slice(16, 20)}-${e.slice(20)}`;
+  }
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+const A = "@plures/design-dojo", s = {
+  COMPONENT_NAME: "ui.component.name",
+  COMPONENT_VARIANT: "ui.component.variant",
+  COMPONENT_STATE: "ui.component.state",
+  EVENT_NAME: "ui.event.name",
+  EVENT_OUTCOME: "ui.event.outcome",
+  CORRELATION_ID: "ui.correlation_id"
+};
+function R(t, e = {}) {
+  const a = f.getTracer(A), T = S();
+  function E(r = {}) {
+    const n = {};
+    e.extra && Object.assign(n, e.extra), r.extra && Object.assign(n, r.extra), n[s.COMPONENT_NAME] = t, n[s.CORRELATION_ID] = T;
+    const o = r.variant ?? e.variant, i = r.state ?? e.state;
+    return o !== void 0 && (n[s.COMPONENT_VARIANT] = o), i !== void 0 && (n[s.COMPONENT_STATE] = i), n;
+  }
+  return {
+    otel: a,
+    correlationId: T,
+    recordInteraction(r, n, o = {}) {
+      if (!p()) return;
+      const i = a.startSpan(`${t}.${r}`, {
+        attributes: {
+          ...E(o),
+          [s.EVENT_NAME]: r,
+          [s.EVENT_OUTCOME]: n
+        }
+      });
+      n === "error" && i.setStatus({ code: N.ERROR }), i.end();
+    },
+    startInteractionSpan(r, n = {}) {
+      if (!p())
+        return { span: f.wrapSpanContext(O), finish: () => {
+        } };
+      const o = a.startSpan(`${t}.${r}`, {
+        attributes: {
+          ...E(n),
+          [s.EVENT_NAME]: r
+        }
+      });
+      return {
+        span: o,
+        finish(i, c) {
+          o.setAttribute(s.EVENT_OUTCOME, i), i === "error" && (o.setStatus({
+            code: N.ERROR,
+            message: c == null ? void 0 : c.message
+          }), c && o.recordException(c)), o.end();
+        }
+      };
+    },
+    startRenderSpan(r = {}) {
+      if (!p()) return () => {
+      };
+      const n = a.startSpan(`${t}.render`, {
+        attributes: E(r)
+      });
+      return () => n.end();
+    }
+  };
+}
+export {
+  u as SAMPLE_RATE,
+  s as SpanAttributes,
+  d as TELEMETRY_ENABLED,
+  R as createComponentTracer,
+  S as generateCorrelationId,
+  p as shouldSample
+};

package/dist/telemetry/sampling.d.ts

@@ -0,0 +1,24 @@
+/**
+ * sampling — Sampling controls for design-dojo telemetry.
+ *
+ * Consumers configure sampling via Vite environment variables, which are
+ * resolved at build time and inlined via `import.meta.env`:
+ *
+ *   VITE_OTEL_SAMPLE_RATE=0.1   (10% of spans recorded, default 1.0)
+ *   VITE_OTEL_ENABLED=false     (disable telemetry entirely)
+ *
+ * These values are read once at module initialisation so they impose no
+ * per-span overhead in production.
+ */
+/** Whether telemetry is enabled at all.  Defaults to `true`. */
+export declare const TELEMETRY_ENABLED: boolean;
+/**
+ * Fractional sample rate in `[0, 1]`.  `1.0` records every span; `0` records
+ * none.  Controlled by `VITE_OTEL_SAMPLE_RATE` (build-time env var).
+ */
+export declare const SAMPLE_RATE: number;
+/**
+ * Returns `true` when this particular call-site should be recorded.
+ * Used by all span helpers to honour the configured sample rate.
+ */
+export declare function shouldSample(): boolean;