@stephen-netu/design-system 0.1.0 → 0.2.0

package/dist/entity-graph-view/types.js

@@ -0,0 +1,213 @@
+// Entity Graph View — SOVEREIGN Entity Graph Visualization Types
+// Maps m0-primitives entity types to LEAP visualization components
+//
+// IMPORTANT: These types match the serde serialization output from Rust.
+// Rust uses snake_case fields and externally tagged enum variants by default.
+// === Enum Extractors ===
+/** Extract string value from externally-tagged EntityType */
+export function entityTypeStr(t) {
+    return t.Custom;
+}
+/** Extract string value from externally-tagged RelationshipType */
+export function relationshipTypeStr(t) {
+    return t.Custom;
+}
+/** Extract string value from externally-tagged MetricType */
+export function metricTypeStr(t) {
+    return t.Custom;
+}
+/** Extract state string from externally-tagged EntityState */
+export function entityStateStr(s) {
+    if ('Active' in s)
+        return 'active';
+    if ('Inactive' in s)
+        return 'inactive';
+    if ('Degraded' in s)
+        return 'degraded';
+    if ('Critical' in s)
+        return 'critical';
+    if ('Pending' in s)
+        return 'pending';
+    if ('Resolved' in s)
+        return 'resolved';
+    if ('Custom' in s)
+        return s.Custom;
+    return 'unknown';
+}
+/** Extract scalar value from MetricValue, if scalar */
+export function metricValueScalar(v) {
+    if ('Scalar' in v)
+        return v.Scalar;
+    return null;
+}
+/** Extract latest value from MetricValue */
+export function metricValueLatest(v) {
+    if ('Scalar' in v)
+        return v.Scalar;
+    if ('Distribution' in v) {
+        const d = v.Distribution;
+        return d.length > 0 ? d[d.length - 1] : null;
+    }
+    if ('TimeSeries' in v) {
+        const ts = v.TimeSeries;
+        return ts.length > 0 ? ts[ts.length - 1][1] : null;
+    }
+    return null;
+}
+// === State Color Map ===
+export const STATE_COLORS = {
+    active: '#22c55e',
+    inactive: '#6b7280',
+    degraded: '#f59e0b',
+    critical: '#ef4444',
+    pending: '#3b82f6',
+    resolved: '#10b981',
+};
+// === Adapters ===
+/**
+ * Convert WorldEntity to NodeInstance for n0-node-graph.
+ * EntityId is a string, so id maps directly.
+ */
+export function entityToNodeInstance(entity, position = { x: 0, y: 0 }) {
+    return {
+        id: entity.id,
+        kind: entityTypeStr(entity.entity_type),
+        position,
+        size: { width: 200, height: 100 },
+        data: {
+            display_name: entity.display_name,
+            canonical_name: entity.canonical_name,
+            state: entityStateStr(entity.state),
+            tags: entity.tags,
+            ...entity.properties,
+        },
+        collapsed: false,
+    };
+}
+/**
+ * Convert WorldEdge to EdgeDefinition for n0-node-graph.
+ */
+export function edgeToEdgeDefinition(edge) {
+    return {
+        id: edge.id,
+        sourceNodeId: edge.source,
+        sourcePortId: 'output',
+        targetNodeId: edge.target,
+        targetPortId: 'input',
+        metadata: {
+            relationship: relationshipTypeStr(edge.relationship),
+            weight: edge.weight,
+            ...edge.properties,
+        },
+    };
+}
+/**
+ * Generate NodeDefinition for an entity type.
+ * One definition per unique entity_type in the snapshot.
+ */
+export function entityTypeToNodeDefinition(entityType) {
+    return {
+        kind: entityType,
+        label: entityType.charAt(0).toUpperCase() + entityType.slice(1),
+        description: `${entityType} entity`,
+        ports: [
+            { id: 'input', label: 'In', type: 'system:edge:default', direction: 'input', required: false, maxConnections: -1 },
+            { id: 'output', label: 'Out', type: 'system:edge:default', direction: 'output', required: false, maxConnections: -1 },
+        ],
+        metadata: {},
+    };
+}
+/**
+ * Convert WorldSnapshot to GraphSchema with ELK-compatible layout hints.
+ * Positions are set to 0,0 — use elkjs for layout before rendering.
+ */
+export function snapshotToGraphSchema(snapshot) {
+    // Collect unique entity types for node definitions
+    const typeSet = new Set();
+    Object.values(snapshot.entities).forEach(e => {
+        typeSet.add(entityTypeStr(e.entity_type));
+    });
+    const nodeDefinitions = Array.from(typeSet).sort().map(entityTypeToNodeDefinition);
+    // Create nodes at origin — layout engine positions them
+    const nodes = Object.values(snapshot.entities).map(e => entityToNodeInstance(e, { x: 0, y: 0 }));
+    // Create edges
+    const edges = Object.values(snapshot.edges).map(edgeToEdgeDefinition);
+    return {
+        id: `entity-graph-${snapshot.sequence}`,
+        name: `Entity Graph #${snapshot.sequence}`,
+        version: '1.0.0',
+        nodeDefinitions,
+        nodes,
+        edges,
+    };
+}
+/**
+ * Extract latest scalar metrics as MetricCardProps.
+ */
+export function snapshotToMetrics(snapshot) {
+    const cards = [];
+    for (const [_entityId, metricMap] of Object.entries(snapshot.metrics)) {
+        for (const [metricTypeKey, metrics] of Object.entries(metricMap)) {
+            if (metrics.length === 0)
+                continue;
+            // Find latest by timestamp_sequence
+            const sorted = [...metrics].sort((a, b) => a.timestamp_sequence - b.timestamp_sequence);
+            const latest = sorted[sorted.length - 1];
+            const scalar = metricValueLatest(latest.value);
+            if (scalar === null)
+                continue;
+            // Compute trend from last two values
+            let trend;
+            if (sorted.length >= 2) {
+                const prev = metricValueLatest(sorted[sorted.length - 2].value);
+                if (prev !== null) {
+                    trend = scalar > prev ? 'up' : scalar < prev ? 'down' : 'flat';
+                }
+            }
+            cards.push({
+                label: metricTypeKey.replace(/_/g, ' ').replace(/\b\w/g, c => c.toUpperCase()),
+                value: scalar.toFixed(2),
+                unit: latest.unit,
+                trend,
+                size: 'default',
+            });
+        }
+    }
+    return cards;
+}
+/**
+ * Convert StateTransitions to TimelineEntries.
+ */
+export function snapshotToTimeline(snapshot) {
+    return [...snapshot.transitions]
+        .sort((a, b) => a.sequence - b.sequence)
+        .map(t => ({
+        id: `transition-${t.sequence}-${t.entity_id}`,
+        timestamp: `Seq ${t.sequence}`,
+        label: `${entityStateStr(t.from_state)} → ${entityStateStr(t.to_state)}`,
+        description: `${t.entity_id}: ${t.trigger}`,
+        color: STATE_COLORS[entityStateStr(t.to_state)] ?? '#6b7280',
+    }));
+}
+export function filterEntities(entities, filter) {
+    return entities.filter(entity => {
+        if (filter.entity_types?.length && !filter.entity_types.includes(entityTypeStr(entity.entity_type))) {
+            return false;
+        }
+        if (filter.states?.length && !filter.states.includes(entityStateStr(entity.state))) {
+            return false;
+        }
+        if (filter.tags_any?.length && !filter.tags_any.some(t => entity.tags.includes(t))) {
+            return false;
+        }
+        if (filter.tags_all?.length && !filter.tags_all.every(t => entity.tags.includes(t))) {
+            return false;
+        }
+        if (filter.name_contains &&
+            !entity.canonical_name.includes(filter.name_contains) &&
+            !entity.display_name.includes(filter.name_contains)) {
+            return false;
+        }
+        return true;
+    });
+}

