@monoes/monodesign 1.2.5 → 1.2.6

package/dist/antipatterns.d.ts

@@ -0,0 +1,28 @@
+export type AntipatternCategory = 'slop' | 'quality' | 'performance' | 'accessibility';
+export interface AntipatternFinding {
+    id: string;
+    category: AntipatternCategory;
+    name: string;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    file?: string;
+    line?: number;
+}
+export interface DetectionResult {
+    findings: AntipatternFinding[];
+    fileCount: number;
+    durationMs: number;
+}
+/** True when the bundled detection engine can be loaded. */
+export declare function detectorAvailable(): Promise<boolean>;
+/**
+ * Run antipattern detection on a path (file, directory, or URL) using the
+ * bundled detection engine (cli/engine/detect-antipatterns.mjs). URL targets
+ * require the optional puppeteer dependency.
+ */
+export declare function detectAntipatterns(target: string): Promise<DetectionResult>;
+/**
+ * Format findings as a human-readable string for display in agent output.
+ */
+export declare function formatFindings(result: DetectionResult): string;
+//# sourceMappingURL=antipatterns.d.ts.map

package/dist/antipatterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"antipatterns.d.ts","sourceRoot":"","sources":["../src/antipatterns.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,eAAe,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAoCD,4DAA4D;AAC5D,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAE1D;AA8BD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAsCjF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CA2B9D"}

package/dist/antipatterns.js

