@sky.ui/mcp 0.0.1

package/dist/design-guidelines/review-engine.js

@@ -0,0 +1,179 @@
+import { loadDesignGuidelines } from './repository.js';
+function normalize(value) {
+    return value.trim().toLowerCase();
+}
+function extractWords(input) {
+    return input
+        .toLowerCase()
+        .split(/[^a-z0-9-]+/g)
+        .map((t) => t.trim())
+        .filter(Boolean);
+}
+function unique(items) {
+    return [...new Set(items)];
+}
+function severityRank(s) {
+    return s === 'high' ? 0 : s === 'medium' ? 1 : 2;
+}
+export function reviewComponentUsage(input) {
+    const loaded = loadDesignGuidelines();
+    if (!loaded.ok)
+        return { ok: false, error: loaded.error };
+    if (!Array.isArray(input.components) || input.components.length === 0) {
+        return { ok: false, error: 'components must contain at least one component name.' };
+    }
+    const findings = [];
+    const remediation = [];
+    let score = 100;
+    let recognizedComponents = 0;
+    const normalized = input.components.map((c) => normalize(c));
+    for (const component of normalized) {
+        const guideline = loaded.data.componentsByName.get(component);
+        if (!guideline) {
+            findings.push({
+                severity: 'medium',
+                component,
+                issue: 'No guideline coverage',
+                detail: 'This component is not present in the design-guideline dataset.'
+            });
+            remediation.push(`Add guideline coverage for ${component}.`);
+            score -= 15;
+            continue;
+        }
+        recognizedComponents += 1;
+        if (guideline.antiPatterns.length > 0) {
+            findings.push({
+                severity: 'low',
+                component: guideline.name,
+                issue: 'Known anti-patterns exist',
+                detail: `Review ${guideline.antiPatterns.length} anti-pattern guideline(s) before finalizing implementation.`
+            });
+            remediation.push(`Validate ${guideline.name} usage against anti-pattern guidance.`);
+            score -= 5;
+        }
+        if (guideline.a11yChecklist.length >= 2) {
+            score += 2;
+        }
+    }
+    if (recognizedComponents === 0) {
+        return { ok: false, error: 'None of the provided components have guideline coverage.' };
+    }
+    for (const primaryName of normalized) {
+        const primary = loaded.data.componentsByName.get(primaryName);
+        if (!primary)
+            continue;
+        for (const secondaryName of normalized) {
+            if (secondaryName === primaryName)
+                continue;
+            const conflict = primary.conflicts.find((c) => normalize(c.component) === secondaryName);
+            if (conflict) {
+                findings.push({
+                    severity: conflict.severity,
+                    component: primary.name,
+                    issue: `Conflict with ${secondaryName}`,
+                    detail: conflict.reason
+                });
+                remediation.push(`Avoid pairing ${primary.name} with ${secondaryName}; choose an alternative pattern.`);
+                score -= conflict.severity === 'high' ? 35 : conflict.severity === 'medium' ? 20 : 10;
+            }
+            const pairing = primary.pairings.find((p) => normalize(p.component) === secondaryName);
+            if (pairing && !conflict) {
+                findings.push({
+                    severity: 'low',
+                    component: primary.name,
+                    issue: `Supported pairing with ${secondaryName}`,
+                    detail: pairing.reason
+                });
+                score += 5;
+            }
+        }
+    }
+    score = Math.max(0, Math.min(100, score));
+    return {
+        ok: true,
+        body: {
+            schemaVersion: loaded.data.schemaVersion,
+            context: input.context ?? null,
+            reviewedComponents: input.components,
+            score,
+            confidence: score >= 80 ? 'high' : score >= 60 ? 'medium' : 'low',
+            findings: findings.sort((a, b) => {
+                return severityRank(a.severity) - severityRank(b.severity);
+            }),
+            remediation: unique(remediation)
+        }
+    };
+}
+export function reviewDesignSpec(input) {
+    const loaded = loadDesignGuidelines();
+    if (!loaded.ok)
+        return { ok: false, error: loaded.error };
+    const specText = input.spec?.trim();
+    if (!specText)
+        return { ok: false, error: 'spec must be a non-empty string.' };
+    const words = extractWords(specText);
+    const matchedPatterns = loaded.data.raw.patterns.filter((pattern) => {
+        const hay = `${pattern.id} ${pattern.title} ${pattern.intent}`.toLowerCase();
+        return words.some((word) => hay.includes(word));
+    });
+    const matchedComponents = loaded.data.raw.components.filter((component) => {
+        const hay = `${component.name} ${component.useWhen.join(' ')} ${component.avoidWhen.join(' ')}`.toLowerCase();
+        return words.some((word) => hay.includes(word));
+    });
+    const findings = [];
+    const remediation = [];
+    let score = 100;
+    if (matchedPatterns.length === 0) {
+        findings.push({
+            severity: 'high',
+            issue: 'No known pattern match',
+            detail: 'Spec does not map to any current design pattern guideline.'
+        });
+        remediation.push('Align the spec with a known pattern or add a new pattern guideline.');
+        score -= 40;
+    }
+    if (matchedComponents.length === 0) {
+        findings.push({
+            severity: 'medium',
+            issue: 'No component guideline match',
+            detail: 'Spec language does not reference any component with guideline coverage.'
+        });
+        remediation.push('Reference concrete components and expected states in the spec.');
+        score -= 20;
+    }
+    if (!/\b(accessibility|a11y|keyboard|aria|focus)\b/i.test(specText)) {
+        findings.push({
+            severity: 'medium',
+            issue: 'Missing accessibility acceptance criteria',
+            detail: 'Spec does not mention accessibility rules such as keyboard flow, focus, or ARIA.'
+        });
+        remediation.push('Add accessibility acceptance criteria (keyboard, focus management, ARIA semantics).');
+        score -= 20;
+    }
+    if (!/\b(state|loading|error|disabled|empty)\b/i.test(specText)) {
+        findings.push({
+            severity: 'low',
+            issue: 'Missing explicit state handling',
+            detail: 'Spec does not explicitly describe loading/error/empty/disabled states.'
+        });
+        remediation.push('Add state handling acceptance criteria (loading, error, empty, disabled).');
+        score -= 10;
+    }
+    score = Math.max(0, Math.min(100, score));
+    return {
+        ok: true,
+        body: {
+            schemaVersion: loaded.data.schemaVersion,
+            score,
+            confidence: score >= 80 ? 'high' : score >= 60 ? 'medium' : 'low',
+            matchedPatterns: matchedPatterns.map((pattern) => ({
+                id: pattern.id,
+                title: pattern.title
+            })),
+            matchedComponents: matchedComponents.map((component) => component.name),
+            findings,
+            remediation: unique(remediation)
+        }
+    };
+}
+//# sourceMappingURL=review-engine.js.map

