@aperant/framework 0.6.2

package/dist/cli/design/scan.mjs

@@ -0,0 +1,299 @@
+/**
+ * design/scan.mjs — Filesystem walker + orchestrator for C27 design-scan.
+ *
+ * Walks the project root (or a user-supplied subdirectory), reads each UI
+ * source file, runs the extractors from `extract.mjs`, and merges their
+ * results into a single tokens object that conforms to `DesignTokensSchema`.
+ *
+ * Design intent:
+ *   - Zero external deps — readdirSync + statSync + readFileSync only.
+ *   - Bounded: MAX_FILES and MAX_FILE_BYTES caps keep runtime predictable on
+ *     large brownfield codebases.
+ *   - Conservative exclusions: the usual build-output + VCS + framework state
+ *     directories are skipped outright before recursing.
+ *   - Deterministic output: every extractor dedups and sorts; merging across
+ *     files re-dedups via Set and re-sorts per slice.
+ *
+ * The orchestrator is pure with respect to the returned value — it does not
+ * touch `.aperant/`. Writing `tokens.json` is the command wrapper's job
+ * (commands/design-scan.mjs), which also adds the timestamp.
+ */
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, resolve as resolvePath } from 'node:path';
+import { extractColors, extractRadii, extractShadows, extractSpacing, extractTypography, } from './extract.mjs';
+export const SCAN_EXTENSIONS = new Set([
+    '.css',
+    '.scss',
+    '.sass',
+    '.less',
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '.html',
+    '.vue',
+    '.svelte',
+    '.mdx',
+]);
+// Additional explicit filenames: Tailwind config variants ship without a
+// distinguishing extension convention beyond .js/.ts, which are already in the
+// set above. Listed here so readers know we intentionally cover them.
+export const SCAN_FILENAMES = new Set([
+    'tailwind.config.js',
+    'tailwind.config.ts',
+    'tailwind.config.mjs',
+    'tailwind.config.cjs',
+]);
+export const EXCLUDED_DIRS = new Set([
+    'node_modules',
+    'dist',
+    'build',
+    '.next',
+    'out',
+    '.aperant',
+    '.git',
+    'coverage',
+    '.turbo',
+    '.cache',
+    '.vercel',
+]);
+export const MAX_FILES = 2000;
+export const MAX_FILE_BYTES = 256 * 1024; // 256 KB
+/**
+ * Scan a project directory for design tokens.
+ *
+ * @param {string} projectRoot absolute or relative path to the project
+ * @param {{root?: string, maxFiles?: number, maxFileBytes?: number}} [opts]
+ *   root: optional subdirectory under projectRoot to scan (defaults to the
+ *     whole project). `node packages/framework/bin/apt-tools.mjs design-scan
+ *     . --root packages/ui` limits the scan to that tree.
+ * @returns {{
+ *   version: 1,
+ *   project_root: string,
+ *   scan: {files_scanned: number, files_skipped: number},
+ *   colors: ReturnType<typeof extractColors>,
+ *   spacing: ReturnType<typeof extractSpacing>,
+ *   typography: ReturnType<typeof extractTypography>,
+ *   radii: ReturnType<typeof extractRadii>,
+ *   shadows: ReturnType<typeof extractShadows>,
+ * }}
+ */
+export function scanDesignTokens(projectRoot, opts = {}) {
+    const absRoot = resolvePath(projectRoot || '.');
+    const startDir = opts.root ? resolvePath(absRoot, opts.root) : absRoot;
+    const maxFiles = opts.maxFiles ?? MAX_FILES;
+    const maxFileBytes = opts.maxFileBytes ?? MAX_FILE_BYTES;
+    const acc = {
+        hex: new Set(),
+        rgb: new Set(),
+        hsl: new Set(),
+        tw_colors: new Set(),
+        css_vars: new Set(),
+        spacing_raw: new Set(),
+        tw_spacing: new Set(),
+        font_families: new Set(),
+        font_sizes_raw: new Set(),
+        tw_text_sizes: new Set(),
+        line_heights: new Set(),
+        radii_raw: new Set(),
+        tw_radii: new Set(),
+        shadow_raw: new Set(),
+        tw_shadows: new Set(),
+    };
+    let filesScanned = 0;
+    let filesSkipped = 0;
+    const queue = [startDir];
+    while (queue.length > 0 && filesScanned < maxFiles) {
+        const dir = queue.shift();
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (filesScanned >= maxFiles)
+                break;
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (EXCLUDED_DIRS.has(entry.name))
+                    continue;
+                if (entry.name.startsWith('.') && entry.name !== '.aperant' && entry.name !== '.git') {
+                    // Skip other dotfile dirs by default (.nuxt, .svelte-kit, etc.)
+                    continue;
+                }
+                queue.push(full);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            const lowerName = entry.name.toLowerCase();
+            const dot = lowerName.lastIndexOf('.');
+            const ext = dot >= 0 ? lowerName.slice(dot) : '';
+            const isScannedExt = SCAN_EXTENSIONS.has(ext);
+            const isScannedName = SCAN_FILENAMES.has(lowerName);
+            if (!isScannedExt && !isScannedName)
+                continue;
+            let text;
+            try {
+                const st = statSync(full);
+                if (st.size > maxFileBytes) {
+                    filesSkipped++;
+                    continue;
+                }
+                text = readFileSync(full, 'utf-8');
+            }
+            catch {
+                filesSkipped++;
+                continue;
+            }
+            mergeInto(acc, text);
+            filesScanned++;
+        }
+    }
+    return {
+        version: 1,
+        project_root: absRoot,
+        scan: { files_scanned: filesScanned, files_skipped: filesSkipped },
+        colors: {
+            hex: sortedUnique(acc.hex),
+            rgb: sortedUnique(acc.rgb),
+            hsl: sortedUnique(acc.hsl),
+            tailwind: sortedUnique(acc.tw_colors),
+            css_vars: sortedUnique(acc.css_vars),
+        },
+        spacing: {
+            raw: sortedUnique(acc.spacing_raw, lengthSort),
+            tailwind_scale: sortedUnique(acc.tw_spacing, numericScaleSort),
+        },
+        typography: {
+            font_families: sortedUnique(acc.font_families),
+            font_sizes_raw: sortedUnique(acc.font_sizes_raw),
+            tailwind_sizes: sortedUnique(acc.tw_text_sizes, twTextSizeSort),
+            line_heights: sortedUnique(acc.line_heights),
+        },
+        radii: {
+            raw: sortedUnique(acc.radii_raw),
+            tailwind: sortedUnique(acc.tw_radii, radiiSort),
+        },
+        shadows: {
+            raw: sortedUnique(acc.shadow_raw),
+            tailwind: sortedUnique(acc.tw_shadows, shadowSort),
+        },
+    };
+}
+function mergeInto(acc, text) {
+    const c = extractColors(text);
+    for (const v of c.hex)
+        acc.hex.add(v);
+    for (const v of c.rgb)
+        acc.rgb.add(v);
+    for (const v of c.hsl)
+        acc.hsl.add(v);
+    for (const v of c.tailwind)
+        acc.tw_colors.add(v);
+    for (const v of c.css_vars)
+        acc.css_vars.add(v);
+    const s = extractSpacing(text);
+    for (const v of s.raw)
+        acc.spacing_raw.add(v);
+    for (const v of s.tailwind_scale)
+        acc.tw_spacing.add(v);
+    const t = extractTypography(text);
+    for (const v of t.font_families)
+        acc.font_families.add(v);
+    for (const v of t.font_sizes_raw)
+        acc.font_sizes_raw.add(v);
+    for (const v of t.tailwind_sizes)
+        acc.tw_text_sizes.add(v);
+    for (const v of t.line_heights)
+        acc.line_heights.add(v);
+    const r = extractRadii(text);
+    for (const v of r.raw)
+        acc.radii_raw.add(v);
+    for (const v of r.tailwind)
+        acc.tw_radii.add(v);
+    const sh = extractShadows(text);
+    for (const v of sh.raw)
+        acc.shadow_raw.add(v);
+    for (const v of sh.tailwind)
+        acc.tw_shadows.add(v);
+}
+function sortedUnique(set, cmp) {
+    return [...set].sort(cmp);
+}
+// --- Shared sort comparators (mirror extract.mjs) ---------------------------
+function lengthSort(a, b) {
+    const na = parseFloat(a);
+    const nb = parseFloat(b);
+    if (Number.isNaN(na) || Number.isNaN(nb))
+        return a.localeCompare(b);
+    if (na !== nb)
+        return na - nb;
+    return a.localeCompare(b);
+}
+function numericScaleSort(a, b) {
+    const na = parseFloat(a);
+    const nb = parseFloat(b);
+    if (Number.isNaN(na) && Number.isNaN(nb))
+        return a.localeCompare(b);
+    if (Number.isNaN(na))
+        return 1;
+    if (Number.isNaN(nb))
+        return -1;
+    return na - nb;
+}
+const TW_SIZE_ORDER = [
+    'xs',
+    'sm',
+    'base',
+    'lg',
+    'xl',
+    '2xl',
+    '3xl',
+    '4xl',
+    '5xl',
+    '6xl',
+    '7xl',
+    '8xl',
+    '9xl',
+];
+function twTextSizeSort(a, b) {
+    const ia = TW_SIZE_ORDER.indexOf(a);
+    const ib = TW_SIZE_ORDER.indexOf(b);
+    if (ia >= 0 && ib >= 0)
+        return ia - ib;
+    if (ia >= 0)
+        return -1;
+    if (ib >= 0)
+        return 1;
+    return a.localeCompare(b);
+}
+const RADII_ORDER = ['none', 'sm', 'default', 'md', 'lg', 'xl', '2xl', '3xl', 'full'];
+function radiiSort(a, b) {
+    const ia = RADII_ORDER.indexOf(a);
+    const ib = RADII_ORDER.indexOf(b);
+    if (ia >= 0 && ib >= 0)
+        return ia - ib;
+    if (ia >= 0)
+        return -1;
+    if (ib >= 0)
+        return 1;
+    return a.localeCompare(b);
+}
+const SHADOW_ORDER = ['none', 'sm', 'default', 'md', 'lg', 'xl', '2xl', 'inner'];
+function shadowSort(a, b) {
+    const ia = SHADOW_ORDER.indexOf(a);
+    const ib = SHADOW_ORDER.indexOf(b);
+    if (ia >= 0 && ib >= 0)
+        return ia - ib;
+    if (ia >= 0)
+        return -1;
+    if (ib >= 0)
+        return 1;
+    return a.localeCompare(b);
+}
+//# sourceMappingURL=scan.mjs.map