package/dist/epistemic/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './utils.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/epistemic/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/epistemic/types.d.ts

@@ -0,0 +1,132 @@
+export interface AssayClearanceView {
+    checkpoint: 'PreIsr' | 'PreMettle' | 'PreEffector' | 'PreKnowledge';
+    gate: 'Cleared' | 'Blocked';
+    severity: 'None' | 'Minor' | 'Medium' | 'High' | 'Critical';
+    weightedSum: number;
+    signals: AssaySignalView[];
+    computedAt: number;
+    isDegraded: boolean;
+}
+export interface AssaySignalView {
+    id: 'SaeClarity' | 'SchemaValid' | 'RiskTier' | 'SourceCredibility' | 'SemanticCoherence' | 'CapabilityCheck' | 'FeatureCoverage' | 'NoveltyGate';
+    result: 'Pass' | 'Fail' | 'Unavailable';
+    confidence: number | null;
+    isHardGate: boolean;
+    reason?: string;
+}
+export interface AllayStageView {
+    stage: 0 | 1 | 2 | 3 | 4 | 5;
+    confidence: number;
+    stageName: 'Propose' | 'Parse' | 'Authorize' | 'Execute' | 'Trace' | 'Replicate';
+}
+export declare function confidenceToStage(confidence: number): AllayStageView;
+export interface ExpertIdentity {
+    name: 'Atelier' | 'Agora' | 'Ryu' | 'SOVEREIGN' | 'Agent';
+    agentId?: string;
+    domain: string;
+}
+export interface AvenueStepView {
+    step_type: 'query' | 'retrieve' | 'filter' | 'synthesize' | 'contradict' | 'verify' | string;
+    summary: string;
+}
+export interface AvenueTraceView {
+    steps: AvenueStepView[];
+    isPartial: boolean;
+    confidence: number;
+    session_id: string;
+}
+export type ProvenanceNodeType = 'human_draft' | 'file_source' | 'web_source' | 'assay_evaluation' | 'sigchain_witness' | 'agent_research' | 'accord_replication' | 'access_epoch' | 'knowledge_merge' | 'supersession';
+export interface ProvenanceChainNodeBase {
+    id: string;
+    timestamp: number;
+    expert: ExpertIdentity;
+    previousNodeId: string | null;
+}
+export type ProvenanceChainNode = ProvenanceChainNodeBase & ({
+    type: 'human_draft';
+    detail: {
+        contentHash: string;
+    };
+} | {
+    type: 'file_source';
+    detail: {
+        filePath: string;
+        contentHash: string;
+    };
+} | {
+    type: 'web_source';
+    detail: {
+        url: string;
+        sourceUrlHash: string;
+        sectionId?: string;
+    };
+} | {
+    type: 'assay_evaluation';
+    detail: {
+        checkpoint: string;
+        gate: string;
+        clearanceHash: string;
+        weightedSum: number;
+    };
+} | {
+    type: 'sigchain_witness';
+    detail: {
+        witnessRef: string;
+        assayConfidence: number;
+    };
+} | {
+    type: 'agent_research';
+    detail: {
+        sessionId: string;
+        claimHash: string;
+    };
+} | {
+    type: 'accord_replication';
+    detail: {
+        accordId: string;
+        sourceRealmId: string;
+    };
+} | {
+    type: 'access_epoch';
+    detail: {
+        accessCount: number;
+        consolidatorId: string;
+    };
+} | {
+    type: 'knowledge_merge';
+    detail: {
+        inputHashes: string[];
+    };
+} | {
+    type: 'supersession';
+    detail: {
+        supersededHash: string;
+    };
+});
+export interface KnowledgeEpistemicDetail {
+    contentHash: string;
+    title: string;
+    source: string;
+    expert?: ExpertIdentity | null;
+    allay: AllayStageView;
+    assay?: AssayClearanceView | null;
+    provenance: ProvenanceChainNode[] | null;
+    avenue?: AvenueTraceView | null;
+    convergence: number;
+}
+export interface EpistemicStats {
+    totalKnowledge: number;
+    byStage: Record<number, number>;
+    byGate: Record<string, number>;
+    pendingReview: number;
+    averageConfidence: number;
+}
+export type EpistemicStatsView = EpistemicStats;
+export interface ParadigmDefinition {
+    id: 'spatial' | 'temporal' | 'hierarchical' | 'graph' | 'trust';
+    label: string;
+    description: string;
+    conceals: string;
+    icon: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/epistemic/types.d.ts.map

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

package/dist/epistemic/types.js

@@ -0,0 +1,18 @@
+// @kos/design-system — Epistemic transparency types
+// Derived from LEAP-EPISTEMIC-TRANSPARENCY-SPEC.md
+// Mapping from assay_confidence (u8, 0-255) to stage:
+// 0-50:    Stage 0 (Propose)
+// 51-100:  Stage 1 (Parse)
+// 101-150: Stage 2 (Authorize)
+// 151-190: Stage 3 (Execute)
+// 191-230: Stage 4 (Trace)
+// 231-255: Stage 5 (Replicate)
+export function confidenceToStage(confidence) {
+    const stage = confidence <= 50 ? 0 :
+        confidence <= 100 ? 1 :
+            confidence <= 150 ? 2 :
+                confidence <= 190 ? 3 :
+                    confidence <= 230 ? 4 : 5;
+    const names = ['Propose', 'Parse', 'Authorize', 'Execute', 'Trace', 'Replicate'];
+    return { stage, confidence: confidence / 255, stageName: names[stage] };
+}

package/dist/epistemic/utils.d.ts

@@ -0,0 +1,7 @@
+import type { ProvenanceChainNode } from './types.js';
+/**
+ * Returns a human-readable label for a provenance chain node type.
+ * Shared by ProvenanceChain and KnowledgeDetailPanel to avoid duplication.
+ */
+export declare function getProvenanceNodeLabel(node: ProvenanceChainNode): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/epistemic/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/epistemic/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAuBxE"}

package/dist/epistemic/utils.js

@@ -0,0 +1,29 @@
+// @kos/design-system — Epistemic shared utilities
+/**
+ * Returns a human-readable label for a provenance chain node type.
+ * Shared by ProvenanceChain and KnowledgeDetailPanel to avoid duplication.
+ */
+export function getProvenanceNodeLabel(node) {
+    switch (node.type) {
+        case 'human_draft': return 'Human drafted';
+        case 'file_source': return `File: ${node.detail.filePath}`;
+        case 'web_source': return `Web: ${node.detail.url}`;
+        case 'assay_evaluation': {
+            const d = node.detail;
+            return `ASSAY ${d.checkpoint} — ${d.gate} (${(d.weightedSum * 100).toFixed(0)}%)`;
+        }
+        case 'sigchain_witness': {
+            const d = node.detail;
+            return `Witnessed on sigchain — ${d.witnessRef}`;
+        }
+        case 'agent_research': return 'Agent research step';
+        case 'accord_replication': return 'Replicated via Accord';
+        case 'access_epoch': {
+            const d = node.detail;
+            return `${d.accessCount} accesses consolidated`;
+        }
+        case 'knowledge_merge': return 'Knowledge merge';
+        case 'supersession': return 'Supersedes prior entry';
+        default: return node.type;
+    }
+}

package/{src → dist}/f0-forms/checkbox/Checkbox.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-  interface Props {
+  export interface Props {
     checked?: boolean;
     label?: string;
     disabled?: boolean;
@@ -119,8 +119,8 @@
 
   .ds-checkbox.is-checked .ds-checkbox-box,
   .ds-checkbox.is-indeterminate .ds-checkbox-box {
-    background: var(--color-accent, #b87333);
-    border-color: var(--color-accent, #b87333);
+    background: var(--color-accent, var(--color-accent));
+    border-color: var(--color-accent, var(--color-accent));
   }
 
   .ds-checkbox.is-checked:hover:not(.is-disabled) .ds-checkbox-box,

package/dist/f0-forms/checkbox/Checkbox.svelte.d.ts

@@ -0,0 +1,14 @@
+export interface Props {
+    checked?: boolean;
+    label?: string;
+    disabled?: boolean;
+    indeterminate?: boolean;
+    class?: string;
+    id?: string;
+    name?: string;
+    onchange?: (e: Event) => void;
+}
+declare const Checkbox: import("svelte").Component<Props, {}, "checked">;
+type Checkbox = ReturnType<typeof Checkbox>;
+export default Checkbox;
+//# sourceMappingURL=Checkbox.svelte.d.ts.map

package/dist/f0-forms/checkbox/Checkbox.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checkbox.svelte.d.ts","sourceRoot":"","sources":["../../../src/f0-forms/checkbox/Checkbox.svelte.ts"],"names":[],"mappings":"AAGE,MAAM,WAAW,KAAK;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;CAC/B;AAkDH,QAAA,MAAM,QAAQ,kDAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/f0-forms/checkbox/Checkbox.test.js

@@ -0,0 +1,41 @@
+import { afterEach, describe, it, expect, vi } from 'vitest';
+import { cleanup, render, screen, fireEvent } from '@testing-library/svelte';
+import Checkbox from './Checkbox.svelte';
+describe('Checkbox', () => {
+    afterEach(() => cleanup());
+    it('renders a checkbox input', () => {
+        const { container } = render(Checkbox);
+        expect(container.querySelector('input[type="checkbox"]')).not.toBeNull();
+    });
+    it('toggles checked state on click', async () => {
+        const { container } = render(Checkbox);
+        const input = container.querySelector('input[type="checkbox"]');
+        expect(input.checked).toBe(false);
+        await fireEvent.click(input);
+        expect(input.checked).toBe(true);
+    });
+    it('sets indeterminate prop on the native input', () => {
+        const { container } = render(Checkbox, { indeterminate: true });
+        const input = container.querySelector('input[type="checkbox"]');
+        expect(input.indeterminate).toBe(true);
+    });
+    it('applies disabled class when disabled is true', () => {
+        const { container } = render(Checkbox, { disabled: true });
+        expect(container.querySelector('.is-disabled')).not.toBeNull();
+    });
+    it('renders label text when label prop provided', () => {
+        render(Checkbox, { label: 'Accept terms' });
+        expect(screen.getByText('Accept terms')).toBeDefined();
+    });
+    it('applies custom class to wrapper', () => {
+        const { container } = render(Checkbox, { class: 'my-checkbox' });
+        expect(container.querySelector('.my-checkbox')).not.toBeNull();
+    });
+    it('calls onchange when clicked', async () => {
+        const handleChange = vi.fn();
+        const { container } = render(Checkbox, { onchange: handleChange });
+        const input = container.querySelector('input[type="checkbox"]');
+        await fireEvent.click(input);
+        expect(handleChange).toHaveBeenCalledTimes(1);
+    });
+});

package/{src → dist}/f0-forms/field/FormField.svelte

@@ -1,7 +1,7 @@
 <script lang="ts">
   import type { Snippet } from 'svelte';
   
-  interface Props {
+  export interface Props {
     id: string; // Required for a11y linking
     label: string | Snippet;
     error?: string;

package/dist/f0-forms/field/FormField.svelte.d.ts

@@ -0,0 +1,13 @@
+import type { Snippet } from 'svelte';
+export interface Props {
+    id: string;
+    label: string | Snippet;
+    error?: string;
+    helper?: string;
+    class?: string;
+    children: Snippet;
+}
+declare const FormField: import("svelte").Component<Props, {}, "">;
+type FormField = ReturnType<typeof FormField>;
+export default FormField;
+//# sourceMappingURL=FormField.svelte.d.ts.map

package/dist/f0-forms/field/FormField.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormField.svelte.d.ts","sourceRoot":"","sources":["../../../src/f0-forms/field/FormField.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGpC,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CACnB;AA6CH,QAAA,MAAM,SAAS,2CAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/f0-forms/field/FormField.test.js

@@ -0,0 +1,103 @@
+import { afterEach, describe, it, expect } from 'vitest';
+import { cleanup, render } from '@testing-library/svelte';
+import FormField from './FormField.svelte';
+describe('FormField', () => {
+    afterEach(() => cleanup());
+    it('renders a label with the provided text', () => {
+        const { container } = render(FormField, {
+            props: {
+                id: 'name',
+                label: 'Name',
+                children: () => '<input />',
+            },
+        });
+        expect(container.querySelector('label')?.textContent).toContain('Name');
+    });
+    it('for on the label matches the id prop', () => {
+        const { container } = render(FormField, {
+            props: {
+                id: 'email',
+                label: 'Email',
+                children: () => '<input />',
+            },
+        });
+        expect(container.querySelector('label')?.getAttribute('for')).toBe('email');
+    });
+    it('renders the input container div', () => {
+        const { container } = render(FormField, {
+            props: {
+                id: 'test',
+                label: 'Test',
+                children: () => '<input />',
+            },
+        });
+        expect(container.querySelector('.ds-form-input-container')).not.toBeNull();
+    });
+    it('shows error message when error prop is provided', () => {
+        const { container } = render(FormField, {
+            props: {
+                id: 'field',
+                label: 'Field',
+                error: 'This field is required',
+                children: () => '<input />',
+            },
+        });
+        expect(container.querySelector('.ds-form-error-text')?.textContent).toBe('This field is required');
+    });
+    it('error span has role="alert"', () => {
+        const { container } = render(FormField, {
+            props: {
+                id: 'field',
+                label: 'Field',
+                error: 'Invalid',
+                children: () => '<input />',
+            },
+        });
+        expect(container.querySelector('[role="alert"]')).not.toBeNull();
+    });
+    it('renders helper text when helper prop is provided and no error', () => {
+        const { container } = render(FormField, {
+            props: {
+                id: 'field',
+                label: 'Field',
+                helper: 'Enter your full name',
+                children: () => '<input />',
+            },
+        });
+        expect(container.querySelector('.ds-form-helper-text')?.textContent).toBe('Enter your full name');
+    });
+    it('does not render helper text when error is present', () => {
+        const { container } = render(FormField, {
+            props: {
+                id: 'field',
+                label: 'Field',
+                error: 'Required',
+                helper: 'Some hint',
+                children: () => '<input />',
+            },
+        });
+        expect(container.querySelector('.ds-form-helper-text')).toBeNull();
+    });
+    it('helper text has correct id linked to field id', () => {
+        const { container } = render(FormField, {
+            props: {
+                id: 'username',
+                label: 'Username',
+                helper: 'Choose a unique name',
+                children: () => '<input />',
+            },
+        });
+        expect(container.querySelector('#username-helper')).not.toBeNull();
+    });
+    it('applies custom class to wrapper', () => {
+        const { container } = render(FormField, {
+            props: {
+                id: 'field',
+                label: 'Field',
+                class: 'my-field',
+                children: () => '<input />',
+            },
+        });
+        expect(container.querySelector('.my-field')).not.toBeNull();
+    });
+});

package/dist/f0-forms/index.d.ts

@@ -0,0 +1,17 @@
+export { default as FormField } from './field/FormField.svelte';
+export { default as SearchBar } from './search/SearchBar.svelte';
+export { default as TextArea } from './textarea/TextArea.svelte';
+export { default as Checkbox } from './checkbox/Checkbox.svelte';
+export { default as RadioGroup } from './radio/RadioGroup.svelte';
+export { default as Select } from './select/Select.svelte';
+export { default as FormToggle } from './toggle/FormToggle.svelte';
+export type { Props as FormFieldProps } from './field/FormField.svelte';
+export type { Props as SearchBarProps } from './search/SearchBar.svelte';
+export type { Props as TextAreaProps } from './textarea/TextArea.svelte';
+export type { Props as CheckboxProps } from './checkbox/Checkbox.svelte';
+export type { Props as RadioGroupProps } from './radio/RadioGroup.svelte';
+export type { Props as SelectProps } from './select/Select.svelte';
+export type { Props as FormToggleProps } from './toggle/FormToggle.svelte';
+export { required, minLength, maxLength, pattern, compose } from './validation/validate';
+export type { Validator } from './validation/validate';
+//# sourceMappingURL=index.d.ts.map

package/dist/f0-forms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/f0-forms/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,KAAK,IAAI,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACxE,YAAY,EAAE,KAAK,IAAI,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACzE,YAAY,EAAE,KAAK,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACzE,YAAY,EAAE,KAAK,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACzE,YAAY,EAAE,KAAK,IAAI,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC1E,YAAY,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACnE,YAAY,EAAE,KAAK,IAAI,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACzF,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC"}

package/{src/f0-forms/index.ts → dist/f0-forms/index.js}

@@ -1,5 +1,4 @@
 // F0 Forms — Form primitives and validation
-
 export { default as FormField } from './field/FormField.svelte';
 export { default as SearchBar } from './search/SearchBar.svelte';
 export { default as TextArea } from './textarea/TextArea.svelte';
@@ -8,4 +7,3 @@ export { default as RadioGroup } from './radio/RadioGroup.svelte';
 export { default as Select } from './select/Select.svelte';
 export { default as FormToggle } from './toggle/FormToggle.svelte';
 export { required, minLength, maxLength, pattern, compose } from './validation/validate';
-export type { Validator } from './validation/validate';