package/dist/design-guidelines/review-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-engine.js","sourceRoot":"","sources":["../../src/design-guidelines/review-engine.ts"],"names":[],"mappings":"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"}

package/dist/design-guidelines/schema.d.ts

@@ -0,0 +1,256 @@
+import * as z from 'zod/v4';
+export declare const schemaVersionValue: "1.0.0";
+export declare const stateNodeSchema: z.ZodObject<{
+    state: z.ZodString;
+    description: z.ZodString;
+    triggers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const compositionRoleSchema: z.ZodObject<{
+    role: z.ZodString;
+    components: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const compatibilityPairingSchema: z.ZodObject<{
+    component: z.ZodString;
+    reason: z.ZodString;
+    glue: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const compatibilityConflictSchema: z.ZodObject<{
+    component: z.ZodString;
+    reason: z.ZodString;
+    severity: z.ZodDefault<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+}, z.core.$strip>;
+export declare const antiPatternSchema: z.ZodObject<{
+    condition: z.ZodString;
+    risk: z.ZodString;
+    replacement: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    migrationHint: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const componentGuidelineSchema: z.ZodObject<{
+    name: z.ZodString;
+    useWhen: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    avoidWhen: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    variants: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    stateMatrix: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        state: z.ZodString;
+        description: z.ZodString;
+        triggers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    compositionRoles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        role: z.ZodString;
+        components: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    pairings: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        component: z.ZodString;
+        reason: z.ZodString;
+        glue: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    conflicts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        component: z.ZodString;
+        reason: z.ZodString;
+        severity: z.ZodDefault<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+    }, z.core.$strip>>>;
+    antiPatterns: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        condition: z.ZodString;
+        risk: z.ZodString;
+        replacement: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        migrationHint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    propOptions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    a11yChecklist: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    keyboardMap: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    ariaRoles: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    focusRules: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const patternComponentNodeSchema: z.ZodObject<{
+    role: z.ZodString;
+    component: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const interactionStepSchema: z.ZodObject<{
+    step: z.ZodString;
+    actor: z.ZodString;
+    event: z.ZodOptional<z.ZodString>;
+    resultingState: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const patternGuidelineSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    intent: z.ZodString;
+    constraints: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    requiredComponents: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    optionalComponents: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    interactionFlow: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        step: z.ZodString;
+        actor: z.ZodString;
+        event: z.ZodOptional<z.ZodString>;
+        resultingState: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    failureStates: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    accessibilityRules: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    componentTree: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        role: z.ZodString;
+        component: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const tokenGuidelineSchema: z.ZodObject<{
+    semanticIntent: z.ZodString;
+    tokenSet: z.ZodObject<{
+        light: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        dark: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    forbiddenCombos: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    minContrast: z.ZodString;
+    densityMapping: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+export declare const methodGuidelineSchema: z.ZodObject<{
+    component: z.ZodString;
+    methodName: z.ZodString;
+    params: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        description: z.ZodString;
+    }, z.core.$strip>>;
+    returns: z.ZodObject<{
+        type: z.ZodString;
+        description: z.ZodString;
+    }, z.core.$strip>;
+    preconditions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    sideEffects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    commonErrors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Offline fallback for example-site enrichment in `get_sky_component_docs` when `SKY_UI_EXAMPLE_SITE_BASE_URL` is unset.
+ * Shapes should mirror `GET /api/mcp/manifest` and `GET /api/mcp/component/{id}` JSON from sky-ui-example
+ * (including optional `pageAi.customEvents` / `pageAi.publicMethods` and per-section `ai.customEventsInPlay` /
+ * `ai.publicMethodsInPlay` when present on embedded payloads).
+ */
+export declare const exampleSiteEmbedSchema: z.ZodObject<{
+    manifest: z.ZodOptional<z.ZodUnknown>;
+    components: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ExampleSiteEmbed = z.infer<typeof exampleSiteEmbedSchema>;
+export declare const designGuidelinesFileSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0.0">;
+    generatedAt: z.ZodOptional<z.ZodString>;
+    components: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        useWhen: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        avoidWhen: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        variants: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        stateMatrix: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            state: z.ZodString;
+            description: z.ZodString;
+            triggers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        compositionRoles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            role: z.ZodString;
+            components: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            notes: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        pairings: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            component: z.ZodString;
+            reason: z.ZodString;
+            glue: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        conflicts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            component: z.ZodString;
+            reason: z.ZodString;
+            severity: z.ZodDefault<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+            }>>;
+        }, z.core.$strip>>>;
+        antiPatterns: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            condition: z.ZodString;
+            risk: z.ZodString;
+            replacement: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            migrationHint: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        propOptions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+        a11yChecklist: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        keyboardMap: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        ariaRoles: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        focusRules: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        examples: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    patterns: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        intent: z.ZodString;
+        constraints: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        requiredComponents: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        optionalComponents: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        interactionFlow: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            step: z.ZodString;
+            actor: z.ZodString;
+            event: z.ZodOptional<z.ZodString>;
+            resultingState: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        failureStates: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        accessibilityRules: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        componentTree: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            role: z.ZodString;
+            component: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            notes: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    tokens: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        semanticIntent: z.ZodString;
+        tokenSet: z.ZodObject<{
+            light: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            dark: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        forbiddenCombos: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        minContrast: z.ZodString;
+        densityMapping: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>>>;
+    methods: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        component: z.ZodString;
+        methodName: z.ZodString;
+        params: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            description: z.ZodString;
+        }, z.core.$strip>>;
+        returns: z.ZodObject<{
+            type: z.ZodString;
+            description: z.ZodString;
+        }, z.core.$strip>;
+        preconditions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        sideEffects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        commonErrors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    exampleSiteEmbed: z.ZodOptional<z.ZodObject<{
+        manifest: z.ZodOptional<z.ZodUnknown>;
+        components: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type StateNode = z.infer<typeof stateNodeSchema>;
+export type CompositionRole = z.infer<typeof compositionRoleSchema>;
+export type AntiPattern = z.infer<typeof antiPatternSchema>;
+export type ComponentGuideline = z.infer<typeof componentGuidelineSchema>;
+export type PatternComponentNode = z.infer<typeof patternComponentNodeSchema>;
+export type InteractionStep = z.infer<typeof interactionStepSchema>;
+export type PatternGuideline = z.infer<typeof patternGuidelineSchema>;
+export type TokenGuideline = z.infer<typeof tokenGuidelineSchema>;
+export type MethodGuideline = z.infer<typeof methodGuidelineSchema>;
+export type DesignGuidelinesFile = z.infer<typeof designGuidelinesFileSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/design-guidelines/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/design-guidelines/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,kBAAkB,EAAG,OAAgB,CAAC;AAKnD,eAAO,MAAM,eAAe;;;;iBAI1B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;iBAIrC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;iBAItC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;iBAK5B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqBnC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;iBAKrC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;iBAWjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;iBAS/B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;iBAkBhC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;iBAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQrC,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/design-guidelines/schema.js

@@ -0,0 +1,124 @@
+import * as z from 'zod/v4';
+export const schemaVersionValue = '1.0.0';
+const nonEmpty = z.string().trim().min(1);
+const nonEmptyList = z.array(nonEmpty).default([]);
+export const stateNodeSchema = z.object({
+    state: nonEmpty,
+    description: nonEmpty,
+    triggers: nonEmptyList
+});
+export const compositionRoleSchema = z.object({
+    role: nonEmpty,
+    components: nonEmptyList,
+    notes: nonEmpty.optional()
+});
+export const compatibilityPairingSchema = z.object({
+    component: nonEmpty,
+    reason: nonEmpty,
+    glue: nonEmptyList
+});
+export const compatibilityConflictSchema = z.object({
+    component: nonEmpty,
+    reason: nonEmpty,
+    severity: z.enum(['low', 'medium', 'high']).default('medium')
+});
+export const antiPatternSchema = z.object({
+    condition: nonEmpty,
+    risk: nonEmpty,
+    replacement: nonEmptyList,
+    migrationHint: nonEmpty.optional()
+});
+export const componentGuidelineSchema = z.object({
+    name: nonEmpty,
+    useWhen: nonEmptyList,
+    avoidWhen: nonEmptyList,
+    variants: nonEmptyList,
+    stateMatrix: z.array(stateNodeSchema).default([]),
+    compositionRoles: z.array(compositionRoleSchema).default([]),
+    pairings: z.array(compatibilityPairingSchema).default([]),
+    conflicts: z.array(compatibilityConflictSchema).default([]),
+    antiPatterns: z.array(antiPatternSchema).default([]),
+    /**
+     * Explicit option dimensions by prop name (e.g. animationStyle, size, color, type, mode).
+     * Use this for non-visual and mixed behavior/style prop taxonomies.
+     * Values may include `""` when the component documents an empty default (e.g. sky-chart `theme`).
+     */
+    propOptions: z.record(z.string(), z.array(z.string())).default({}),
+    a11yChecklist: nonEmptyList,
+    keyboardMap: nonEmptyList,
+    ariaRoles: nonEmptyList,
+    focusRules: nonEmptyList,
+    examples: nonEmptyList
+});
+export const patternComponentNodeSchema = z.object({
+    role: nonEmpty,
+    component: nonEmpty,
+    required: z.boolean().default(true),
+    notes: nonEmpty.optional()
+});
+export const interactionStepSchema = z.object({
+    step: nonEmpty,
+    actor: nonEmpty,
+    event: nonEmpty.optional(),
+    resultingState: nonEmpty.optional()
+});
+export const patternGuidelineSchema = z.object({
+    id: nonEmpty,
+    title: nonEmpty,
+    intent: nonEmpty,
+    constraints: nonEmptyList,
+    requiredComponents: nonEmptyList,
+    optionalComponents: nonEmptyList,
+    interactionFlow: z.array(interactionStepSchema).default([]),
+    failureStates: nonEmptyList,
+    accessibilityRules: nonEmptyList,
+    componentTree: z.array(patternComponentNodeSchema).default([])
+});
+export const tokenGuidelineSchema = z.object({
+    semanticIntent: nonEmpty,
+    tokenSet: z.object({
+        light: nonEmptyList,
+        dark: nonEmptyList
+    }),
+    forbiddenCombos: nonEmptyList,
+    minContrast: nonEmpty,
+    densityMapping: z.record(z.string(), z.string())
+});
+export const methodGuidelineSchema = z.object({
+    component: nonEmpty,
+    methodName: nonEmpty,
+    params: z.array(z.object({
+        name: nonEmpty,
+        type: nonEmpty,
+        required: z.boolean().default(true),
+        description: nonEmpty
+    })),
+    returns: z.object({
+        type: nonEmpty,
+        description: nonEmpty
+    }),
+    preconditions: nonEmptyList,
+    sideEffects: nonEmptyList,
+    commonErrors: nonEmptyList
+});
+/**
+ * Offline fallback for example-site enrichment in `get_sky_component_docs` when `SKY_UI_EXAMPLE_SITE_BASE_URL` is unset.
+ * Shapes should mirror `GET /api/mcp/manifest` and `GET /api/mcp/component/{id}` JSON from sky-ui-example
+ * (including optional `pageAi.customEvents` / `pageAi.publicMethods` and per-section `ai.customEventsInPlay` /
+ * `ai.publicMethodsInPlay` when present on embedded payloads).
+ */
+export const exampleSiteEmbedSchema = z.object({
+    manifest: z.unknown().optional(),
+    /** Keys = component page ids (e.g. `accordion`); values = full component payload objects */
+    components: z.record(z.string(), z.unknown()).optional()
+});
+export const designGuidelinesFileSchema = z.object({
+    schemaVersion: z.literal(schemaVersionValue),
+    generatedAt: z.string().optional(),
+    components: z.array(componentGuidelineSchema).default([]),
+    patterns: z.array(patternGuidelineSchema).default([]),
+    tokens: z.array(tokenGuidelineSchema).default([]),
+    methods: z.array(methodGuidelineSchema).default([]),
+    exampleSiteEmbed: exampleSiteEmbedSchema.optional()
+});
+//# sourceMappingURL=schema.js.map

package/dist/design-guidelines/schema.js.map

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

package/dist/design-guidelines/token-engine.d.ts

@@ -0,0 +1,23 @@
+export declare function suggestTokensForIntent(input: {
+    intent: string;
+    theme?: 'light' | 'dark';
+    limit?: number;
+}): {
+    ok: true;
+    body: Record<string, unknown>;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function resolveTokenUsage(input: {
+    semantic_intent: string;
+    theme?: 'light' | 'dark';
+    density?: string;
+}): {
+    ok: true;
+    body: Record<string, unknown>;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=token-engine.d.ts.map

package/dist/design-guidelines/token-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-engine.d.ts","sourceRoot":"","sources":["../../src/design-guidelines/token-engine.ts"],"names":[],"mappings":"AAyCA,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAuC7E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA+B7E"}