package/dist/cli/design/scan.mjs.map

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

package/dist/cli/design/schema.d.mts

@@ -0,0 +1,99 @@
+export function validateDesignTokens(data: any): z.ZodSafeParseResult<{
+    version: 1;
+    generated_at: string;
+    project_root: string;
+    scan: {
+        files_scanned: number;
+        files_skipped: number;
+    };
+    colors: {
+        hex: string[];
+        rgb: string[];
+        hsl: string[];
+        tailwind: string[];
+        css_vars: string[];
+    };
+    spacing: {
+        raw: string[];
+        tailwind_scale: string[];
+    };
+    typography: {
+        font_families: string[];
+        font_sizes_raw: string[];
+        tailwind_sizes: string[];
+        line_heights: string[];
+    };
+    radii: {
+        raw: string[];
+        tailwind: string[];
+    };
+    shadows: {
+        raw: string[];
+        tailwind: string[];
+    };
+}>;
+export const ColorsSchema: z.ZodObject<{
+    hex: z.ZodArray<z.ZodString>;
+    rgb: z.ZodArray<z.ZodString>;
+    hsl: z.ZodArray<z.ZodString>;
+    tailwind: z.ZodArray<z.ZodString>;
+    css_vars: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export const SpacingSchema: z.ZodObject<{
+    raw: z.ZodArray<z.ZodString>;
+    tailwind_scale: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export const TypographySchema: z.ZodObject<{
+    font_families: z.ZodArray<z.ZodString>;
+    font_sizes_raw: z.ZodArray<z.ZodString>;
+    tailwind_sizes: z.ZodArray<z.ZodString>;
+    line_heights: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export const RadiiSchema: z.ZodObject<{
+    raw: z.ZodArray<z.ZodString>;
+    tailwind: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export const ShadowsSchema: z.ZodObject<{
+    raw: z.ZodArray<z.ZodString>;
+    tailwind: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export const ScanStatsSchema: z.ZodObject<{
+    files_scanned: z.ZodNumber;
+    files_skipped: z.ZodNumber;
+}, z.core.$strict>;
+export const DesignTokensSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    generated_at: z.ZodString;
+    project_root: z.ZodString;
+    scan: z.ZodObject<{
+        files_scanned: z.ZodNumber;
+        files_skipped: z.ZodNumber;
+    }, z.core.$strict>;
+    colors: z.ZodObject<{
+        hex: z.ZodArray<z.ZodString>;
+        rgb: z.ZodArray<z.ZodString>;
+        hsl: z.ZodArray<z.ZodString>;
+        tailwind: z.ZodArray<z.ZodString>;
+        css_vars: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    spacing: z.ZodObject<{
+        raw: z.ZodArray<z.ZodString>;
+        tailwind_scale: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    typography: z.ZodObject<{
+        font_families: z.ZodArray<z.ZodString>;
+        font_sizes_raw: z.ZodArray<z.ZodString>;
+        tailwind_sizes: z.ZodArray<z.ZodString>;
+        line_heights: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    radii: z.ZodObject<{
+        raw: z.ZodArray<z.ZodString>;
+        tailwind: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    shadows: z.ZodObject<{
+        raw: z.ZodArray<z.ZodString>;
+        tailwind: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+import { z } from 'zod';
+//# sourceMappingURL=schema.d.mts.map

package/dist/cli/design/schema.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.mts","sourceRoot":"","sources":["../../../src/cli/design/schema.mjs"],"names":[],"mappings":"AAmFA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEC;AA/DD;;;;;;mBAQU;AAEV;;;mBAKU;AAEV;;;;;mBAOU;AAEV;;;mBAKU;AAEV;;;mBAKU;AAEV;;;mBAKU;AAEV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAYU;kBA/DQ,KAAK"}

package/dist/cli/design/schema.mjs

@@ -0,0 +1,77 @@
+/**
+ * design/schema.mjs — Zod schema for C27 design tokens.
+ *
+ * Mirrors `src/cli/profile/schema.mjs` in layout: `.mjs` schema consumable
+ * directly by the CLI kernel, with a TypeScript re-export at
+ * `src/schemas/design-tokens.ts` that layers on inferred types.
+ *
+ * The tokens object is emitted to `.aperant/design/tokens.json` by
+ * `apt-tools design-scan` (see `commands/design-scan.mjs`) and consumed by
+ * the `apt:design` skill, which injects a `{TOKENS_BLOCK}` summary into its
+ * Stage 1 wireframe context when the file is present.
+ *
+ * v1 shape is deliberately flat: every token kind maps to a small object of
+ * sorted, deduped string arrays. Richer structure (semantic roles, dark/light
+ * pairing, motion curves) is deferred — see docs/design-tokens.md for the
+ * v1-limits list.
+ */
+import { z } from 'zod';
+const StringArray = z.array(z.string());
+export const ColorsSchema = z
+    .object({
+    hex: StringArray,
+    rgb: StringArray,
+    hsl: StringArray,
+    tailwind: StringArray,
+    css_vars: StringArray,
+})
+    .strict();
+export const SpacingSchema = z
+    .object({
+    raw: StringArray,
+    tailwind_scale: StringArray,
+})
+    .strict();
+export const TypographySchema = z
+    .object({
+    font_families: StringArray,
+    font_sizes_raw: StringArray,
+    tailwind_sizes: StringArray,
+    line_heights: StringArray,
+})
+    .strict();
+export const RadiiSchema = z
+    .object({
+    raw: StringArray,
+    tailwind: StringArray,
+})
+    .strict();
+export const ShadowsSchema = z
+    .object({
+    raw: StringArray,
+    tailwind: StringArray,
+})
+    .strict();
+export const ScanStatsSchema = z
+    .object({
+    files_scanned: z.number().int().nonnegative(),
+    files_skipped: z.number().int().nonnegative(),
+})
+    .strict();
+export const DesignTokensSchema = z
+    .object({
+    version: z.literal(1),
+    generated_at: z.string().min(1),
+    project_root: z.string().min(1),
+    scan: ScanStatsSchema,
+    colors: ColorsSchema,
+    spacing: SpacingSchema,
+    typography: TypographySchema,
+    radii: RadiiSchema,
+    shadows: ShadowsSchema,
+})
+    .strict();
+export function validateDesignTokens(data) {
+    return DesignTokensSchema.safeParse(data);
+}
+//# sourceMappingURL=schema.mjs.map

package/dist/cli/design/schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.mjs","sourceRoot":"","sources":["../../../src/cli/design/schema.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;AAEvC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC3B,MAAM,CAAC;IACP,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,WAAW;CACrB,CAAC;KACD,MAAM,EAAE,CAAA;AAEV,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC5B,MAAM,CAAC;IACP,GAAG,EAAE,WAAW;IAChB,cAAc,EAAE,WAAW;CAC3B,CAAC;KACD,MAAM,EAAE,CAAA;AAEV,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACP,aAAa,EAAE,WAAW;IAC1B,cAAc,EAAE,WAAW;IAC3B,cAAc,EAAE,WAAW;IAC3B,YAAY,EAAE,WAAW;CACzB,CAAC;KACD,MAAM,EAAE,CAAA;AAEV,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KAC1B,MAAM,CAAC;IACP,GAAG,EAAE,WAAW;IAChB,QAAQ,EAAE,WAAW;CACrB,CAAC;KACD,MAAM,EAAE,CAAA;AAEV,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC5B,MAAM,CAAC;IACP,GAAG,EAAE,WAAW;IAChB,QAAQ,EAAE,WAAW;CACrB,CAAC;KACD,MAAM,EAAE,CAAA;AAEV,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC9B,MAAM,CAAC;IACP,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC7C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAC7C,CAAC;KACD,MAAM,EAAE,CAAA;AAEV,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KACjC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,gBAAgB;IAC5B,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,aAAa;CACtB,CAAC;KACD,MAAM,EAAE,CAAA;AAEV,MAAM,UAAU,oBAAoB,CAAC,IAAI;IACxC,OAAO,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AAC1C,CAAC"}