basalt-ui 1.22.0 → 1.23.0

package/dist/cli/index.js

@@ -160,6 +160,16 @@ function hasBasaltProject(dir) {
     return false;
   }
 }
+function descendantProjects(cwd, depth = 2) {
+  if (depth === 0) return [];
+  const out = [];
+  for (const name of subdirNames(cwd, { skipDotDirs: true })) {
+    const dir = resolve(cwd, name);
+    if (hasBasaltProject(dir)) out.push(dir);
+    else out.push(...descendantProjects(dir, depth - 1));
+  }
+  return out;
+}
 function resolveProjectDir(cwd) {
   const override = process.env["BASALT_CWD"];
   if (override !== void 0 && override.length > 0) {
@@ -167,7 +177,8 @@ function resolveProjectDir(cwd) {
     return { dir, relocatedFrom: dir === cwd ? null : cwd, ambiguous: null };
   }
   if (hasBasaltProject(cwd)) return { dir: cwd, relocatedFrom: null, ambiguous: null };
-  const candidates = collectWorkspacePackages(cwd).packages.filter((pkg) => pkg.dir !== cwd && hasBasaltProject(pkg.dir)).map((pkg) => pkg.dir);
+  const declared = collectWorkspacePackages(cwd).packages.filter((pkg) => pkg.dir !== cwd && hasBasaltProject(pkg.dir)).map((pkg) => pkg.dir);
+  const candidates = declared.length > 0 ? declared : descendantProjects(cwd);
   if (candidates.length === 1) {
     return { dir: candidates[0], relocatedFrom: cwd, ambiguous: null };
   }
@@ -239,7 +250,7 @@ function checkTheme(invocationCwd = process.cwd(), flags = []) {
   const project = resolveProjectDir(invocationCwd);
   if (project.ambiguous !== null) {
     console.error(
-      `\u2716 basalt-ui check-theme: no basalt config at ${invocationCwd}, and ${project.ambiguous.length} workspace packages carry one (${project.ambiguous.map((d) => relativePosix(invocationCwd, d)).join(", ")}) \u2014 run it from one of them, or set BASALT_CWD to pick.`
+      `\u2716 basalt-ui check-theme: no basalt config at ${invocationCwd}, and ${project.ambiguous.length} packages below it carry one (${project.ambiguous.map((d) => relativePosix(invocationCwd, d)).join(", ")}) \u2014 run it from one of them, or set BASALT_CWD to pick.`
     );
     return 1;
   }
@@ -565,8 +576,9 @@ basalt.exemptRules entries (${exemptCount}):`);
     `
 ${live} live, ${dead} dead, ${outOfReach} unjudgeable, ${unaccountable} unaccountable (reported as theme-allow-unscoped by a normal run).`
   );
+  const includes = cfg.include ?? [];
   lines.push(
-    `Scope: the ${scanned.length} file(s) check-theme scans under basalt.roots (${resolveRoots(cfg).join(", ")}). A waiver outside them is not audited \u2014 widen roots to cover it, or accept that nothing polices that file.`
+    `Scope: the ${scanned.length} file(s) check-theme scans \u2014 everything under basalt.roots (${resolveRoots(cfg).join(", ")}), plus each root's sibling index.html and public/ tree, ` + (includes.length === 0 ? "plus anything named in basalt.include (none). " : `plus basalt.include (${includes.join(", ")}). `) + "A waiver in a file none of those reach is not audited \u2014 widen roots, or name it in basalt.include, or accept that nothing polices that file."
   );
   if (dead > 0) {
     lines.push(
@@ -860,6 +872,16 @@ function migrateLegacyOxfmt(cwd, pkgRoot, manifest) {
   const shipped = readSource(pkgRoot, "configs/oxfmt.json");
   if (shipped !== null && onDisk === shipped) unlinkSync(legacyAbs);
 }
+const DESIGN_VERSION_LINE = /^(> Managed by basalt-ui) \(\d+\.\d+\.\d+\)\./m;
+function migrateDesignVersionLine(cwd) {
+  const dest = resolve(cwd, "DESIGN.md");
+  const onDisk = readIfExists(dest);
+  if (onDisk === null || !DESIGN_VERSION_LINE.test(onDisk)) return;
+  writeFileEnsuringDir(
+    dest,
+    onDisk.replace(DESIGN_VERSION_LINE, "$1 \u2014 run `basalt-ui doctor` for the version.")
+  );
+}
 function writeFileEnsuringDir(abs, content) {
   mkdirSync(dirname(abs), { recursive: true });
   writeFileSync(abs, content);
@@ -1287,10 +1309,15 @@ function findManifestAbove(dir) {
   }
 }
 function sync(opts = {}, invocationCwd = process.cwd()) {
+  const syncFlags = opts.flags ?? [];
+  if (conflictingProfileFlags(syncFlags)) {
+    console.error("basalt-ui sync: --tokens-only and --framework are alternatives \u2014 pass one.");
+    return 1;
+  }
   const project = resolveProjectDir(invocationCwd);
   if (project.ambiguous !== null) {
     console.error(
-      `\u2716 basalt-ui sync: no basalt config at ${invocationCwd}, and ${project.ambiguous.length} workspace packages carry one (${project.ambiguous.map((d) => relativePosix(invocationCwd, d)).join(", ")}) \u2014 run it from one of them, or set BASALT_CWD to pick.`
+      `\u2716 basalt-ui sync: no basalt config at ${invocationCwd}, and ${project.ambiguous.length} packages below it carry one (${project.ambiguous.map((d) => relativePosix(invocationCwd, d)).join(", ")}) \u2014 run it from one of them, or set BASALT_CWD to pick.`
     );
     return 1;
   }
@@ -1300,6 +1327,12 @@ function sync(opts = {}, invocationCwd = process.cwd()) {
       `basalt-ui sync: no basalt config at ${project.relocatedFrom} \u2014 running in ${relativePosix(project.relocatedFrom, cwd)}, where it lives.`
     );
   }
+  if (declaredProfile(readBasaltConfig(cwd), syncFlags) === "tokens-only") {
+    console.log(
+      `basalt-ui sync: ${MANIFEST_PATH}: n/a \u2014 a tokens-only consumer has no scaffold to reconcile. The token layer is refreshed by re-running \`basalt-ui tokens:css\`, and \`tokens:css --check\` is its drift gate. Pass --framework to force the full profile.`
+    );
+    return 0;
+  }
   if (!existsSync(resolve(cwd, MANIFEST_PATH))) {
     const elsewhere = findManifestAbove(cwd);
     const wouldWrite = managedFiles(resolvePeerFlags(cwd, {}), resolvePlacement(cwd)).length;
@@ -1311,7 +1344,10 @@ function sync(opts = {}, invocationCwd = process.cwd()) {
   const rootsState = reconcileRoots(cwd, { write: opts.check !== true });
   const ctx = renderContext(cwd);
   const manifest = readManifest(cwd);
-  if (!opts.check) migrateLegacyOxfmt(cwd, ctx.pkgRoot, manifest);
+  if (!opts.check) {
+    migrateLegacyOxfmt(cwd, ctx.pkgRoot, manifest);
+    migrateDesignVersionLine(cwd);
+  }
   const peers = resolvePeerFlags(cwd, {});
   const placement = resolvePlacement(cwd);
   const files = managedFiles(peers, placement);
@@ -1634,7 +1670,7 @@ function doctor(invocationCwd = process.cwd(), flags = []) {
       `
 basalt-ui doctor \u2014 ${invocationCwd}
 
-  \u2716 no basalt config at ${invocationCwd}, and ${project.ambiguous.length} workspace packages carry one (${project.ambiguous.map((d) => relativePosix(invocationCwd, d)).join(", ")}) \u2014 run doctor from one of them, or set BASALT_CWD to pick.
+  \u2716 no basalt config at ${invocationCwd}, and ${project.ambiguous.length} packages below it carry one (${project.ambiguous.map((d) => relativePosix(invocationCwd, d)).join(", ")}) \u2014 run doctor from one of them, or set BASALT_CWD to pick.
 
 1 hard failure(s), 0 warning(s).
 `
@@ -2205,7 +2241,7 @@ async function guardHook(cwd = process.cwd()) {
   }
   return 0;
 }
-const USAGE = "Usage: basalt-ui <init [--with-router] [--with-query] [--merge-lint] | sync [--force] [--check] |\n                  check-theme [--audit-allows] | check-coverage | info [--json] |\n                  doctor [--tokens-only|--framework] | guard-hook | tokens:css | fonts:css | help>\n\ncheck-theme [--tokens-only|--framework] [--audit-allows]\n  --audit-allows reports instead of scanning: every `theme-allow` annotation and every\n  `basalt.exemptRules` entry, with what each one still suppresses \u2014 proved by re-running the\n  guard with that one waiver neutralized, not by reading its text. Exits 1 on a waiver that\n  suppresses nothing (dead), which is what makes it usable as a CI gate.\n\ntokens:css [--out <path>] [--check] [--selector-attribute <attr> | --selector-class <class>]\n           [--light-class <class>] [--dark-value <v>] [--light-value <v>]\n           [--default-scheme <dark|light|none>] [--media-fallback] [--only <core|all>]\n           [--no-legacy-aliases]\n  Emit the --vx-* stylesheet (stdout unless --out). Defaults reproduce basalt-ui/tokens.css.\n  --selector-class emits `:root.dark` instead of an attribute selector (the Tailwind convention).\n  --check writes nothing and exits 1 when --out differs from what would be emitted (a CI gate).\n  --no-legacy-aliases drops the deprecated camelCase spellings (--vx-accentFill and friends),\n  which are emitted by default as aliases of the canonical kebab-case names.\n\nfonts:css [--out <path>] [--check]\n  Emit the shipped --basalt-font-* stacks as plain CSS \u2014 the typeface half of the token layer,\n  otherwise reachable only by importing styles.css.\n\ndoctor [--tokens-only|--framework]\n  Auto-detects a tokens-only consumer (no manifest + no @mantine/core) and checks only what\n  applies. A check that cannot RUN is reported as SKIPPED and exits non-zero.\n\ncheck-theme / doctor honour BASALT_CWD, and relocate to the single workspace package carrying a\nbasalt config when invoked from a repo root that has none \u2014 several carrying one is ambiguous\nand exits 1 in BOTH. --tokens-only and --framework are alternatives; passing both is an error.\n\nEvery subcommand accepts --help / -h to print this message and exit without running.";
+const USAGE = "Usage: basalt-ui <init [--with-router] [--with-query] [--merge-lint] |\n                  sync [--force] [--check] [--tokens-only|--framework] |\n                  check-theme [--audit-allows] | check-coverage | info [--json] |\n                  doctor [--tokens-only|--framework] | guard-hook | tokens:css | fonts:css | help>\n\ncheck-theme [--tokens-only|--framework] [--audit-allows]\n  --audit-allows reports instead of scanning: every `theme-allow` annotation and every\n  `basalt.exemptRules` entry, with what each one still suppresses \u2014 proved by re-running the\n  guard with that one waiver neutralized, not by reading its text. Exits 1 on a waiver that\n  suppresses nothing (dead), which is what makes it usable as a CI gate.\n\ntokens:css [--out <path>] [--check] [--selector-attribute <attr> | --selector-class <class>]\n           [--light-class <class>] [--dark-value <v>] [--light-value <v>]\n           [--default-scheme <dark|light|none>] [--media-fallback] [--only <core|all>]\n           [--no-legacy-aliases]\n  Emit the --vx-* stylesheet (stdout unless --out). Defaults reproduce basalt-ui/tokens.css.\n  --selector-class emits `:root.dark` instead of an attribute selector (the Tailwind convention).\n  --check writes nothing and exits 1 when --out differs from what would be emitted (a CI gate).\n  --no-legacy-aliases drops the deprecated camelCase spellings (--vx-accentFill and friends),\n  which are emitted by default as aliases of the canonical kebab-case names.\n\nfonts:css [--out <path>] [--check]\n  Emit the shipped --basalt-font-* stacks as plain CSS \u2014 the typeface half of the token layer,\n  otherwise reachable only by importing styles.css.\n\ndoctor [--tokens-only|--framework]\n  Auto-detects a tokens-only consumer (no manifest + no @mantine/core) and checks only what\n  applies. A check that cannot RUN is reported as SKIPPED and exits non-zero.\n\nsync [--force] [--check] [--tokens-only|--framework]\n  Refreshes an EXISTING install; it never creates one (that is init). A tokens-only consumer\n  has no scaffold to reconcile, so sync reports n/a and exits 0 there \u2014 as doctor does.\n\ncheck-theme / doctor / sync all resolve their project the same way: they honour BASALT_CWD, and\nrelocate to the single package below the cwd carrying a basalt config when invoked from a repo\nroot that has none \u2014 several carrying one is ambiguous and exits 1 in ALL THREE.\n--tokens-only and --framework are alternatives; passing both is an error.\n\nEvery subcommand accepts --help / -h to print this message and exit without running.";
 function run(argv, cwd = process.cwd()) {
   const [cmd, ...flags] = argv;
   if (cmd === "help" || cmd === "--help" || cmd === "-h" || flags.includes("--help") || flags.includes("-h")) {
@@ -2220,7 +2256,10 @@ function run(argv, cwd = process.cwd()) {
         mergeLint: flags.includes("--merge-lint")
       });
     case "sync":
-      return sync({ force: flags.includes("--force"), check: flags.includes("--check") }, cwd);
+      return sync(
+        { force: flags.includes("--force"), check: flags.includes("--check"), flags },
+        cwd
+      );
     case "check-theme":
       return checkTheme(cwd, flags);
     case "check-coverage":

package/dist/cli/shipped-versions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shipped-versions.test.d.ts.map

package/dist/cli/shipped-versions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shipped-versions.test.d.ts","sourceRoot":"","sources":["../../src/cli/shipped-versions.test.ts"],"names":[],"mappings":""}

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

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

package/dist/guard/index.js

@@ -108,7 +108,7 @@ const RADIUS_PROP_RE = /\bradius=(?:\{[0-9]+\}|"[0-9]+")/g;
 const MOTION_TRANSITION_NUMERIC = /\btransition\s*=\s*\{\{[^}]*\b(?:duration|stiffness|damping|mass)\s*:\s*-?\d/g;
 const MOTION_TRANSITION_EASE_ARRAY = /\btransition\s*=\s*\{\{[^}]*\bease\s*:\s*\[/g;
 const RAW_CHART_LEGEND_ARRAY = /<ChartLegend\b[^>]*?\bitems\s*=\s*\{\s*\[/g;
-const CHART_ENTRY_POINT_TAG = /<(?:MultiLine|Bars|Donut|DualPanel|Heatmap|ZonedLine|StackedArea|LineSparkline|BarSparkline)\b(?:<[^<>]*>)?(?:=>|[^>])*?>/g;
+const CHART_ENTRY_POINT_TAG = /<(?:MultiLine|Bars|BandStrip|Donut|DualPanel|Heatmap|MirroredBars|ZonedLine|StackedArea|LineSparkline|BarSparkline)\b(?:<[^<>]*>)?(?:=>|[^>])*?>/g;
 const HAS_ARIA_LABEL_PROP = /\bariaLabel\s*=/;
 const RAW_FORM_CONTROL = /<(?:input|select|textarea)\b/g;
 const RAW_FORM_CONTROL_TAG = /<(?:input|select|textarea)\b(?:=>|[^>])*?>/g;
@@ -250,10 +250,23 @@ function parseAllowAnnotation(rest, scope) {
   return { rules, unknownRules, hasReason: reason.length >= MIN_ALLOW_REASON_LENGTH, scope };
 }
 const MAX_CSS_CONTINUATION_LINES = 8;
-const MAX_COMMENT_BLOCK_LINES = 8;
+function commentBlockEnd(lines, index, tokenAt, syntax) {
+  const line = lines[index] ?? "";
+  if (syntax === "ts" && /\/\/\s*$/.test(line.slice(0, tokenAt))) return index;
+  const closer = syntax === "markup" ? "-->" : "*/";
+  if (line.slice(tokenAt).includes(closer)) return index;
+  for (let ahead = index + 1; ahead < lines.length; ahead++) {
+    if ((lines[ahead] ?? "").includes(closer)) return ahead;
+  }
+  return index;
+}
 const COMMENT_OPENER_BEFORE = /(?:\/\/|\/\*|<!--)\s*$/;
 const COMMENT_ONLY_LINE = /^\s*(?:\{\s*\/\*|\/\/|\/\*|\*|<!--)/;
 const JSX_COMMENT_CLOSE = /\*\/\s*\}\s*$/;
+function isCommentOnly(raw, stripped) {
+  const code = stripped.trim();
+  return code === "" || COMMENT_ONLY_LINE.test(raw) || code === "}" && JSX_COMMENT_CLOSE.test(raw);
+}
 const ANNOTATION_PREFIX = /(?:^|\/\/|\/\*\*?|<!--|^\s*\*)\s*$/;
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -273,7 +286,7 @@ function collectAllowAnnotations(lines, codeLines, allowComment, syntax) {
     list.push(annotation);
     byLine.set(index, list);
   };
-  const record = (index, annotation, trailing) => {
+  const record = (index, annotation, trailing, tokenAt) => {
     declared.push({ line: index + 1, annotation });
     if (annotation.scope === "file") {
       fileScoped.push(annotation);
@@ -281,11 +294,14 @@ function collectAllowAnnotations(lines, codeLines, allowComment, syntax) {
     }
     add(index, annotation);
     if (!trailing) {
-      for (let ahead = 1; ahead <= MAX_COMMENT_BLOCK_LINES; ahead++) {
-        const raw = lines[index + ahead] ?? "";
-        add(index + ahead, annotation);
-        if (raw.trim() !== "" && (codeLines[index + ahead] ?? "").trim() !== "") break;
+      const closesAt = commentBlockEnd(lines, index, tokenAt, syntax);
+      for (let ahead = 1; index + ahead < lines.length; ahead++) {
+        const at = index + ahead;
+        add(at, annotation);
+        if (at <= closesAt) continue;
+        const raw = lines[at] ?? "";
         if (raw.trim() === "") break;
+        if (!isCommentOnly(raw, codeLines[at] ?? "")) break;
       }
       return;
     }
@@ -301,11 +317,15 @@ function collectAllowAnnotations(lines, codeLines, allowComment, syntax) {
   for (let i = 0; i < lines.length; i++) {
     const line = lines[i] ?? "";
     const stripped = codeLines[i] ?? "";
-    const code = stripped.trim();
-    const isCommentOnlyLine = code === "" || COMMENT_ONLY_LINE.test(line) || code === "}" && JSX_COMMENT_CLOSE.test(line);
+    const isCommentOnlyLine = isCommentOnly(line, stripped);
     if (syntax === "markup") {
       for (const m of line.matchAll(jsonKey)) {
-        record(i, parseAllowAnnotation(m[2] ?? "", m[1] === void 0 ? "line" : "file"), false);
+        record(
+          i,
+          parseAllowAnnotation(m[2] ?? "", m[1] === void 0 ? "line" : "file"),
+          false,
+          m.index
+        );
       }
     }
     for (const m of line.matchAll(token)) {
@@ -317,7 +337,8 @@ function collectAllowAnnotations(lines, codeLines, allowComment, syntax) {
       record(
         i,
         parseAllowAnnotation(rest, m[1] === void 0 ? "line" : "file"),
-        !isCommentOnlyLine
+        !isCommentOnlyLine,
+        at
       );
     }
   }

package/dist/vite.d.ts

@@ -33,6 +33,29 @@ export type BasaltViteOptions = {
     enforcementNotice?: boolean;
 };
 export declare function basaltViteConfig(opts: BasaltViteOptions): UserConfig;
+/**
+ * One icon a consumer names itself — a manifest `icons` member, plus optionally the head `<link>`
+ * that points at the same file.
+ *
+ * The field names are the manifest's own, verbatim, so what a consumer writes here is what ships in
+ * `site.webmanifest`. `src` is root-relative (`'/favicon.svg'` or `'favicon.svg'`, both resolve the
+ * same) and is prefixed with Vite's `base` exactly like basalt's built-in set.
+ */
+export type BasaltAppIcon = {
+    /** Root-relative path under `public/`. Prefixed with Vite's resolved `base`. */
+    src: string;
+    /** Manifest `sizes`. `'any'` for a scalable SVG; `'192x192'` for a raster. */
+    sizes?: string;
+    /** MIME type, e.g. `'image/svg+xml'`. */
+    type?: string;
+    /** Manifest `purpose`, e.g. `'any maskable'`. */
+    purpose?: string;
+    /**
+     * Emit a head `<link rel="…">` for this icon too. Omitted → manifest only, which is what an app
+     * that links its own favicon from `index.html` wants.
+     */
+    rel?: 'icon' | 'shortcut icon' | 'apple-touch-icon' | 'mask-icon';
+};
 export type BasaltAppOptions = {
     /** App display name — used verbatim as the manifest `name` and (unless overridden) OG title. */
     name: string;
@@ -81,12 +104,28 @@ export type BasaltAppOptions = {
     /** Manifest `id`. Default: the resolved `startUrl` (default- or explicitly-derived, per above). */
     id?: string;
     /**
-     * Icon links + manifest icon paths. `false` skips BOTH — the head `<link>` icons and the
-     * manifest's `icons` array — so a manifest is never emitted pointing at files that 404.
+     * Which icons the plugin knows about — three forms, one question each.
+     *
+     * - **omitted / `{ dir }`** — basalt's own six-filename set (the realfavicongenerator layout argo
+     *   ships), optionally under a subdirectory of `public/`. Unchanged default.
+     * - **`false`** — no head `<link>` icons and no manifest `icons` member, so a manifest is never
+     *   emitted pointing at files that 404.
+     * - **an array** — the icons this app ACTUALLY has, named by the consumer.
+     *
+     * The array is the form for every app that was not scaffolded from basalt's icon set, which is
+     * most of them. `{ dir }` can only move the six fixed filenames; it cannot rename one, so an app
+     * whose single icon is `favicon.svg` had no way to say so and had to keep a hand-written manifest
+     * beside the generated head — the last thing standing between rb and deleting a file carrying a
+     * permanent `theme-allow-file`. One SVG at `sizes: 'any'` is a complete, installable icon set.
+     *
+     * Every entry becomes a manifest icon; an entry becomes a head `<link>` only when it names a
+     * {@link BasaltAppIcon.rel}. That split is deliberate — an app that already links its favicon
+     * from its own `index.html` wants the manifest fixed without a duplicate tag, and an app that
+     * wants the plugin to own the head says so per icon. An empty array reads as `false`.
      */
     icons?: false | {
         dir?: string;
-    };
+    } | readonly BasaltAppIcon[];
     /** Emits `<meta name="darkreader-lock">` when `'lock'` (default). Pass `false` to omit it. */
     darkreader?: 'lock' | false;
     /** Site-wide SEO metadata — only the keys provided are emitted, no per-page SEO. */

package/dist/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAA6B,YAAY,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAI/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAA;IACZ,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AA6CD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAgFpE;AAgBD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACrD;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAA;IAC/C;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wDAAwD;IACxD,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAA;IAChE;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mGAAmG;IACnG,EAAE,CAAC,EAAE,MAAM,CAAA;IACX;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC3B,oFAAoF;IACpF,GAAG,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,SAAS,GAAG,qBAAqB,CAAA;KAAE,CAAA;IACvF,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,KAAK,CAAA;IAChB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClD,CAAA;AA4gBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAMzE"}
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAA6B,YAAY,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAI/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAA;IACZ,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AA6CD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAgFpE;AAgBD;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAA;IACX,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,kBAAkB,GAAG,WAAW,CAAA;CAClE,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACrD;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAA;IAC/C;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wDAAwD;IACxD,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAA;IAChE;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mGAAmG;IACnG,EAAE,CAAC,EAAE,MAAM,CAAA;IACX;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,aAAa,EAAE,CAAA;IAC3D,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC3B,oFAAoF;IACpF,GAAG,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,SAAS,GAAG,qBAAqB,CAAA;KAAE,CAAA;IACvF,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,KAAK,CAAA;IAChB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClD,CAAA;AA0kBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAMzE"}

package/dist/vite.js

@@ -133,6 +133,18 @@ function withIconPath(dir, file) {
 function withBase(base, path) {
   return base + path.slice(1);
 }
+function isIconList(icons) {
+  return Array.isArray(icons);
+}
+function resolveIcons(icons) {
+  if (icons === false) return { mode: "none" };
+  if (icons === void 0) return { mode: "default", dir: void 0 };
+  if (!isIconList(icons)) return { mode: "default", dir: icons.dir };
+  return icons.length === 0 ? { mode: "none" } : { mode: "explicit", icons };
+}
+function iconHref(base, src) {
+  return withBase(base, src.startsWith("/") ? src : `/${src}`);
+}
 function hasViewportMeta(html) {
   return /<meta\s+[^>]*name=["']viewport["']/i.test(html);
 }
@@ -207,8 +219,7 @@ function buildStaticTags(input) {
     shortName,
     themeColor,
     bootStyle,
-    iconsEnabled,
-    iconsDir,
+    icons,
     darkreader,
     manifestEnabled,
     base,
@@ -234,13 +245,13 @@ function buildStaticTags(input) {
     }
   );
   tags.push({ tag: "style", children: bootStyle });
-  if (iconsEnabled) {
+  if (icons.mode === "default") {
     tags.push(
       {
         tag: "link",
         attrs: {
           rel: "shortcut icon",
-          href: withBase(base, withIconPath(iconsDir, ICON_FILES.favicon))
+          href: withBase(base, withIconPath(icons.dir, ICON_FILES.favicon))
         }
       },
       {
@@ -248,7 +259,7 @@ function buildStaticTags(input) {
         attrs: {
           rel: "icon",
           type: "image/svg+xml",
-          href: withBase(base, withIconPath(iconsDir, ICON_FILES.svg))
+          href: withBase(base, withIconPath(icons.dir, ICON_FILES.svg))
         }
       },
       {
@@ -256,7 +267,7 @@ function buildStaticTags(input) {
         attrs: {
           rel: "icon",
           sizes: "96x96",
-          href: withBase(base, withIconPath(iconsDir, ICON_FILES.png96))
+          href: withBase(base, withIconPath(icons.dir, ICON_FILES.png96))
         }
       },
       {
@@ -264,11 +275,25 @@ function buildStaticTags(input) {
         attrs: {
           rel: "apple-touch-icon",
           sizes: "180x180",
-          href: withBase(base, withIconPath(iconsDir, ICON_FILES.appleTouch))
+          href: withBase(base, withIconPath(icons.dir, ICON_FILES.appleTouch))
         }
       }
     );
   }
+  if (icons.mode === "explicit") {
+    for (const icon of icons.icons) {
+      if (icon.rel === void 0) continue;
+      tags.push({
+        tag: "link",
+        attrs: {
+          rel: icon.rel,
+          ...icon.type === void 0 ? {} : { type: icon.type },
+          ...icon.sizes === void 0 ? {} : { sizes: icon.sizes },
+          href: iconHref(base, icon.src)
+        }
+      });
+    }
+  }
   tags.push(
     { tag: "meta", attrs: { name: "apple-mobile-web-app-title", content: shortName } },
     { tag: "meta", attrs: { name: "apple-mobile-web-app-capable", content: "yes" } },
@@ -286,6 +311,34 @@ function buildStaticTags(input) {
   );
   return tags;
 }
+function manifestIcons(icons, base) {
+  if (icons.mode === "none") return {};
+  if (icons.mode === "default") {
+    return {
+      icons: [
+        {
+          src: withBase(base, withIconPath(icons.dir, ICON_FILES.manifest192)),
+          sizes: "192x192",
+          type: "image/png"
+        },
+        {
+          src: withBase(base, withIconPath(icons.dir, ICON_FILES.manifest512)),
+          sizes: "512x512",
+          type: "image/png",
+          purpose: "any maskable"
+        }
+      ]
+    };
+  }
+  return {
+    icons: icons.icons.map((icon) => ({
+      src: iconHref(base, icon.src),
+      ...icon.sizes === void 0 ? {} : { sizes: icon.sizes },
+      ...icon.type === void 0 ? {} : { type: icon.type },
+      ...icon.purpose === void 0 ? {} : { purpose: icon.purpose }
+    }))
+  };
+}
 function buildManifestJson(input) {
   const {
     options,
@@ -296,8 +349,7 @@ function buildManifestJson(input) {
     display,
     schemeColor,
     backgroundColor,
-    iconsEnabled,
-    iconsDir,
+    icons,
     base
   } = input;
   const manifest = {
@@ -316,21 +368,9 @@ function buildManifestJson(input) {
     // `{ manifest: true, icons: false }` shipped a manifest pointing at two PNGs the app never
     // ships — an installable app with broken icons, and the reason rb went hybrid (plugin for the
     // head, a hand-written manifest for the rest). A manifest with NO icons member is valid.
-    ...iconsEnabled ? {
-      icons: [
-        {
-          src: withBase(base, withIconPath(iconsDir, ICON_FILES.manifest192)),
-          sizes: "192x192",
-          type: "image/png"
-        },
-        {
-          src: withBase(base, withIconPath(iconsDir, ICON_FILES.manifest512)),
-          sizes: "512x512",
-          type: "image/png",
-          purpose: "any maskable"
-        }
-      ]
-    } : {}
+    // The `'explicit'` arm is the other half of that fix: honest about icons it cannot see was
+    // only worth having once a consumer could tell it which icons it DOES have.
+    ...manifestIcons(icons, base)
   };
   return JSON.stringify(manifest, null, 2);
 }
@@ -338,8 +378,7 @@ function createMainPlugin(options) {
   const shortName = options.shortName ?? options.name;
   const display = options.display ?? "standalone";
   const darkreader = options.darkreader ?? "lock";
-  const iconsEnabled = options.icons !== false;
-  const iconsDir = options.icons === false ? void 0 : options.icons?.dir;
+  const icons = resolveIcons(options.icons);
   const manifestEnabled = options.manifest !== false;
   const themeColor = resolveThemeColors(options.themeColor);
   const colorScheme = options.colorScheme ?? "dark";
@@ -371,8 +410,7 @@ function createMainPlugin(options) {
         display,
         schemeColor,
         backgroundColor,
-        iconsEnabled,
-        iconsDir,
+        icons,
         base
       });
       staticTags = buildStaticTags({
@@ -380,8 +418,7 @@ function createMainPlugin(options) {
         shortName,
         themeColor,
         bootStyle,
-        iconsEnabled,
-        iconsDir,
+        icons,
         darkreader,
         manifestEnabled,
         base,

package/llms.txt

@@ -1,4 +1,4 @@
-# basalt-ui v1.22.0
+# basalt-ui v1.23.0
 # Opinionated framework for Mantine-based React apps — theme, app shell, visx charts, toolchain presets
 #
 # basalt-ui is an opinionated framework for Mantine-based React apps.
@@ -19,7 +19,7 @@
 # ./tokens.css subpath. Guide: docs/FRAMEWORK-FREE.md in the repo.
 
 Package: basalt-ui
-Version: 1.22.0
+Version: 1.23.0
 
 ## basalt-ui
 Import: import { ... } from 'basalt-ui'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "basalt-ui",
-  "version": "1.22.0",
+  "version": "1.23.0",
   "description": "Opinionated framework for Mantine-based React apps — theme, app shell, visx charts, toolchain presets",
   "keywords": [
     "charts",