@loworbitstudio/visor 1.18.1 → 1.19.0

package/dist/CHANGELOG.json

@@ -1,6 +1,6 @@
 {
   "version": "0.4.0",
-  "generated_at": "2026-07-15T17:44:38.986Z",
+  "generated_at": "2026-07-20T05:09:50.016Z",
   "components": {
     "accessibility-specimen": {
       "changeType": "current",

package/dist/index.js

@@ -2,14 +2,14 @@
 
 // src/index.ts
 import { readFileSync as readFileSync33 } from "fs";
-import { dirname as dirname13, join as join33 } from "path";
+import { dirname as dirname14, join as join33 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { Command as Command2 } from "commander";
 
 // src/commands/check.ts
 import { Command } from "commander";
 import { statSync as statSync3 } from "fs";
-import { resolve as resolve4, dirname as dirname2 } from "path";
+import { resolve as resolve4, dirname as dirname3 } from "path";
 
 // src/registry/resolve.ts
 import { readFileSync } from "fs";
@@ -396,7 +396,7 @@ async function scanJsx(pathArg) {
 
 // src/check/design.ts
 import { readFileSync as readFileSync3, readdirSync as readdirSync2, statSync as statSync2, existsSync } from "fs";
-import { resolve as resolve2, extname as extname2, join as join3, basename } from "path";
+import { resolve as resolve2, extname as extname2, join as join3, basename, dirname as dirname2 } from "path";
 function loadVisorRc(dir) {
   const rcPath = join3(dir, ".visorrc.json");
   if (!existsSync(rcPath)) return {};
@@ -823,6 +823,118 @@ function ruleExcessiveCardNesting(source, filePath) {
   }
   return found;
 }
+var NATIVE_CONTROL_COMPONENTS = /* @__PURE__ */ new Set([
+  ...Object.values(NATIVE_TO_VISOR).map((m) => m.visorName),
+  ...Object.values(INPUT_TYPE_MAP).map((m) => m.visorName)
+]);
+var RESET_IMPORT_RE = /@loworbitstudio\/visor-core\/reset/;
+var PREFLIGHT_RE = /@tailwind\s+base|@import\s+["']tailwindcss["']/;
+var baseLayerStateCache = /* @__PURE__ */ new Map();
+var baseLayerReported = /* @__PURE__ */ new Set();
+function resetBaseLayerCache() {
+  baseLayerStateCache.clear();
+  baseLayerReported.clear();
+}
+function findProjectRoot(filePath) {
+  let dir = dirname2(resolve2(filePath));
+  for (; ; ) {
+    if (existsSync(join3(dir, "package.json"))) return dir;
+    const parent = dirname2(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function collectStylesheets(root) {
+  const out = [];
+  function recurse(dir, depth) {
+    if (depth > 6) return;
+    let entries;
+    try {
+      entries = readdirSync2(dir);
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (entry === "node_modules" || entry === "dist" || entry.startsWith(".")) continue;
+      const full = join3(dir, entry);
+      let s;
+      try {
+        s = statSync2(full);
+      } catch {
+        continue;
+      }
+      if (s.isDirectory()) recurse(full, depth + 1);
+      else if (extname2(full) === ".css") out.push(full);
+    }
+  }
+  recurse(root, 0);
+  return out;
+}
+function baseLayerState(root) {
+  const cached = baseLayerStateCache.get(root);
+  if (cached) return cached;
+  let hasReset = false;
+  let hasPreflight = false;
+  for (const sheet of collectStylesheets(root)) {
+    let css;
+    try {
+      css = readFileSync3(sheet, "utf-8");
+    } catch {
+      continue;
+    }
+    if (RESET_IMPORT_RE.test(css)) hasReset = true;
+    if (PREFLIGHT_RE.test(css)) hasPreflight = true;
+    if (hasReset && hasPreflight) break;
+  }
+  const corePath = join3(root, "node_modules", "@loworbitstudio", "visor-core");
+  const state = {
+    hasReset,
+    hasPreflight,
+    visorCoreInstalled: existsSync(corePath),
+    visorCoreExportsReset: existsSync(join3(corePath, "dist", "reset.css"))
+  };
+  baseLayerStateCache.set(root, state);
+  return state;
+}
+function ruleMissingVisorBaseLayer(source, filePath) {
+  if (!CODE_EXTS.has(extname2(filePath))) return [];
+  const src = lines(source);
+  let usageLine = -1;
+  for (let i = 0; i < src.length; i++) {
+    const spec = src[i].match(/from\s+["'][^"']*components\/ui\/([a-z0-9-]+)["']/);
+    if (spec && NATIVE_CONTROL_COMPONENTS.has(spec[1])) {
+      usageLine = i + 1;
+      break;
+    }
+  }
+  if (usageLine === -1) return [];
+  const root = findProjectRoot(filePath);
+  if (!root || baseLayerReported.has(root)) return [];
+  const state = baseLayerState(root);
+  if (state.visorCoreInstalled && !state.visorCoreExportsReset) {
+    baseLayerReported.add(root);
+    return [finding(
+      filePath,
+      usageLine,
+      "missing-visor-base-layer",
+      "warn",
+      "The installed @loworbitstudio/visor-core predates the /reset export, so Visor's element baseline is unavailable. Form controls will render in the browser's default font rather than your theme font.",
+      'Run `npm update @loworbitstudio/visor-core`, then add `@import "@loworbitstudio/visor-core/reset";` to your global stylesheet.'
+    )];
+  }
+  if (!state.hasReset && !state.hasPreflight) {
+    baseLayerReported.add(root);
+    return [finding(
+      filePath,
+      usageLine,
+      "missing-visor-base-layer",
+      "warn",
+      "This project renders Visor form controls but imports neither @loworbitstudio/visor-core/reset nor Tailwind preflight. Without an element baseline, inputs, selects and buttons fall back to the UA font instead of inheriting your theme font.",
+      'Add `@import "@loworbitstudio/visor-core/reset";` to your global stylesheet \u2014 or keep your existing reset/preflight and disable this rule in .visorrc.json.'
+    )];
+  }
+  return [];
+}
 var RULES = [
   // Errors — Borealis non-negotiables
   { name: "tier-1-token-direct-usage", severity: "error", fn: ruleTier1TokenDirectUsage },
@@ -841,11 +953,13 @@ var RULES = [
   { name: "sub-44px-touch-target", severity: "warn", fn: ruleSub44pxTouchTarget },
   { name: "line-length-over-75ch", severity: "warn", fn: ruleLineLengthOver75ch },
   { name: "gradient-text", severity: "warn", fn: ruleGradientText },
-  { name: "excessive-card-nesting", severity: "warn", fn: ruleExcessiveCardNesting }
+  { name: "excessive-card-nesting", severity: "warn", fn: ruleExcessiveCardNesting },
+  { name: "missing-visor-base-layer", severity: "warn", fn: ruleMissingVisorBaseLayer }
 ];
 function scanDesign(pathArg, options = {}) {
   const files = collectFiles2(pathArg);
   const { disabledRules = [], errorsOnly = false } = options;
+  resetBaseLayerCache();
   const activeRules = RULES.filter((r) => {
     if (disabledRules.includes(r.name)) return false;
     if (errorsOnly && r.severity !== "error") return false;
@@ -1095,7 +1209,7 @@ async function checkDiffCommand(pathArg, options) {
 }
 function checkDesignCommand(pathArg, options) {
   const absPath = resolve4(pathArg);
-  const rcDir = statSync3(absPath).isDirectory() ? absPath : dirname2(absPath);
+  const rcDir = statSync3(absPath).isDirectory() ? absPath : dirname3(absPath);
   const rc = loadVisorRc(rcDir);
   const result = scanDesign(absPath, {
     disabledRules: rc.disabledRules ?? [],
@@ -1204,7 +1318,7 @@ function checkCommand() {
 
 // src/commands/init.ts
 import { existsSync as existsSync6, writeFileSync as writeFileSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync9 } from "fs";
-import { join as join8, dirname as dirname4, basename as basename2 } from "path";
+import { join as join8, dirname as dirname5, basename as basename2 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import * as childProcess2 from "child_process";
 
@@ -1392,7 +1506,7 @@ export default function RootLayout({ children }: { children: ReactNode }) {
 
 // src/commands/init-plays/registry.ts
 import { existsSync as existsSync4, mkdirSync, readFileSync as readFileSync7, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname3, join as join6 } from "path";
+import { dirname as dirname4, join as join6 } from "path";
 
 // src/commands/init-plays/pattern-build.ts
 var patternBuildPlay = {
@@ -1448,7 +1562,7 @@ function readPlayState(statePath) {
   }
 }
 function writePlayState(statePath, state) {
-  mkdirSync(dirname3(statePath), { recursive: true });
+  mkdirSync(dirname4(statePath), { recursive: true });
   writeFileSync2(statePath, JSON.stringify(state, null, 2) + "\n", "utf-8");
 }
 
@@ -1758,7 +1872,7 @@ function scaffoldNextjs(cwd, json, filesCreated, filesSkipped, warnings) {
     config: data.config
   });
   const globalsPath = join8(cwd, "app", "globals.css");
-  const globalsDir = dirname4(globalsPath);
+  const globalsDir = dirname5(globalsPath);
   mkdirSync2(globalsDir, { recursive: true });
   if (existsSync6(globalsPath)) {
     writeFileSync3(globalsPath, css, "utf-8");
@@ -1843,7 +1957,7 @@ function assertSpawnSuccess(result, label) {
 }
 function readVisorCliVersion() {
   try {
-    const here = dirname4(fileURLToPath2(import.meta.url));
+    const here = dirname5(fileURLToPath2(import.meta.url));
     for (let i = 0; i < 5; i++) {
       const segments = new Array(i).fill("..");
       const candidate = join8(here, ...segments, "package.json");
@@ -1867,7 +1981,7 @@ import {
   existsSync as existsSync7,
   mkdirSync as mkdirSync3
 } from "fs";
-import { dirname as dirname5, join as join9 } from "path";
+import { dirname as dirname6, join as join9 } from "path";
 function resolveOutputPath(registryPath, type, config, cwd) {
   let relativePath;
   if (type === "registry:block") {
@@ -1897,7 +2011,7 @@ function resolveOutputPath(registryPath, type, config, cwd) {
   return join9(cwd, registryPath);
 }
 function writeFile(filePath, content) {
-  const dir = dirname5(filePath);
+  const dir = dirname6(filePath);
   if (!existsSync7(dir)) {
     mkdirSync3(dir, { recursive: true });
   }
@@ -2825,7 +2939,7 @@ function infoCommand(name, cwd, options = {}) {
 
 // src/commands/theme-apply.ts
 import { readFileSync as readFileSync13, writeFileSync as writeFileSync8, mkdirSync as mkdirSync6 } from "fs";
-import { resolve as resolve7, dirname as dirname7, join as join15 } from "path";
+import { resolve as resolve7, dirname as dirname8, join as join15 } from "path";
 import { generateTheme, generateThemeData as generateThemeData3 } from "@loworbitstudio/visor-theme-engine";
 import {
   nextjsAdapter as nextjsAdapter2,
@@ -2905,10 +3019,10 @@ function parseBlessedManifest(buildDir) {
 
 // src/lib/theme-apply-targets/globals-css.ts
 import { existsSync as existsSync11, mkdirSync as mkdirSync4, writeFileSync as writeFileSync6 } from "fs";
-import { dirname as dirname6, isAbsolute, join as join13, resolve as resolve5 } from "path";
+import { dirname as dirname7, isAbsolute, join as join13, resolve as resolve5 } from "path";
 function applyGlobalsCss(input) {
   const outFile = input.path !== void 0 ? resolveInsideBuild(input.buildDir, input.path) : resolveDefaultGlobalsCss(input.buildDir);
-  mkdirSync4(dirname6(outFile), { recursive: true });
+  mkdirSync4(dirname7(outFile), { recursive: true });
   writeFileSync6(outFile, input.adapterCss, "utf-8");
   return outFile;
 }
@@ -3139,7 +3253,7 @@ function themeApplyCommand(file, cwd, options) {
       let totalBytes = 0;
       for (const [relPath, content] of Object.entries(fileMap.files)) {
         const filePath2 = join15(outputPath, relPath);
-        mkdirSync6(dirname7(filePath2), { recursive: true });
+        mkdirSync6(dirname8(filePath2), { recursive: true });
         writeFileSync8(filePath2, content, "utf-8");
         totalBytes += content.length;
       }
@@ -3177,7 +3291,7 @@ function themeApplyCommand(file, cwd, options) {
   if (css === null) {
     process.exit(1);
   }
-  const outputDir = dirname7(outputPath);
+  const outputDir = dirname8(outputPath);
   try {
     mkdirSync6(outputDir, { recursive: true });
     writeFileSync8(outputPath, css, "utf-8");
@@ -3973,7 +4087,7 @@ import { docsAdapter as docsAdapter2 } from "@loworbitstudio/visor-theme-engine/
 
 // src/utils/theme-helpers.ts
 import { existsSync as existsSync14, lstatSync, readdirSync as readdirSync5, readFileSync as readFileSync17, readlinkSync, realpathSync, statSync as statSync6 } from "fs";
-import { resolve as resolve12, dirname as dirname8, join as join17 } from "path";
+import { resolve as resolve12, dirname as dirname9, join as join17 } from "path";
 import { execFileSync as execFileSync3 } from "child_process";
 function toSlug(name) {
   return name.toLowerCase().replace(/\s+/g, "-");
@@ -3987,7 +4101,7 @@ function findRepoRoot(startDir) {
     if (existsSync14(join17(current, "packages", "docs"))) {
       return current;
     }
-    const parent = dirname8(current);
+    const parent = dirname9(current);
     if (parent === current) break;
     current = parent;
   }
@@ -4002,7 +4116,7 @@ function findMainRepoRoot(startDir) {
     }).trim();
     if (commonDir) {
       const absoluteCommonDir = resolve12(startDir, commonDir);
-      const candidate = dirname8(absoluteCommonDir);
+      const candidate = dirname9(absoluteCommonDir);
       if (existsSync14(join17(candidate, "packages", "docs"))) {
         return candidate;
       }
@@ -4085,7 +4199,7 @@ function detectVisorWorkspace(cwd) {
       } catch {
       }
     }
-    const parent = dirname8(current);
+    const parent = dirname9(current);
     if (parent === current) break;
     current = parent;
   }
@@ -5064,7 +5178,7 @@ import {
   readdirSync as readdirSync7,
   rmSync
 } from "fs";
-import { join as join21, basename as basename5, dirname as dirname9 } from "path";
+import { join as join21, basename as basename5, dirname as dirname10 } from "path";
 import { generateThemeData as generateThemeData6 } from "@loworbitstudio/visor-theme-engine";
 import { flutterAdapter as flutterAdapter2 } from "@loworbitstudio/visor-theme-engine/adapters";
 function scanThemeDir2(dir) {
@@ -5318,7 +5432,7 @@ function themeBatchApplyFlutterCommand(cwd, options) {
   let totalFiles = 0;
   for (const [relPath, content] of Object.entries(packageFiles)) {
     const absPath = join21(outputDir, relPath);
-    mkdirSync9(dirname9(absPath), { recursive: true });
+    mkdirSync9(dirname10(absPath), { recursive: true });
     writeFileSync13(absPath, content, "utf-8");
     totalFiles++;
   }
@@ -5326,7 +5440,7 @@ function themeBatchApplyFlutterCommand(cwd, options) {
     const themeBaseDir = join21(outputDir, "lib", "src", slug2);
     for (const [relPath, content] of Object.entries(tokenFiles)) {
       const absPath = join21(themeBaseDir, relPath);
-      mkdirSync9(dirname9(absPath), { recursive: true });
+      mkdirSync9(dirname10(absPath), { recursive: true });
       writeFileSync13(absPath, content, "utf-8");
       totalFiles++;
     }
@@ -6402,13 +6516,13 @@ function migrateTokenSubstitutionCommand(targetArg, cwd, options) {
 
 // src/commands/sandbox/init.ts
 import { existsSync as existsSync25, mkdirSync as mkdirSync12, readFileSync as readFileSync28, rmSync as rmSync2 } from "fs";
-import { isAbsolute as isAbsolute4, join as join27, resolve as resolve18, dirname as dirname11 } from "path";
+import { isAbsolute as isAbsolute4, join as join27, resolve as resolve18, dirname as dirname12 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import * as childProcess3 from "child_process";
 
 // src/commands/sandbox/parse-handoff.ts
 import { readFileSync as readFileSync26, existsSync as existsSync23 } from "fs";
-import { dirname as dirname10, resolve as resolve17, isAbsolute as isAbsolute3 } from "path";
+import { dirname as dirname11, resolve as resolve17, isAbsolute as isAbsolute3 } from "path";
 function parseHandoff(handoffPath) {
   const text = readFileSync26(handoffPath, "utf-8");
   const lines2 = text.split("\n");
@@ -6449,7 +6563,7 @@ function extractRecipePath(text, handoffPath, warnings) {
   }
   const href = m[2].trim();
   if (isAbsolute3(href)) return href;
-  return resolve17(dirname10(handoffPath), href);
+  return resolve17(dirname11(handoffPath), href);
 }
 var STATUS_PATTERNS = [
   { re: /NEW\s+gap/i, status: "gap-new" },
@@ -7620,7 +7734,7 @@ function loadKnownPrimitives() {
 }
 function readCliVersion() {
   try {
-    const here = dirname11(fileURLToPath3(import.meta.url));
+    const here = dirname12(fileURLToPath3(import.meta.url));
     for (let i = 0; i < 6; i++) {
       const segments = new Array(i).fill("..");
       const candidate = join27(here, ...segments, "package.json");
@@ -8174,7 +8288,7 @@ function spawnCommand(cwd, options) {
 
 // src/commands/render.ts
 import { existsSync as existsSync30, mkdirSync as mkdirSync14, readFileSync as readFileSync32 } from "fs";
-import { dirname as dirname12, isAbsolute as isAbsolute6, resolve as resolve20 } from "path";
+import { dirname as dirname13, isAbsolute as isAbsolute6, resolve as resolve20 } from "path";
 var FIXTURES = {
   "stat-card": {
     default: {
@@ -8536,7 +8650,7 @@ async function renderCommand(component, cwd, options) {
   const width = Number(options.width ?? 720);
   const height = Number(options.height ?? 640);
   const outPath = resolveOutPath(cwd, options.out, component, options.theme, mode, state);
-  mkdirSync14(dirname12(outPath), { recursive: true });
+  mkdirSync14(dirname13(outPath), { recursive: true });
   const browser = await playwright.chromium.launch();
   let probe;
   try {
@@ -8648,7 +8762,7 @@ function formatBytes2(bytes) {
 }
 
 // src/index.ts
-var __dirname2 = dirname13(fileURLToPath4(import.meta.url));
+var __dirname2 = dirname14(fileURLToPath4(import.meta.url));
 var pkg = JSON.parse(
   readFileSync33(join33(__dirname2, "..", "package.json"), "utf-8")
 );