@botfather/units-tools 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The Units Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/format-ui.mjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import fs from "node:fs/promises";
+import path from "node:path";
+import { formatUnits } from "@botfather/units/print";
+
+async function collectUiFiles(entry, isRoot = false) {
+  const base = path.basename(entry);
+  if (base === "node_modules" || base === ".git" || base === "dist" || base === "build" || base === ".vite") {
+    return [];
+  }
+  let stat = await fs.lstat(entry);
+  if (stat.isSymbolicLink()) {
+    if (!isRoot) return [];
+    stat = await fs.stat(entry);
+  }
+  if (stat.isFile()) return entry.endsWith(".ui") ? [entry] : [];
+  const out = [];
+  const items = await fs.readdir(entry);
+  for (const item of items) {
+    const full = path.join(entry, item);
+    const sub = await collectUiFiles(full, false);
+    out.push(...sub);
+  }
+  return out;
+}
+
+async function formatFile(file) {
+  const src = await fs.readFile(file, "utf-8");
+  const formatted = formatUnits(src);
+  if (formatted !== src) {
+    await fs.writeFile(file, formatted, "utf-8");
+    return true;
+  }
+  return false;
+}
+
+const targets = process.argv.slice(2);
+if (targets.length === 0) {
+  console.error("Usage: node format-ui.mjs <file-or-dir>...");
+  process.exit(1);
+}
+
+let changed = 0;
+for (const target of targets) {
+  const abs = path.resolve(process.cwd(), target);
+  const files = await collectUiFiles(abs, true);
+  for (const file of files) {
+    const didChange = await formatFile(file);
+    if (didChange) changed++;
+  }
+}
+
+console.log(`Formatted ${changed} file(s).`);