@@ -0,0 +1,108 @@
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { extname } from 'node:path';
+// Typed as plain string so tsc emits a true dynamic import instead of trying
+// to type-resolve the untyped .mjs engine module.
+const ENGINE_SPECIFIER = '../cli/engine/detect-antipatterns.mjs';
+let enginePromise;
+async function loadEngine() {
+    enginePromise ??= import(ENGINE_SPECIFIER).then((mod) => mod, () => null);
+    return enginePromise;
+}
+/** True when the bundled detection engine can be loaded. */
+export async function detectorAvailable() {
+    return (await loadEngine()) !== null;
+}
+const HTML_EXTENSIONS = new Set(['.html', '.htm']);
+function mapSeverity(severity) {
+    if (severity === 'error')
+        return 'error';
+    if (severity === 'advisory' || severity === 'info')
+        return 'info';
+    return 'warning';
+}
+function toFinding(raw, categoryById) {
+    const id = String(raw.antipattern ?? raw.id ?? '');
+    return {
+        id,
+        category: (categoryById.get(id) ?? 'quality'),
+        name: String(raw.name ?? id),
+        severity: mapSeverity(raw.severity),
+        message: String(raw.description ?? raw.snippet ?? ''),
+        file: raw.file ? String(raw.file) : undefined,
+        line: raw.line ? Number(raw.line) : undefined,
+    };
+}
+async function detectFile(engine, filePath) {
+    if (HTML_EXTENSIONS.has(extname(filePath).toLowerCase())) {
+        return engine.detectHtml(filePath);
+    }
+    return engine.detectText(readFileSync(filePath, 'utf-8'), filePath);
+}
+/**
+ * Run antipattern detection on a path (file, directory, or URL) using the
+ * bundled detection engine (cli/engine/detect-antipatterns.mjs). URL targets
+ * require the optional puppeteer dependency.
+ */
+export async function detectAntipatterns(target) {
+    const engine = await loadEngine();
+    if (!engine) {
+        throw new Error('The monodesign detection engine could not be loaded. ' +
+            'Reinstall @monoes/monodesign (its cli/engine/ directory is missing or its dependencies are not installed).');
+    }
+    const start = Date.now();
+    const categoryById = new Map(engine.ANTIPATTERNS.map((ap) => [ap.id, ap.category ?? 'quality']));
+    let raw = [];
+    let fileCount = 0;
+    if (/^https?:\/\//i.test(target)) {
+        raw = await engine.detectUrl(target);
+        fileCount = 1;
+    }
+    else if (existsSync(target) && statSync(target).isDirectory()) {
+        const files = engine.walkDir(target);
+        fileCount = files.length;
+        for (const file of files) {
+            raw.push(...(await detectFile(engine, file)));
+        }
+    }
+    else if (existsSync(target)) {
+        raw = await detectFile(engine, target);
+        fileCount = 1;
+    }
+    else {
+        throw new Error(`Target not found: ${target}`);
+    }
+    return {
+        findings: raw.map((f) => toFinding(f, categoryById)),
+        fileCount,
+        durationMs: Date.now() - start,
+    };
+}
+/**
+ * Format findings as a human-readable string for display in agent output.
+ */
+export function formatFindings(result) {
+    if (result.findings.length === 0) {
+        return `No antipatterns detected in ${result.fileCount} file(s). (${result.durationMs}ms)`;
+    }
+    const byCategory = result.findings.reduce((acc, f) => {
+        (acc[f.category] ??= []).push(f);
+        return acc;
+    }, {});
+    const lines = [
+        `${result.findings.length} finding(s) in ${result.fileCount} file(s) — ${result.durationMs}ms`,
+        '',
+    ];
+    for (const [cat, items] of Object.entries(byCategory)) {
+        lines.push(`[${cat.toUpperCase()}]`);
+        for (const f of items) {
+            const loc = f.file ? `  ${f.file}${f.line ? `:${f.line}` : ''}` : '';
+            lines.push(`  ${f.severity === 'error' ? '✗' : '⚠'} ${f.name}`);
+            lines.push(`    ${f.message}`);
+            if (loc)
+                lines.push(loc);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=antipatterns.js.map

package/dist/antipatterns.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * monodesign — frontend design intelligence for AI agents
+ *
+ * Provides:
+ *   - Design tokens (OKLCH color system, spacing, motion, shadows)
+ *   - Antipattern detection (bundled engine at cli/engine/)
+ *   - Design rule constants
+ *   - Skill invocation helpers
+ */
+export * from './tokens.js';
+export * from './antipatterns.js';
+export * from './rules.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

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

@@ -7,7 +7,7 @@
  *   - Design rule constants
  *   - Skill invocation helpers
  */
-
 export * from './tokens.js';
 export * from './antipatterns.js';
 export * from './rules.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC"}

package/dist/rules.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared design rules — the invariants every monodesign generation must satisfy.
+ * These mirror the "Absolute bans" and "Shared design laws" in the skill.
+ *
+ * Where a ban has a corresponding mechanical detector rule in the engine
+ * registry (cli/engine/registry/antipatterns.mjs), its id and description are
+ * pulled from that registry at load time instead of being hand-copied here —
+ * one source of truth, no drift between "what generation avoids" and "what
+ * detection flags". Bans with no `engineRuleId` are composition/judgment
+ * calls the detector cannot mechanically check (holistic layout patterns);
+ * they exist here for generation-time guidance only.
+ */
+export interface AbsoluteBan {
+    id: string;
+    rule: string;
+    description: string;
+    /** Engine registry rule id this ban is mechanically detected by, if any. */
+    engineRuleId?: string;
+}
+/** Static ban list — id/rule/description as authored here (may drift from the engine registry's wording for bans that also have a detector rule). */
+export declare const ABSOLUTE_BANS: AbsoluteBan[];
+/**
+ * Same ban list, with descriptions for detector-backed bans (`engineRuleId`
+ * set) replaced by the live text from the engine registry. Falls back to the
+ * static description when the registry can't be loaded (e.g. package not
+ * fully installed) or the referenced rule id is missing.
+ */
+export declare function getAbsoluteBans(): Promise<AbsoluteBan[]>;
+export declare const COLOR_STRATEGIES: readonly ['restrained', 'committed', 'full-palette', 'drenched'];
+export type ColorStrategy = (typeof COLOR_STRATEGIES)[number];
+export declare const SHADOW_MAX_ALPHA = 0.15;
+/** Validates a shadow string does not exceed the max alpha. */
+export declare function shadowAlphaComplies(shadow: string): boolean;
+export type Register = 'brand' | 'product';
+/** Infer register from surface description heuristic. */
+export declare function inferRegister(surface: string): Register;
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAsBH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA2CD,qJAAqJ;AACrJ,eAAO,MAAM,aAAa,eAAuB,CAAC;AAElD;;;;;GAKG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAQ9D;AAED,eAAO,MAAM,gBAAgB,YAAI,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,CAAU,CAAC;AACjG,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAQ3D;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3C,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAQvD"}

package/dist/rules.js

@@ -0,0 +1,97 @@
+/**
+ * Shared design rules — the invariants every monodesign generation must satisfy.
+ * These mirror the "Absolute bans" and "Shared design laws" in the skill.
+ *
+ * Where a ban has a corresponding mechanical detector rule in the engine
+ * registry (cli/engine/registry/antipatterns.mjs), its id and description are
+ * pulled from that registry at load time instead of being hand-copied here —
+ * one source of truth, no drift between "what generation avoids" and "what
+ * detection flags". Bans with no `engineRuleId` are composition/judgment
+ * calls the detector cannot mechanically check (holistic layout patterns);
+ * they exist here for generation-time guidance only.
+ */
+// Typed as plain string so tsc emits a true dynamic import instead of trying
+// to type-resolve the untyped .mjs engine module (matches antipatterns.ts).
+const REGISTRY_SPECIFIER = '../cli/engine/registry/antipatterns.mjs';
+let registryPromise;
+async function loadRegistry() {
+    registryPromise ??= import(REGISTRY_SPECIFIER).then((mod) => mod.ANTIPATTERNS, () => null);
+    return registryPromise;
+}
+const ABSOLUTE_BANS_STATIC = [
+    {
+        id: 'side-tab',
+        rule: 'No side-stripe borders',
+        description: 'border-left or border-right > 1px as a colored accent on cards/list items/callouts is never intentional. Rewrite with full borders, background tints, leading numbers/icons, or nothing.',
+        engineRuleId: 'side-tab',
+    },
+    {
+        id: 'gradient-text',
+        rule: 'No gradient text',
+        description: 'background-clip:text with a gradient is decorative and never meaningful. Use a single solid color; emphasis via weight or size.',
+        engineRuleId: 'gradient-text',
+    },
+    {
+        id: 'glassmorphism-default',
+        rule: 'No glassmorphism as default',
+        description: 'Blurs and glass cards used decoratively. Rare and purposeful, or nothing.',
+    },
+    {
+        id: 'hero-metric-template',
+        rule: 'No hero-metric template',
+        description: 'Big number + small label + supporting stats + gradient accent is a SaaS cliché. Find a distinctive composition instead.',
+    },
+    {
+        id: 'identical-card-grid',
+        rule: 'No identical card grids',
+        description: 'Same-sized cards with icon + heading + text, repeated endlessly, signals a lack of hierarchy. Vary size, weight, or content structure.',
+    },
+    {
+        id: 'modal-first',
+        rule: 'Modal is not the first thought',
+        description: 'Modals are usually laziness. Exhaust inline / progressive disclosure alternatives first.',
+    },
+];
+/** Static ban list — id/rule/description as authored here (may drift from the engine registry's wording for bans that also have a detector rule). */
+export const ABSOLUTE_BANS = ABSOLUTE_BANS_STATIC;
+/**
+ * Same ban list, with descriptions for detector-backed bans (`engineRuleId`
+ * set) replaced by the live text from the engine registry. Falls back to the
+ * static description when the registry can't be loaded (e.g. package not
+ * fully installed) or the referenced rule id is missing.
+ */
+export async function getAbsoluteBans() {
+    const registry = await loadRegistry();
+    if (!registry)
+        return ABSOLUTE_BANS_STATIC;
+    const byId = new Map(registry.map((r) => [r.id, r]));
+    return ABSOLUTE_BANS_STATIC.map((ban) => {
+        const engineRule = ban.engineRuleId ? byId.get(ban.engineRuleId) : undefined;
+        return engineRule ? { ...ban, description: engineRule.description } : ban;
+    });
+}
+export const COLOR_STRATEGIES = ['restrained', 'committed', 'full-palette', 'drenched'];
+export const SHADOW_MAX_ALPHA = 0.15;
+/** Validates a shadow string does not exceed the max alpha. */
+export function shadowAlphaComplies(shadow) {
+    const matches = shadow.match(/rgba?\([^)]+\)/g) ?? [];
+    for (const m of matches) {
+        const parts = m.replace(/rgba?\(/, '').replace(')', '').split(',').map(Number);
+        const alpha = parts.length === 4 ? parts[3] : 1;
+        if (alpha > SHADOW_MAX_ALPHA)
+            return false;
+    }
+    return true;
+}
+/** Infer register from surface description heuristic. */
+export function inferRegister(surface) {
+    const lower = surface.toLowerCase();
+    const brandKeywords = ['landing', 'marketing', 'campaign', 'homepage', 'portfolio', 'blog'];
+    const productKeywords = ['dashboard', 'admin', 'app', 'settings', 'onboard', 'console'];
+    if (brandKeywords.some((k) => lower.includes(k)))
+        return 'brand';
+    if (productKeywords.some((k) => lower.includes(k)))
+        return 'product';
+    return 'product'; // safe default
+}
+//# sourceMappingURL=rules.js.map

package/dist/rules.js.map

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

package/dist/tokens.d.ts

@@ -0,0 +1,91 @@
+/** Design tokens as typed JS constants — mirrors tokens.css */
+export declare const fontFamily: {
+    readonly display: "'Cormorant Garamond', Georgia, serif";
+    readonly body: "'Instrument Sans', system-ui, sans-serif";
+    readonly mono: "'Space Grotesk', monospace";
+};
+export declare const fontSize: {
+    readonly xs: '0.75rem';
+    readonly sm: '0.875rem';
+    readonly base: '1rem';
+    readonly lg: '1.125rem';
+    readonly xl: '1.25rem';
+    readonly '2xl': '1.5rem';
+    readonly '3xl': '1.875rem';
+    readonly '4xl': '2.25rem';
+    readonly '5xl': '3rem';
+    readonly '6xl': '3.75rem';
+    readonly '7xl': '4.5rem';
+};
+export declare const spacing: {
+    readonly 1: '4px';
+    readonly 2: '8px';
+    readonly 3: '12px';
+    readonly 4: '16px';
+    readonly 5: '20px';
+    readonly 6: '24px';
+    readonly 7: '28px';
+    readonly 8: '32px';
+    readonly 10: '40px';
+    readonly 12: '48px';
+    readonly 16: '64px';
+    readonly 20: '80px';
+    readonly 24: '96px';
+    readonly 30: '120px';
+};
+export declare const easing: {
+    readonly out: 'cubic-bezier(0.16, 1, 0.3, 1)';
+    readonly outQuint: 'cubic-bezier(0.22, 1, 0.36, 1)';
+    readonly inOut: 'cubic-bezier(0.65, 0, 0.35, 1)';
+    readonly in: 'cubic-bezier(0.4, 0, 1, 1)';
+};
+export declare const duration: {
+    readonly instant: '0s';
+    readonly fast: '0.15s';
+    readonly base: '0.3s';
+    readonly slow: '0.6s';
+    readonly slower: '0.8s';
+    readonly slowest: '1.2s';
+};
+/** OKLCH color palette */
+export declare const color: {
+    readonly ink: 'oklch(10% 0 0)';
+    readonly charcoal: 'oklch(25% 0 0)';
+    readonly ash: 'oklch(55% 0 0)';
+    readonly mist: 'oklch(92% 0 0)';
+    readonly cream: 'oklch(96% 0.005 350)';
+    readonly paper: 'oklch(98% 0 0)';
+    readonly white: 'oklch(99.5% 0 0)';
+    readonly accent: 'oklch(60% 0.25 350)';
+    readonly accentHover: 'oklch(52% 0.25 350)';
+    readonly accentDim: 'oklch(60% 0.25 350 / 0.15)';
+    readonly accentSoft: 'oklch(60% 0.25 350 / 0.25)';
+    readonly accentText: 'oklch(45% 0.22 350)';
+};
+export declare const accentScale: {
+    readonly 1: 'oklch(22% 0.15 350)';
+    readonly 2: 'oklch(33% 0.20 350)';
+    readonly 3: 'oklch(42% 0.23 350)';
+    readonly 4: 'oklch(52% 0.25 350)';
+    readonly 5: 'oklch(60% 0.25 350)';
+    readonly 6: 'oklch(68% 0.22 350)';
+    readonly 7: 'oklch(76% 0.18 350)';
+    readonly 8: 'oklch(84% 0.12 350)';
+    readonly 9: 'oklch(94% 0.05 350)';
+};
+export declare const shadow: {
+    readonly none: 'none';
+    readonly sm: '0 1px 3px rgba(0, 0, 0, 0.06)';
+    readonly md: '0 4px 24px -4px rgba(0, 0, 0, 0.12), 0 1px 3px rgba(0, 0, 0, 0.06)';
+    readonly lg: '0 20px 40px rgba(0, 0, 0, 0.08)';
+    readonly accent: '0 20px 60px oklch(60% 0.25 350 / 0.15)';
+};
+export declare const radius: {
+    readonly none: '0';
+    readonly sm: '4px';
+    readonly md: '8px';
+    readonly lg: '12px';
+    readonly xl: '16px';
+    readonly full: '9999px';
+};
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,eAAO,MAAM,UAAU;aACrB,OAAO,EAAE,sCAAsC;aAC/C,IAAI,EAAE,0CAA0C;aAChD,IAAI,EAAE,4BAA4B;CAC1B,CAAC;AAEX,eAAO,MAAM,QAAQ;aACnB,EAAE,EAAE,SAAS;aACb,EAAE,EAAE,UAAU;aACd,IAAI,EAAE,MAAM;aACZ,EAAE,EAAE,UAAU;aACd,EAAE,EAAE,SAAS;aACb,KAAK,EAAE,QAAQ;aACf,KAAK,EAAE,UAAU;aACjB,KAAK,EAAE,SAAS;aAChB,KAAK,EAAE,MAAM;aACb,KAAK,EAAE,SAAS;aAChB,KAAK,EAAE,QAAQ;CACP,CAAC;AAEX,eAAO,MAAM,OAAO;aAClB,CAAC,EAAE,KAAK;aACR,CAAC,EAAE,KAAK;aACR,CAAC,EAAE,MAAM;aACT,CAAC,EAAE,MAAM;aACT,CAAC,EAAE,MAAM;aACT,CAAC,EAAE,MAAM;aACT,CAAC,EAAE,MAAM;aACT,CAAC,EAAE,MAAM;aACT,EAAE,EAAE,MAAM;aACV,EAAE,EAAE,MAAM;aACV,EAAE,EAAE,MAAM;aACV,EAAE,EAAE,MAAM;aACV,EAAE,EAAE,MAAM;aACV,EAAE,EAAE,OAAO;CACH,CAAC;AAEX,eAAO,MAAM,MAAM;aACjB,GAAG,EAAE,+BAA+B;aACpC,QAAQ,EAAE,gCAAgC;aAC1C,KAAK,EAAE,gCAAgC;aACvC,EAAE,EAAE,4BAA4B;CACxB,CAAC;AAEX,eAAO,MAAM,QAAQ;aACnB,OAAO,EAAE,IAAI;aACb,IAAI,EAAE,OAAO;aACb,IAAI,EAAE,MAAM;aACZ,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,MAAM;aACd,OAAO,EAAE,MAAM;CACP,CAAC;AAEX,0BAA0B;AAC1B,eAAO,MAAM,KAAK;aAChB,GAAG,EAAE,gBAAgB;aACrB,QAAQ,EAAE,gBAAgB;aAC1B,GAAG,EAAE,gBAAgB;aACrB,IAAI,EAAE,gBAAgB;aACtB,KAAK,EAAE,sBAAsB;aAC7B,KAAK,EAAE,gBAAgB;aACvB,KAAK,EAAE,kBAAkB;aACzB,MAAM,EAAE,qBAAqB;aAC7B,WAAW,EAAE,qBAAqB;aAClC,SAAS,EAAE,4BAA4B;aACvC,UAAU,EAAE,4BAA4B;aACxC,UAAU,EAAE,qBAAqB;CACzB,CAAC;AAEX,eAAO,MAAM,WAAW;aACtB,CAAC,EAAE,qBAAqB;aACxB,CAAC,EAAE,qBAAqB;aACxB,CAAC,EAAE,qBAAqB;aACxB,CAAC,EAAE,qBAAqB;aACxB,CAAC,EAAE,qBAAqB;aACxB,CAAC,EAAE,qBAAqB;aACxB,CAAC,EAAE,qBAAqB;aACxB,CAAC,EAAE,qBAAqB;aACxB,CAAC,EAAE,qBAAqB;CAChB,CAAC;AAEX,eAAO,MAAM,MAAM;aACjB,IAAI,EAAE,MAAM;aACZ,EAAE,EAAE,+BAA+B;aACnC,EAAE,EAAE,oEAAoE;aACxE,EAAE,EAAE,iCAAiC;aACrC,MAAM,EAAE,wCAAwC;CACxC,CAAC;AAEX,eAAO,MAAM,MAAM;aACjB,IAAI,EAAE,GAAG;aACT,EAAE,EAAE,KAAK;aACT,EAAE,EAAE,KAAK;aACT,EAAE,EAAE,MAAM;aACV,EAAE,EAAE,MAAM;aACV,IAAI,EAAE,QAAQ;CACN,CAAC"}

package/dist/tokens.js

@@ -0,0 +1,91 @@
+/** Design tokens as typed JS constants — mirrors tokens.css */
+export const fontFamily = {
+    display: "'Cormorant Garamond', Georgia, serif",
+    body: "'Instrument Sans', system-ui, sans-serif",
+    mono: "'Space Grotesk', monospace",
+};
+export const fontSize = {
+    xs: '0.75rem',
+    sm: '0.875rem',
+    base: '1rem',
+    lg: '1.125rem',
+    xl: '1.25rem',
+    '2xl': '1.5rem',
+    '3xl': '1.875rem',
+    '4xl': '2.25rem',
+    '5xl': '3rem',
+    '6xl': '3.75rem',
+    '7xl': '4.5rem',
+};
+export const spacing = {
+    1: '4px',
+    2: '8px',
+    3: '12px',
+    4: '16px',
+    5: '20px',
+    6: '24px',
+    7: '28px',
+    8: '32px',
+    10: '40px',
+    12: '48px',
+    16: '64px',
+    20: '80px',
+    24: '96px',
+    30: '120px',
+};
+export const easing = {
+    out: 'cubic-bezier(0.16, 1, 0.3, 1)',
+    outQuint: 'cubic-bezier(0.22, 1, 0.36, 1)',
+    inOut: 'cubic-bezier(0.65, 0, 0.35, 1)',
+    in: 'cubic-bezier(0.4, 0, 1, 1)',
+};
+export const duration = {
+    instant: '0s',
+    fast: '0.15s',
+    base: '0.3s',
+    slow: '0.6s',
+    slower: '0.8s',
+    slowest: '1.2s',
+};
+/** OKLCH color palette */
+export const color = {
+    ink: 'oklch(10% 0 0)',
+    charcoal: 'oklch(25% 0 0)',
+    ash: 'oklch(55% 0 0)',
+    mist: 'oklch(92% 0 0)',
+    cream: 'oklch(96% 0.005 350)',
+    paper: 'oklch(98% 0 0)',
+    white: 'oklch(99.5% 0 0)',
+    accent: 'oklch(60% 0.25 350)',
+    accentHover: 'oklch(52% 0.25 350)',
+    accentDim: 'oklch(60% 0.25 350 / 0.15)',
+    accentSoft: 'oklch(60% 0.25 350 / 0.25)',
+    accentText: 'oklch(45% 0.22 350)',
+};
+export const accentScale = {
+    1: 'oklch(22% 0.15 350)',
+    2: 'oklch(33% 0.20 350)',
+    3: 'oklch(42% 0.23 350)',
+    4: 'oklch(52% 0.25 350)',
+    5: 'oklch(60% 0.25 350)',
+    6: 'oklch(68% 0.22 350)',
+    7: 'oklch(76% 0.18 350)',
+    8: 'oklch(84% 0.12 350)',
+    9: 'oklch(94% 0.05 350)',
+};
+export const shadow = {
+    none: 'none',
+    sm: '0 1px 3px rgba(0, 0, 0, 0.06)',
+    md: '0 4px 24px -4px rgba(0, 0, 0, 0.12), 0 1px 3px rgba(0, 0, 0, 0.06)',
+    lg: '0 20px 40px rgba(0, 0, 0, 0.08)',
+    accent: '0 20px 60px oklch(60% 0.25 350 / 0.15)',
+};
+export const radius = {
+    none: '0',
+    sm: '4px',
+    md: '8px',
+    lg: '12px',
+    xl: '16px',
+    full: '9999px',
+};
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,sCAAsC;IAC/C,IAAI,EAAE,0CAA0C;IAChD,IAAI,EAAE,4BAA4B;CAC1B,CAAC;AAEX,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,UAAU;IACd,EAAE,EAAE,SAAS;IACb,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,QAAQ;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;IACT,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,OAAO;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,EAAE,+BAA+B;IACpC,QAAQ,EAAE,gCAAgC;IAC1C,KAAK,EAAE,gCAAgC;IACvC,EAAE,EAAE,4BAA4B;CACxB,CAAC;AAEX,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,MAAM;CACP,CAAC;AAEX,0BAA0B;AAC1B,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,GAAG,EAAE,gBAAgB;IACrB,QAAQ,EAAE,gBAAgB;IAC1B,GAAG,EAAE,gBAAgB;IACrB,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,sBAAsB;IAC7B,KAAK,EAAE,gBAAgB;IACvB,KAAK,EAAE,kBAAkB;IACzB,MAAM,EAAE,qBAAqB;IAC7B,WAAW,EAAE,qBAAqB;IAClC,SAAS,EAAE,4BAA4B;IACvC,UAAU,EAAE,4BAA4B;IACxC,UAAU,EAAE,qBAAqB;CACzB,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,qBAAqB;IACxB,CAAC,EAAE,qBAAqB;CAChB,CAAC;AAEX,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,+BAA+B;IACnC,EAAE,EAAE,oEAAoE;IACxE,EAAE,EAAE,iCAAiC;IACrC,MAAM,EAAE,wCAAwC;CACxC,CAAC;AAEX,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,GAAG;IACT,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,QAAQ;CACN,CAAC"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@monoes/monodesign",
-  "version": "1.2.5",
+  "version": "1.2.6",
   "description": "Frontend design intelligence for AI agents — design tokens, antipattern detection, and the monodesign skill",
   "type": "module",
-  "main": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
+    ".": "./dist/index.js",
     "./tokens": "./src/tokens.css",
     "./engine": "./cli/engine/detect-antipatterns.mjs",
     "./engine/browser": "./cli/engine/detect-antipatterns-browser.js"
@@ -15,10 +16,18 @@
   },
   "files": [
     "cli/",
+    "dist/",
     "skill/",
-    "src/",
+    "src/tokens.css",
     "NOTICE.md"
   ],
+  "scripts": {
+    "prebuild": "node ../../../scripts/build-fs.mjs clean dist tsconfig.tsbuildinfo",
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "node scripts/run-tests.mjs",
+    "sync": "node scripts/sync-skill.mjs"
+  },
   "keywords": [
     "design-system",
     "design-tokens",
@@ -41,10 +50,5 @@
   "optionalDependencies": {
     "@monoes/monobrowse": "^1.0.7",
     "puppeteer": "^25.1.0"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "node scripts/run-tests.mjs",
-    "sync": "node scripts/sync-skill.mjs"
   }
-}
+}

package/src/antipatterns.ts

@@ -1,164 +0,0 @@
-import { existsSync, readFileSync, statSync } from 'node:fs';
-import { extname } from 'node:path';
-
-export type AntipatternCategory = 'slop' | 'quality' | 'performance' | 'accessibility';
-
-export interface AntipatternFinding {
-  id: string;
-  category: AntipatternCategory;
-  name: string;
-  severity: 'error' | 'warning' | 'info';
-  message: string;
-  file?: string;
-  line?: number;
-}
-
-export interface DetectionResult {
-  findings: AntipatternFinding[];
-  fileCount: number;
-  durationMs: number;
-}
-
-// Shape of the bundled engine (cli/engine/detect-antipatterns.mjs).
-interface DetectorEngine {
-  detectText: (content: string, filePath: string, options?: Record<string, unknown>) => RawFinding[];
-  detectHtml: (filePath: string, options?: Record<string, unknown>) => Promise<RawFinding[]>;
-  detectUrl: (url: string, options?: Record<string, unknown>) => Promise<RawFinding[]>;
-  walkDir: (dir: string) => string[];
-  ANTIPATTERNS: Array<{ id: string; category?: string; severity?: string }>;
-}
-
-interface RawFinding {
-  antipattern?: string;
-  id?: string;
-  name?: string;
-  description?: string;
-  severity?: string;
-  file?: string;
-  line?: number;
-  snippet?: string;
-}
-
-// Typed as plain string so tsc emits a true dynamic import instead of trying
-// to type-resolve the untyped .mjs engine module.
-const ENGINE_SPECIFIER: string = '../cli/engine/detect-antipatterns.mjs';
-
-let enginePromise: Promise<DetectorEngine | null> | undefined;
-
-async function loadEngine(): Promise<DetectorEngine | null> {
-  enginePromise ??= import(ENGINE_SPECIFIER).then(
-    (mod) => mod as unknown as DetectorEngine,
-    () => null,
-  );
-  return enginePromise;
-}
-
-/** True when the bundled detection engine can be loaded. */
-export async function detectorAvailable(): Promise<boolean> {
-  return (await loadEngine()) !== null;
-}
-
-const HTML_EXTENSIONS = new Set(['.html', '.htm']);
-
-function mapSeverity(severity: string | undefined): AntipatternFinding['severity'] {
-  if (severity === 'error') return 'error';
-  if (severity === 'advisory' || severity === 'info') return 'info';
-  return 'warning';
-}
-
-function toFinding(raw: RawFinding, categoryById: Map<string, string>): AntipatternFinding {
-  const id = String(raw.antipattern ?? raw.id ?? '');
-  return {
-    id,
-    category: (categoryById.get(id) ?? 'quality') as AntipatternCategory,
-    name: String(raw.name ?? id),
-    severity: mapSeverity(raw.severity),
-    message: String(raw.description ?? raw.snippet ?? ''),
-    file: raw.file ? String(raw.file) : undefined,
-    line: raw.line ? Number(raw.line) : undefined,
-  };
-}
-
-async function detectFile(engine: DetectorEngine, filePath: string): Promise<RawFinding[]> {
-  if (HTML_EXTENSIONS.has(extname(filePath).toLowerCase())) {
-    return engine.detectHtml(filePath);
-  }
-  return engine.detectText(readFileSync(filePath, 'utf-8'), filePath);
-}
-
-/**
- * Run antipattern detection on a path (file, directory, or URL) using the
- * bundled detection engine (cli/engine/detect-antipatterns.mjs). URL targets
- * require the optional puppeteer dependency.
- */
-export async function detectAntipatterns(target: string): Promise<DetectionResult> {
-  const engine = await loadEngine();
-  if (!engine) {
-    throw new Error(
-      'The monodesign detection engine could not be loaded. ' +
-        'Reinstall @monoes/monodesign (its cli/engine/ directory is missing or its dependencies are not installed).',
-    );
-  }
-
-  const start = Date.now();
-  const categoryById = new Map(
-    engine.ANTIPATTERNS.map((ap) => [ap.id, ap.category ?? 'quality']),
-  );
-
-  let raw: RawFinding[] = [];
-  let fileCount = 0;
-
-  if (/^https?:\/\//i.test(target)) {
-    raw = await engine.detectUrl(target);
-    fileCount = 1;
-  } else if (existsSync(target) && statSync(target).isDirectory()) {
-    const files = engine.walkDir(target);
-    fileCount = files.length;
-    for (const file of files) {
-      raw.push(...(await detectFile(engine, file)));
-    }
-  } else if (existsSync(target)) {
-    raw = await detectFile(engine, target);
-    fileCount = 1;
-  } else {
-    throw new Error(`Target not found: ${target}`);
-  }
-
-  return {
-    findings: raw.map((f) => toFinding(f, categoryById)),
-    fileCount,
-    durationMs: Date.now() - start,
-  };
-}
-
-/**
- * Format findings as a human-readable string for display in agent output.
- */
-export function formatFindings(result: DetectionResult): string {
-  if (result.findings.length === 0) {
-    return `No antipatterns detected in ${result.fileCount} file(s). (${result.durationMs}ms)`;
-  }
-
-  const byCategory = result.findings.reduce<Record<string, AntipatternFinding[]>>((acc, f) => {
-    (acc[f.category] ??= []).push(f);
-    return acc;
-  }, {});
-
-  const lines: string[] = [
-    `${result.findings.length} finding(s) in ${result.fileCount} file(s) — ${result.durationMs}ms`,
-    '',
-  ];
-
-  for (const [cat, items] of Object.entries(byCategory)) {
-    lines.push(`[${cat.toUpperCase()}]`);
-    for (const f of items) {
-      const loc = f.file ? `  ${f.file}${f.line ? `:${f.line}` : ''}` : '';
-      lines.push(`  ${f.severity === 'error' ? '✗' : '⚠'} ${f.name}`);
-      lines.push(`    ${f.message}`);
-      if (loc) lines.push(loc);
-    }
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}

package/src/rules.ts

@@ -1,129 +0,0 @@
-/**
- * Shared design rules — the invariants every monodesign generation must satisfy.
- * These mirror the "Absolute bans" and "Shared design laws" in the skill.
- *
- * Where a ban has a corresponding mechanical detector rule in the engine
- * registry (cli/engine/registry/antipatterns.mjs), its id and description are
- * pulled from that registry at load time instead of being hand-copied here —
- * one source of truth, no drift between "what generation avoids" and "what
- * detection flags". Bans with no `engineRuleId` are composition/judgment
- * calls the detector cannot mechanically check (holistic layout patterns);
- * they exist here for generation-time guidance only.
- */
-
-// Typed as plain string so tsc emits a true dynamic import instead of trying
-// to type-resolve the untyped .mjs engine module (matches antipatterns.ts).
-const REGISTRY_SPECIFIER: string = '../cli/engine/registry/antipatterns.mjs';
-
-interface EngineRuleEntry {
-  id: string;
-  name: string;
-  description: string;
-}
-
-let registryPromise: Promise<EngineRuleEntry[] | null> | undefined;
-
-async function loadRegistry(): Promise<EngineRuleEntry[] | null> {
-  registryPromise ??= import(REGISTRY_SPECIFIER).then(
-    (mod) => (mod as { ANTIPATTERNS: EngineRuleEntry[] }).ANTIPATTERNS,
-    () => null,
-  );
-  return registryPromise;
-}
-
-export interface AbsoluteBan {
-  id: string;
-  rule: string;
-  description: string;
-  /** Engine registry rule id this ban is mechanically detected by, if any. */
-  engineRuleId?: string;
-}
-
-const ABSOLUTE_BANS_STATIC: AbsoluteBan[] = [
-  {
-    id: 'side-tab',
-    rule: 'No side-stripe borders',
-    description:
-      'border-left or border-right > 1px as a colored accent on cards/list items/callouts is never intentional. Rewrite with full borders, background tints, leading numbers/icons, or nothing.',
-    engineRuleId: 'side-tab',
-  },
-  {
-    id: 'gradient-text',
-    rule: 'No gradient text',
-    description:
-      'background-clip:text with a gradient is decorative and never meaningful. Use a single solid color; emphasis via weight or size.',
-    engineRuleId: 'gradient-text',
-  },
-  {
-    id: 'glassmorphism-default',
-    rule: 'No glassmorphism as default',
-    description:
-      'Blurs and glass cards used decoratively. Rare and purposeful, or nothing.',
-  },
-  {
-    id: 'hero-metric-template',
-    rule: 'No hero-metric template',
-    description:
-      'Big number + small label + supporting stats + gradient accent is a SaaS cliché. Find a distinctive composition instead.',
-  },
-  {
-    id: 'identical-card-grid',
-    rule: 'No identical card grids',
-    description:
-      'Same-sized cards with icon + heading + text, repeated endlessly, signals a lack of hierarchy. Vary size, weight, or content structure.',
-  },
-  {
-    id: 'modal-first',
-    rule: 'Modal is not the first thought',
-    description:
-      'Modals are usually laziness. Exhaust inline / progressive disclosure alternatives first.',
-  },
-];
-
-/** Static ban list — id/rule/description as authored here (may drift from the engine registry's wording for bans that also have a detector rule). */
-export const ABSOLUTE_BANS = ABSOLUTE_BANS_STATIC;
-
-/**
- * Same ban list, with descriptions for detector-backed bans (`engineRuleId`
- * set) replaced by the live text from the engine registry. Falls back to the
- * static description when the registry can't be loaded (e.g. package not
- * fully installed) or the referenced rule id is missing.
- */
-export async function getAbsoluteBans(): Promise<AbsoluteBan[]> {
-  const registry = await loadRegistry();
-  if (!registry) return ABSOLUTE_BANS_STATIC;
-  const byId = new Map(registry.map((r) => [r.id, r]));
-  return ABSOLUTE_BANS_STATIC.map((ban) => {
-    const engineRule = ban.engineRuleId ? byId.get(ban.engineRuleId) : undefined;
-    return engineRule ? { ...ban, description: engineRule.description } : ban;
-  });
-}
-
-export const COLOR_STRATEGIES = ['restrained', 'committed', 'full-palette', 'drenched'] as const;
-export type ColorStrategy = (typeof COLOR_STRATEGIES)[number];
-
-export const SHADOW_MAX_ALPHA = 0.15;
-
-/** Validates a shadow string does not exceed the max alpha. */
-export function shadowAlphaComplies(shadow: string): boolean {
-  const matches = shadow.match(/rgba?\([^)]+\)/g) ?? [];
-  for (const m of matches) {
-    const parts = m.replace(/rgba?\(/, '').replace(')', '').split(',').map(Number);
-    const alpha = parts.length === 4 ? parts[3] : 1;
-    if (alpha > SHADOW_MAX_ALPHA) return false;
-  }
-  return true;
-}
-
-export type Register = 'brand' | 'product';
-
-/** Infer register from surface description heuristic. */
-export function inferRegister(surface: string): Register {
-  const lower = surface.toLowerCase();
-  const brandKeywords = ['landing', 'marketing', 'campaign', 'homepage', 'portfolio', 'blog'];
-  const productKeywords = ['dashboard', 'admin', 'app', 'settings', 'onboard', 'console'];
-
-  if (brandKeywords.some((k) => lower.includes(k))) return 'brand';
-  if (productKeywords.some((k) => lower.includes(k))) return 'product';
-  return 'product'; // safe default
-}

package/src/tokens.ts

@@ -1,99 +0,0 @@
-/** Design tokens as typed JS constants — mirrors tokens.css */
-
-export const fontFamily = {
-  display: "'Cormorant Garamond', Georgia, serif",
-  body: "'Instrument Sans', system-ui, sans-serif",
-  mono: "'Space Grotesk', monospace",
-} as const;
-
-export const fontSize = {
-  xs: '0.75rem',
-  sm: '0.875rem',
-  base: '1rem',
-  lg: '1.125rem',
-  xl: '1.25rem',
-  '2xl': '1.5rem',
-  '3xl': '1.875rem',
-  '4xl': '2.25rem',
-  '5xl': '3rem',
-  '6xl': '3.75rem',
-  '7xl': '4.5rem',
-} as const;
-
-export const spacing = {
-  1: '4px',
-  2: '8px',
-  3: '12px',
-  4: '16px',
-  5: '20px',
-  6: '24px',
-  7: '28px',
-  8: '32px',
-  10: '40px',
-  12: '48px',
-  16: '64px',
-  20: '80px',
-  24: '96px',
-  30: '120px',
-} as const;
-
-export const easing = {
-  out: 'cubic-bezier(0.16, 1, 0.3, 1)',
-  outQuint: 'cubic-bezier(0.22, 1, 0.36, 1)',
-  inOut: 'cubic-bezier(0.65, 0, 0.35, 1)',
-  in: 'cubic-bezier(0.4, 0, 1, 1)',
-} as const;
-
-export const duration = {
-  instant: '0s',
-  fast: '0.15s',
-  base: '0.3s',
-  slow: '0.6s',
-  slower: '0.8s',
-  slowest: '1.2s',
-} as const;
-
-/** OKLCH color palette */
-export const color = {
-  ink: 'oklch(10% 0 0)',
-  charcoal: 'oklch(25% 0 0)',
-  ash: 'oklch(55% 0 0)',
-  mist: 'oklch(92% 0 0)',
-  cream: 'oklch(96% 0.005 350)',
-  paper: 'oklch(98% 0 0)',
-  white: 'oklch(99.5% 0 0)',
-  accent: 'oklch(60% 0.25 350)',
-  accentHover: 'oklch(52% 0.25 350)',
-  accentDim: 'oklch(60% 0.25 350 / 0.15)',
-  accentSoft: 'oklch(60% 0.25 350 / 0.25)',
-  accentText: 'oklch(45% 0.22 350)',
-} as const;
-
-export const accentScale = {
-  1: 'oklch(22% 0.15 350)',
-  2: 'oklch(33% 0.20 350)',
-  3: 'oklch(42% 0.23 350)',
-  4: 'oklch(52% 0.25 350)',
-  5: 'oklch(60% 0.25 350)',
-  6: 'oklch(68% 0.22 350)',
-  7: 'oklch(76% 0.18 350)',
-  8: 'oklch(84% 0.12 350)',
-  9: 'oklch(94% 0.05 350)',
-} as const;
-
-export const shadow = {
-  none: 'none',
-  sm: '0 1px 3px rgba(0, 0, 0, 0.06)',
-  md: '0 4px 24px -4px rgba(0, 0, 0, 0.12), 0 1px 3px rgba(0, 0, 0, 0.06)',
-  lg: '0 20px 40px rgba(0, 0, 0, 0.08)',
-  accent: '0 20px 60px oklch(60% 0.25 350 / 0.15)',
-} as const;
-
-export const radius = {
-  none: '0',
-  sm: '4px',
-  md: '8px',
-  lg: '12px',
-  xl: '16px',
-  full: '9999px',
-} as const;