arekui 1.0.0 → 2.0.0

package/scripts/build-custom.js

@@ -1,318 +1,287 @@
-#!/usr/bin/env node
-
-/**
- * Arekui Build — scans your source and outputs only what you use.
- *
- * Usage:
- *   npx arekui-build                          # reads arekui.config.js
- *   npx arekui-build -i ./src -o ./assets     # overrides with flags
- *   npx arekui-build --sourcemap
- *   npx arekui-build --full                   # include everything
- *
- * Config file (arekui.config.js or arekui.config.json):
- *   module.exports = {
- *     input: "./src",           // directory to scan
- *     output: "./assets",       // output directory
- *     name: "arekui",          // output filename (without .min.css)
- *     sourcemap: false,
- *     full: false,              // true = ignore scan, include all
- *   };
- *
- * CLI flags override config file values.
- */
-
-const fs = require("fs");
-const path = require("path");
-const { bundle } = require("lightningcss");
-
-// ── Load config file ───────────────────────────────────────────────────────
-function loadConfig() {
-  const candidates = ["arekui.config.js", "arekui.config.json"];
-  for (const file of candidates) {
-    const full = path.resolve(file);
-    if (fs.existsSync(full)) {
-      try {
-        console.log(`\x1b[90m  config: ${file}\x1b[0m`);
-        return file.endsWith(".json")
-          ? JSON.parse(fs.readFileSync(full, "utf-8"))
-          : require(full);
-      } catch (e) {
-        console.error(`\x1b[31m✗\x1b[0m Failed to load ${file}: ${e.message}`);
-        process.exit(1);
-      }
-    }
-  }
-  return {};
-}
-
-// ── CLI args (override config) ─────────────────────────────────────────────
-function getArg(flags) {
-  const idx = process.argv.findIndex((a) => flags.includes(a));
-  return idx === -1 ? null : process.argv[idx + 1];
-}
-
-const config = loadConfig();
-
-const input = getArg(["-i", "--input"]) || config.input || ".";
-const output = getArg(["-o", "--output"]) || config.output || "assets";
-const name = getArg(["-n", "--name"]) || config.name || "arekui";
-const sourcemap =
-  process.argv.includes("--sourcemap") || config.sourcemap === true;
-const full = process.argv.includes("--full") || config.full === true;
-
-const srcDir = path.resolve(input);
-const outDir = path.resolve(output);
-
-// ── Component → CSS class mapping ──────────────────────────────────────────
-const COMPONENT_CLASSES = {
-  accordion: ["ar-accordion", "ar-collapse"],
-  alert: ["ar-alert"],
-  badge: ["ar-badge"],
-  breadcrumb: ["ar-breadcrumb"],
-  button: ["ar-btn"],
-  card: ["ar-card", "ar-card-body", "ar-card-title", "ar-card-figure"],
-  carousel: ["ar-carousel", "ar-carousel-item"],
-  chat: ["ar-chat", "ar-chat-bubble"],
-  drawer: ["ar-drawer"],
-  "file-upload": ["ar-file-upload"],
-  footer: ["ar-footer"],
-  forms: [
-    "ar-input",
-    "ar-textarea",
-    "ar-select",
-    "ar-checkbox",
-    "ar-radio",
-    "ar-toggle",
-    "ar-range",
-    "ar-label",
-    "ar-fieldset",
-  ],
-  hero: ["ar-hero"],
-  join: ["ar-join"],
-  link: ["ar-link"],
-  menu: ["ar-menu", "ar-dropdown"],
-  misc: ["ar-divider", "ar-stepper", "ar-step", "ar-avatar"],
-  modal: ["ar-modal"],
-  navbar: ["ar-navbar"],
-  pagination: ["ar-pagination"],
-  popover: ["ar-popover"],
-  progress: ["ar-progress"],
-  prose: ["ar-prose"],
-  rating: ["ar-rating"],
-  "scroll-top": ["ar-scroll-top"],
-  skeleton: ["ar-skeleton"],
-  swap: ["ar-swap"],
-  table: ["ar-table"],
-  tabs: ["ar-tabs", "ar-tab"],
-  tag: ["ar-tag"],
-  textured: ["ar-bg-img"],
-  timeline: ["ar-timeline"],
-  toast: ["ar-toast"],
-  tooltip: ["ar-tooltip"],
-};
-
-const UTILITY_PATTERNS = {
-  spacing: [
-    /^ar-p/,
-    /^ar-px/,
-    /^ar-py/,
-    /^ar-m/,
-    /^ar-mt/,
-    /^ar-mb/,
-    /^ar-my/,
-    /^ar-mx/,
-    /^ar-gap/,
-  ],
-  layout: [
-    /^ar-flex/,
-    /^ar-inline-flex/,
-    /^ar-flex-col/,
-    /^ar-flex-wrap/,
-    /^ar-items-/,
-    /^ar-justify-/,
-    /^ar-grid/,
-    /^ar-block/,
-    /^ar-hidden/,
-  ],
-  typography: [/^ar-text-/, /^ar-font-/, /^ar-leading-/, /^ar-tracking-/],
-  sizing: [
-    /^ar-w-/,
-    /^ar-h-/,
-    /^ar-min-h-/,
-    /^ar-max-w-/,
-    /^ar-aspect-video/,
-    /^ar-object-cover/,
-  ],
-  colors: [
-    /^ar-bg-base/,
-    /^ar-bg-neutral/,
-    /^ar-bg-primary/,
-    /^ar-bg-secondary/,
-    /^ar-bg-accent/,
-    /^ar-text-base/,
-    /^ar-text-gray/,
-  ],
-  borders: [/^ar-border/, /^ar-rounded/, /^ar-shadow-/],
-  hover: [/^ar-hover-/],
-  responsive: [/^ar-md:/, /^ar-lg:/],
-  "neo-utilities": [/^ar-neo-/],
-};
-
-// ── Scan source files ──────────────────────────────────────────────────────
-function findSourceFiles(dir) {
-  const exts = [".html", ".jsx", ".vue", ".svelte", ".tsx", ".ts", ".js"];
-  const files = [];
-
-  function walk(d) {
-    for (const entry of fs.readdirSync(d, { withFileTypes: true })) {
-      const full = path.join(d, entry.name);
-      if (
-        entry.isDirectory() &&
-        !entry.name.startsWith(".") &&
-        entry.name !== "node_modules"
-      ) {
-        walk(full);
-      } else if (entry.isFile() && exts.includes(path.extname(entry.name))) {
-        files.push(full);
-      }
-    }
-  }
-  walk(dir);
-  return files;
-}
-
-function scan(dir) {
-  const files = findSourceFiles(dir);
-  const content = files.map((f) => fs.readFileSync(f, "utf-8")).join("\n");
-  const tokens = new Set();
-  let m;
-  const re = /ar-[\w-]+/g;
-  while ((m = re.exec(content)) !== null) tokens.add(m[0]);
-  return tokens;
-}
-
-function detectComponents(classes) {
-  const found = new Set();
-  for (const [comp, patterns] of Object.entries(COMPONENT_CLASSES)) {
-    for (const cls of classes) {
-      if (patterns.some((p) => cls === p || cls.startsWith(p + "-"))) {
-        found.add(comp);
-        break;
-      }
-    }
-  }
-  return [...found];
-}
-
-function detectUtilities(classes) {
-  const found = new Set();
-  for (const [util, regexes] of Object.entries(UTILITY_PATTERNS)) {
-    for (const cls of classes) {
-      if (regexes.some((r) => r.test(cls))) {
-        found.add(util);
-        break;
-      }
-    }
-  }
-  return [...found];
-}
-
-// ── Build CSS ──────────────────────────────────────────────────────────────
-const COMPONENT_FILES = {
-  accordion: "accordion",
-  alert: "alert",
-  badge: "badge",
-  breadcrumb: "breadcrumb",
-  button: "button",
-  card: "card",
-  carousel: "carousel",
-  chat: "chat",
-  drawer: "drawer",
-  "file-upload": "file-upload",
-  footer: "footer",
-  forms: "forms",
-  hero: "hero",
-  join: "join",
-  link: "link",
-  menu: "menu",
-  misc: "misc",
-  modal: "modal",
-  navbar: "navbar",
-  pagination: "pagination",
-  popover: "popover",
-  progress: "progress",
-  prose: "prose",
-  rating: "rating",
-  "scroll-top": "scroll-top",
-  skeleton: "skeleton",
-  swap: "swap",
-  table: "table",
-  tabs: "tabs",
-  tag: "tag",
-  textured: "textured",
-  timeline: "timeline",
-  toast: "toast",
-  tooltip: "tooltip",
-};
-
-function buildCSS(components, utilities) {
-  const imports = [
-    `@import "./base/tokens.css" layer(base);`,
-    `@import "./base/reset.css" layer(base);`,
-    `@import "./base/neo-overrides.css" layer(base);`,
-  ];
-
-  for (const c of components) {
-    imports.push(
-      `@import "./components/${COMPONENT_FILES[c] || c}.css" layer(components);`,
-    );
-  }
-  for (const u of utilities) {
-    imports.push(`@import "./utilities/${u}.css" layer(utilities);`);
-  }
-
-  return `@layer base, components, utilities;\n\n${imports.join("\n")}\n`;
-}
-
-// ── Main ───────────────────────────────────────────────────────────────────
-const orchestrator = path.join(__dirname, "..", "src", "arekui.css");
-const tmpFile = path.join(path.dirname(orchestrator), "__build.css");
-
-try {
-  let components, utilities;
-
-  if (full) {
-    components = Object.keys(COMPONENT_FILES);
-    utilities = Object.keys(UTILITY_PATTERNS);
-    console.log(`\x1b[36m📦\x1b[0m Including all components`);
-  } else {
-    console.log(`\x1b[36m⏳\x1b[0m Scanning ${srcDir}...`);
-    const classes = scan(srcDir);
-    components = detectComponents(classes);
-    utilities = detectUtilities(classes);
-    console.log(`  Found ${classes.size} ar-* tokens`);
-    console.log(`  Components: ${components.join(", ") || "(none)"}`);
-    console.log(`  Utilities:  ${utilities.join(", ") || "(none)"}`);
-  }
-
-  fs.writeFileSync(tmpFile, buildCSS(components, utilities), "utf-8");
-  fs.mkdirSync(outDir, { recursive: true });
-
-  const result = bundle({
-    filename: tmpFile,
-    minify: true,
-    sourceMap: sourcemap,
-  });
-
-  const outFile = path.join(outDir, `${name}.min.css`);
-  fs.writeFileSync(outFile, result.code);
-  if (sourcemap && result.map) fs.writeFileSync(outFile + ".map", result.map);
-
-  console.log(`\n\x1b[32m✓\x1b[0m Built → ${outFile}`);
-  console.log(
-    `  ${components.length} components, ${utilities.length} utilities`,
-  );
-  console.log(`  ${(result.code.length / 1024).toFixed(1)}KB`);
-} finally {
-  if (fs.existsSync(tmpFile)) fs.unlinkSync(tmpFile);
-}
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const { bundle } = require("lightningcss");
+const { BASE_IMPORTS } = require("./imports");
+
+function loadConfig() {
+  const candidates = ["arekui.config.js", "arekui.config.json"];
+  for (const file of candidates) {
+    const full = path.resolve(file);
+    if (fs.existsSync(full)) {
+      try {
+        console.log(`\x1b[90m  config: ${file}\x1b[0m`);
+        return file.endsWith(".json")
+          ? JSON.parse(fs.readFileSync(full, "utf-8"))
+          : require(full);
+      } catch (e) {
+        console.error(`\x1b[31m✗\x1b[0m Failed to load ${file}: ${e.message}`);
+        process.exit(1);
+      }
+    }
+  }
+  return {};
+}
+
+function getArg(flags) {
+  const idx = process.argv.findIndex((a) => flags.includes(a));
+  return idx === -1 ? null : process.argv[idx + 1];
+}
+
+const config = loadConfig();
+
+const input = getArg(["-i", "--input"]) || config.input || ".";
+const output = getArg(["-o", "--output"]) || config.output || "assets";
+const name = getArg(["-n", "--name"]) || config.name || "arekui";
+const sourcemap =
+  process.argv.includes("--sourcemap") || config.sourcemap === true;
+const full = process.argv.includes("--full") || config.full === true;
+
+const srcDir = path.resolve(input);
+const outDir = path.resolve(output);
+
+const COMPONENT_CLASSES = {
+  accordion: ["ar-accordion", "ar-collapse"],
+  alert: ["ar-alert"],
+  badge: ["ar-badge"],
+  breadcrumb: ["ar-breadcrumb"],
+  broadsheet: ["ar-rule-double", "ar-masthead", "ar-folio", "ar-nameplate", "ar-banner", "ar-sheet-cols", "ar-sheet-col", "ar-plate"],
+  button: ["ar-btn"],
+  card: ["ar-card", "ar-card-body", "ar-card-title", "ar-card-figure"],
+  carousel: ["ar-carousel", "ar-carousel-item", "ar-carousel-frame", "ar-carousel-btn", "ar-carousel-btn-prev", "ar-carousel-btn-next"],
+  chat: ["ar-chat", "ar-chat-bubble"],
+  "description-list": ["ar-dl", "ar-dt", "ar-dd"],
+  sidebar: ["ar-sidebar"],
+  "file-upload": ["ar-file-upload"],
+  footer: ["ar-footer"],
+  forms: [
+    "ar-input",
+    "ar-textarea",
+    "ar-select",
+    "ar-checkbox",
+    "ar-radio",
+    "ar-toggle",
+    "ar-range",
+    "ar-label",
+    "ar-fieldset",
+  ],
+  heading: [
+    "ar-heading",
+    "ar-heading-eyebrow",
+    "ar-heading-title",
+    "ar-heading-desc",
+    "ar-heading-center",
+  ],
+  hero: ["ar-hero"],
+  join: ["ar-join"],
+  docs: ["ar-docs"],
+  empty: ["ar-empty", "ar-empty-icon", "ar-empty-title", "ar-empty-desc", "ar-empty-action"],
+  kbd: ["ar-kbd"],
+  link: ["ar-link"],
+  loading: ["ar-loading"],
+  menu: ["ar-menu", "ar-dropdown", "ar-theme-menu"],
+  misc: ["ar-divider", "ar-stepper", "ar-step", "ar-avatar", "ar-avatar-group", "ar-avatar-more"],
+  modal: ["ar-modal"],
+  navbar: ["ar-navbar", "ar-search"],
+  pagination: ["ar-pagination"],
+  popover: ["ar-popover"],
+  progress: ["ar-progress"],
+  prose: ["ar-prose"],
+  rating: ["ar-rating"],
+  "scroll-top": ["ar-scroll-top"],
+  segmented: ["ar-segmented", "ar-segmented-input", "ar-segmented-item"],
+  skeleton: ["ar-skeleton"],
+  spinner: ["ar-spinner"],
+  swap: ["ar-swap"],
+  table: ["ar-table"],
+  tabs: ["ar-tabs", "ar-tab"],
+  tag: ["ar-tag"],
+  textured: ["ar-bg-img"],
+  timeline: ["ar-timeline"],
+  toast: ["ar-toast"],
+  tooltip: ["ar-tooltip"],
+};
+
+const UTILITY_PATTERNS = {
+  spacing: [
+    /^ar-p/,
+    /^ar-px/,
+    /^ar-py/,
+    /^ar-m/,
+    /^ar-mt/,
+    /^ar-mb/,
+    /^ar-my/,
+    /^ar-mx/,
+    /^ar-gap/,
+  ],
+  layout: [
+    /^ar-flex/,
+    /^ar-inline-flex/,
+    /^ar-flex-col/,
+    /^ar-flex-wrap/,
+    /^ar-items-/,
+    /^ar-justify-/,
+    /^ar-grid/,
+    /^ar-block/,
+    /^ar-hidden/,
+  ],
+  typography: [/^ar-text-/, /^ar-font-/, /^ar-leading-/, /^ar-tracking-/],
+  sizing: [
+    /^ar-w-/,
+    /^ar-h-/,
+    /^ar-min-h-/,
+    /^ar-max-w-/,
+    /^ar-aspect-video/,
+    /^ar-object-cover/,
+  ],
+  colors: [
+    /^ar-bg-base/,
+    /^ar-bg-neutral/,
+    /^ar-bg-primary/,
+    /^ar-bg-secondary/,
+    /^ar-bg-accent/,
+    /^ar-text-base/,
+    /^ar-text-gray/,
+  ],
+  borders: [/^ar-border/, /^ar-rounded/, /^ar-shadow-/],
+  hover: [/^ar-hover-/],
+  responsive: [/^ar-md:/, /^ar-lg:/, /^ar-hide/],
+  "neo-utilities": [/^ar-neo-/],
+  "pixel-utilities": [/^ar-pixel-/],
+  "brutalist-utilities": [/^ar-brutalist-/],
+};
+
+function findSourceFiles(dir) {
+  const exts = [".html", ".jsx", ".vue", ".svelte", ".tsx", ".ts", ".js"];
+
+  // A consumer may point -i at a single file rather than a directory.
+  let stat;
+  try {
+    stat = fs.statSync(dir);
+  } catch {
+    console.error(`\x1b[31m✗\x1b[0m scan input not found: ${dir}`);
+    process.exit(1);
+  }
+  if (stat.isFile()) {
+    const ext = path.extname(dir).toLowerCase();
+    if (!exts.includes(ext)) {
+      console.error(
+        `\x1b[31m✗\x1b[0m ${dir} is not a scannable source - expected one of (${exts.join(" ")}) or a directory`,
+      );
+      process.exit(1);
+    }
+    return [dir];
+  }
+
+  const files = [];
+
+  function walk(d) {
+    for (const entry of fs.readdirSync(d, { withFileTypes: true })) {
+      const full = path.join(d, entry.name);
+      if (
+        entry.isDirectory() &&
+        !entry.name.startsWith(".") &&
+        entry.name !== "node_modules"
+      ) {
+        walk(full);
+      } else if (entry.isFile() && exts.includes(path.extname(entry.name))) {
+        files.push(full);
+      }
+    }
+  }
+  walk(dir);
+  return files;
+}
+
+function scan(dir) {
+  const files = findSourceFiles(dir);
+  const content = files.map((f) => fs.readFileSync(f, "utf-8")).join("\n");
+  const tokens = new Set();
+  let m;
+  const re = /ar-[\w-]+/g;
+  while ((m = re.exec(content)) !== null) tokens.add(m[0]);
+  return tokens;
+}
+
+// Both detectors answer the same question — which named groups have at least
+// one matcher satisfied by a scanned token — so the double loop lives once.
+function detect(groups, classes, isMatch) {
+  const found = [];
+  for (const [name, matchers] of Object.entries(groups)) {
+    for (const cls of classes) {
+      if (matchers.some((m) => isMatch(m, cls))) {
+        found.push(name);
+        break;
+      }
+    }
+  }
+  return found;
+}
+
+function detectComponents(classes) {
+  return detect(
+    COMPONENT_CLASSES,
+    classes,
+    (pattern, cls) => cls === pattern || cls.startsWith(pattern + "-"),
+  );
+}
+
+function detectUtilities(classes) {
+  return detect(UTILITY_PATTERNS, classes, (pattern, cls) => pattern.test(cls));
+}
+
+function buildCSS(components, utilities) {
+  const imports = [...BASE_IMPORTS];
+
+  for (const c of components) {
+    imports.push(`@import "./components/${c}.css" layer(components);`);
+  }
+  for (const u of utilities) {
+    imports.push(`@import "./utilities/${u}.css" layer(utilities);`);
+  }
+
+  return `@layer base, components, themes, utilities;\n\n${imports.join("\n")}\n`;
+}
+
+const orchestrator = path.join(__dirname, "..", "src", "arekui.css");
+const tmpFile = path.join(path.dirname(orchestrator), "__build.css");
+
+try {
+  let components, utilities;
+
+  if (full) {
+    components = Object.keys(COMPONENT_CLASSES);
+    utilities = Object.keys(UTILITY_PATTERNS);
+    console.log(`\x1b[36m📦\x1b[0m Including all components`);
+  } else {
+    console.log(`\x1b[36m⏳\x1b[0m Scanning ${srcDir}...`);
+    const classes = scan(srcDir);
+    components = detectComponents(classes);
+    utilities = detectUtilities(classes);
+    console.log(`  Found ${classes.size} ar-* tokens`);
+    console.log(`  Components: ${components.join(", ") || "(none)"}`);
+    console.log(`  Utilities:  ${utilities.join(", ") || "(none)"}`);
+  }
+
+  fs.writeFileSync(tmpFile, buildCSS(components, utilities), "utf-8");
+  fs.mkdirSync(outDir, { recursive: true });
+
+  const result = bundle({
+    filename: tmpFile,
+    minify: true,
+    sourceMap: sourcemap,
+  });
+
+  const outFile = path.join(outDir, `${name}.min.css`);
+  fs.writeFileSync(outFile, result.code);
+  if (sourcemap && result.map) fs.writeFileSync(outFile + ".map", result.map);
+
+  console.log(`\n\x1b[32m✓\x1b[0m Built → ${outFile}`);
+  console.log(
+    `  ${components.length} components, ${utilities.length} utilities`,
+  );
+  console.log(`  ${(result.code.length / 1024).toFixed(1)}KB`);
+} finally {
+  if (fs.existsSync(tmpFile)) fs.unlinkSync(tmpFile);
+}