package/lint-ui.mjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const lintScript = path.join(here, "units-lint.mjs");
+const targets = process.argv.slice(2);
+const args = [lintScript, ...(targets.length ? targets : ["examples", "packages/units-uikit-shadcn"])];
+
+const child = spawn(process.execPath, args, { stdio: "inherit" });
+child.on("exit", (code) => process.exit(code ?? 1));

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@botfather/units-tools",
+  "version": "1.0.0",
+  "description": "CLI tools for Units (.ui) formatting, linting, manifests, and watch.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Botfather/units.git",
+    "directory": "packages/units-tools"
+  },
+  "homepage": "https://github.com/Botfather/units/tree/main/packages/units-tools",
+  "bugs": {
+    "url": "https://github.com/Botfather/units/issues"
+  },
+  "bin": {
+    "units-format": "./units-format.mjs",
+    "units-lint": "./units-lint.mjs",
+    "units-emit": "./units-emit.mjs",
+    "units-manifest": "./units-manifest.mjs",
+    "units-watch": "./units-watch.mjs",
+    "format-ui": "./format-ui.mjs",
+    "lint-ui": "./lint-ui.mjs"
+  },
+  "files": [
+    "*.mjs"
+  ],
+  "dependencies": {
+    "@botfather/units": "1.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/units-emit.mjs

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+import fs from "node:fs/promises";
+import path from "node:path";
+import { parseUnits } from "@botfather/units/parser";
+
+async function collectUiFiles(entry, isRoot = false) {
+  const base = path.basename(entry);
+  if (base === "node_modules" || base === ".git" || base === "dist" || base === "build" || base === ".vite" || base === "vite-app") {
+    return [];
+  }
+  let stat = await fs.lstat(entry);
+  if (stat.isSymbolicLink()) {
+    if (!isRoot) return [];
+    stat = await fs.stat(entry);
+  }
+  if (stat.isFile()) return entry.endsWith(".ui") ? [entry] : [];
+  const out = [];
+  const items = await fs.readdir(entry);
+  for (const item of items) {
+    const full = path.join(entry, item);
+    const sub = await collectUiFiles(full, false);
+    out.push(...sub);
+  }
+  return out;
+}
+
+async function emitAst(file) {
+  const src = await fs.readFile(file, "utf-8");
+  const ast = parseUnits(src);
+  const outFile = `${file}.ast.json`;
+  await fs.writeFile(outFile, JSON.stringify(ast), "utf-8");
+  return outFile;
+}
+
+const targets = process.argv.slice(2);
+if (targets.length === 0) {
+  console.error("Usage: node units-emit.mjs <file-or-dir>...");
+  process.exit(1);
+}
+
+let count = 0;
+for (const target of targets) {
+  const abs = path.resolve(process.cwd(), target);
+const files = await collectUiFiles(abs, true);
+  for (const file of files) {
+    await emitAst(file);
+    count++;
+  }
+}
+
+console.log(`Emitted AST for ${count} file(s).`);

package/units-format.mjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import fs from "node:fs/promises";
+import path from "node:path";
+import { formatUnits } from "@botfather/units/print";
+
+async function collectUiFiles(entry, isRoot = false) {
+  const base = path.basename(entry);
+  if (base === "node_modules" || base === ".git" || base === "dist" || base === "build" || base === ".vite" || base === "vite-app") {
+    return [];
+  }
+  let stat = await fs.lstat(entry);
+  if (stat.isSymbolicLink()) {
+    if (!isRoot) return [];
+    stat = await fs.stat(entry);
+  }
+  if (stat.isFile()) return entry.endsWith(".ui") ? [entry] : [];
+  const out = [];
+  const items = await fs.readdir(entry);
+  for (const item of items) {
+    const full = path.join(entry, item);
+    const sub = await collectUiFiles(full, false);
+    out.push(...sub);
+  }
+  return out;
+}
+
+async function formatFile(file) {
+  const src = await fs.readFile(file, "utf-8");
+  const formatted = formatUnits(src);
+  if (formatted !== src) {
+    await fs.writeFile(file, formatted, "utf-8");
+    return true;
+  }
+  return false;
+}
+
+const targets = process.argv.slice(2);
+if (targets.length === 0) {
+  console.error("Usage: node units-format.mjs <file-or-dir>...");
+  process.exit(1);
+}
+
+let changed = 0;
+for (const target of targets) {
+  const abs = path.resolve(process.cwd(), target);
+  const files = await collectUiFiles(abs, true);
+  for (const file of files) {
+    const didChange = await formatFile(file);
+    if (didChange) changed++;
+  }
+}
+
+console.log(`Formatted ${changed} file(s).`);

package/units-lint.mjs

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import fs from "node:fs/promises";
+import path from "node:path";
+import { formatUnits } from "@botfather/units/print";
+
+async function collectUiFiles(entry, isRoot = false) {
+  const base = path.basename(entry);
+  if (base === "node_modules" || base === ".git" || base === "dist" || base === "build" || base === ".vite" || base === "vite-app") {
+    return [];
+  }
+  let stat = await fs.lstat(entry);
+  if (stat.isSymbolicLink()) {
+    if (!isRoot) return [];
+    stat = await fs.stat(entry);
+  }
+  if (stat.isFile()) return entry.endsWith(".ui") ? [entry] : [];
+  const out = [];
+  const items = await fs.readdir(entry);
+  for (const item of items) {
+    const full = path.join(entry, item);
+    const sub = await collectUiFiles(full, false);
+    out.push(...sub);
+  }
+  return out;
+}
+
+async function lintFile(file) {
+  const src = await fs.readFile(file, "utf-8");
+  const formatted = formatUnits(src);
+  if (formatted !== src) {
+    console.error(`Not formatted: ${file}`);
+    return false;
+  }
+  return true;
+}
+
+const targets = process.argv.slice(2);
+if (targets.length === 0) {
+  console.error("Usage: node units-lint.mjs <file-or-dir>...");
+  process.exit(1);
+}
+
+let ok = true;
+for (const target of targets) {
+  const abs = path.resolve(process.cwd(), target);
+  const files = await collectUiFiles(abs, true);
+  for (const file of files) {
+    const pass = await lintFile(file);
+    if (!pass) ok = false;
+  }
+}
+
+process.exit(ok ? 0 : 1);

package/units-manifest.mjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import fs from "node:fs/promises";
+import path from "node:path";
+
+async function collectUiFiles(entry, isRoot = false) {
+  const base = path.basename(entry);
+  if (base === "node_modules" || base === ".git" || base === "dist" || base === "build" || base === ".vite" || base === "vite-app") {
+    return [];
+  }
+  let stat = await fs.lstat(entry);
+  if (stat.isSymbolicLink()) {
+    if (!isRoot) return [];
+    stat = await fs.stat(entry);
+  }
+  if (stat.isFile()) return entry.endsWith(".ui") ? [entry] : [];
+  const out = [];
+  const items = await fs.readdir(entry);
+  for (const item of items) {
+    const full = path.join(entry, item);
+    const sub = await collectUiFiles(full, false);
+    out.push(...sub);
+  }
+  return out;
+}
+
+function toComponentName(file) {
+  return path.basename(file, ".ui");
+}
+
+function toRel(from, file) {
+  const rel = path.relative(from, file);
+  return rel.startsWith(".") ? rel : `./${rel}`;
+}
+
+const [rootDir, outFile] = process.argv.slice(2);
+if (!rootDir || !outFile) {
+  console.error("Usage: node units-manifest.mjs <rootDir> <outFile>");
+  process.exit(1);
+}
+
+const rootAbs = path.resolve(process.cwd(), rootDir);
+const outAbs = path.resolve(process.cwd(), outFile);
+const outDir = path.dirname(outAbs);
+
+const files = await collectUiFiles(rootAbs, true);
+files.sort();
+
+let imports = "";
+let entries = "";
+
+files.forEach((file, idx) => {
+  const name = toComponentName(file);
+  const rel = toRel(outDir, file).replace(/\\/g, "/");
+  const varName = `Ast_${idx}`;
+  imports += `import ${varName} from \"${rel}\";\n`;
+  entries += `  \"${name}\": ${varName},\n`;
+});
+
+const content = `${imports}\nexport const uiManifest = {\n${entries}};\n`;
+await fs.writeFile(outAbs, content, "utf-8");
+
+console.log(`Wrote manifest with ${files.length} entries -> ${outAbs}`);

package/units-watch.mjs

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { spawn } from "node:child_process";
+
+const [rootDir, outFile] = process.argv.slice(2);
+if (!rootDir || !outFile) {
+  console.error("Usage: node units-watch.mjs <rootDir> <outFile>");
+  process.exit(1);
+}
+
+const rootAbs = path.resolve(process.cwd(), rootDir);
+const outAbs = path.resolve(process.cwd(), outFile);
+
+const ignoreDirs = new Set(["node_modules", ".git", "dist", "build", ".vite", "vite-app"]);
+
+function shouldIgnore(filePath) {
+  const parts = filePath.split(path.sep);
+  return parts.some((p) => ignoreDirs.has(p));
+}
+
+function isUi(filePath) {
+  return filePath.endsWith(".ui");
+}
+
+function runTool(script, args) {
+  return new Promise((resolve, reject) => {
+    const proc = spawn(process.execPath, [script, ...args], { stdio: "inherit" });
+    proc.on("exit", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`${script} failed with code ${code}`));
+    });
+  });
+}
+
+let timer = null;
+let running = false;
+let pending = false;
+
+async function rebuild() {
+  if (running) {
+    pending = true;
+    return;
+  }
+  running = true;
+  try {
+    const toolsDir = path.resolve(path.dirname(new URL(import.meta.url).pathname));
+    const manifestTool = path.resolve(toolsDir, "units-manifest.mjs");
+    const emitTool = path.resolve(toolsDir, "units-emit.mjs");
+    await runTool(manifestTool, [rootAbs, outAbs]);
+    await runTool(emitTool, [rootAbs]);
+  } catch (err) {
+    console.error(err.message || err);
+  } finally {
+    running = false;
+    if (pending) {
+      pending = false;
+      rebuild();
+    }
+  }
+}
+
+function schedule() {
+  if (timer) clearTimeout(timer);
+  timer = setTimeout(rebuild, 200);
+}
+
+console.log(`Watching ${rootAbs} for .ui changes...`);
+rebuild();
+
+const watcher = fs.watch(rootAbs, { recursive: true }, (event, filename) => {
+  if (!filename) return;
+  const full = path.join(rootAbs, filename);
+  if (shouldIgnore(full)) return;
+  if (!isUi(full)) return;
+  schedule();
+});
+
+process.on("SIGINT", () => {
+  watcher.close();
+  process.exit(0);
+});