@threadlabs/looma-docs 0.0.0-stage → 0.52.1

package/docs/value-editors.mjs

@@ -0,0 +1,37 @@
+/** Translate canonical recipe values for the reusable value editors; never duplicate design bounds here. */
+const lengthUnits = { px: 1, rem: 16, em: 16, cm: 96 / 2.54, mm: 96 / 25.4, Q: 96 / 101.6, in: 96, pt: 96 / 72, pc: 16 };
+const timeUnits = { ms: 1, s: 1000 };
+const rounded = value => String(Number(Number(value).toFixed(6)));
+
+export function valueEditor(field, value, { remPixels = 16 } = {}) {
+  if (field.type === 'inherited-length') return { kind: 'inherited-size', value };
+  if (field.id === 'text-size') return { kind: 'number', value, unit: 'px', min: field.min, max: field.max, step: 1 };
+  if (field.type === 'choice') return { kind: 'choice', value };
+  if (field.type === 'easing') return { kind: /^step-/.test(value) ? 'text' : 'curve', value };
+  if (['colour', 'optional-colour', 'font'].includes(field.type)) return { kind: 'text', value };
+  if (field.type.includes('length') || field.type === 'time') {
+    const unit = value.match(/[a-z]+$/i)?.[0] ?? 'px';
+    // Convert authoring limits against the same root as the displayed quantity.
+    const units = field.type === 'time' ? timeUnits : { ...lengthUnits, rem: remPixels };
+    const factor = units[unit];
+    return { kind: 'number', value: value === '0' ? '0px' : value, unit,
+      min: factor ? field.min / factor : .001, max: factor ? field.max / factor : 1000000,
+      step: (field.type === 'time' ? 10 : field.id === 'line-weight' ? .25 : 1) / (factor ?? 1),
+      units: field.type === 'time' ? ['ms', 's'] : ['px', 'rem'], convertible: Boolean(factor) };
+  }
+  const scale = field.type === 'fraction' || field.id === 'spacing' ? 100 : 1;
+  return { kind: field.type === 'weight' ? 'number' : 'slider', value: field.type === 'weight' ? value : Number(value) * scale,
+    min: field.min * scale, max: field.max * scale, step: field.type === 'weight' ? 50 : scale === 100 ? 1 : .01,
+    unit: scale === 100 ? '%' : '', scale };
+}
+
+export function editorValue(field, value) {
+  return field.type === 'fraction' || field.id === 'spacing' ? rounded(Number(value) / 100) : String(value);
+}
+
+export function convertValueUnit(value, nextUnit, { remPixels = 16 } = {}) {
+  const unit = value.match(/[a-z]+$/i)?.[0] ?? 'px';
+  const units = Object.hasOwn(timeUnits, unit) ? timeUnits : { ...lengthUnits, rem: remPixels, em: remPixels };
+  if (!Object.hasOwn(units, unit) || !Object.hasOwn(units, nextUnit)) throw new Error('Choose compatible units.');
+  return rounded(parseFloat(value) * units[unit] / units[nextUnit]) + nextUnit;
+}

package/docs/workspace.mjs

@@ -0,0 +1,32 @@
+import { lstat, mkdir, open, realpath, unlink } from 'node:fs/promises';
+import path from 'node:path';
+
+export async function rejectSymlink(file) {
+  try { if ((await lstat(file)).isSymbolicLink()) throw new Error(`Looma's generated path cannot be a symlink: ${file}.`); }
+  catch (error) { if (error.code !== 'ENOENT') throw error; }
+}
+
+/** Generated sources and tooling wrappers stay in owned cache directories. */
+export async function cacheDirectory(root, name = '') {
+  root = await realpath(path.resolve(root));
+  if (name && !/^[a-z][a-z-]*$/.test(name)) throw new Error('Invalid Looma cache directory.');
+  const cache = path.join(root, '.looma');
+  await rejectSymlink(cache); await mkdir(cache, { recursive: true });
+  const directory = path.join(cache, name);
+  await rejectSymlink(directory); await mkdir(directory, { recursive: true });
+  return directory;
+}
+
+/** One complete preparation/build owns the generated tree, including across CLI processes. */
+export async function withBuildLock(root, action) {
+  const lockFile = path.join(await cacheDirectory(root), 'docs-build.lock');
+  await rejectSymlink(lockFile);
+  let lock;
+  try { lock = await open(lockFile, 'wx', 0o600); }
+  catch (error) {
+    if (error.code === 'EEXIST') throw new Error('Another documentation build holds .looma/docs-build.lock. Retry after it finishes. If the old process stopped, close it before removing that lock.');
+    throw error;
+  }
+  try { await lock.writeFile(JSON.stringify({ pid: process.pid })); return await action(); }
+  finally { try { await lock.close(); } finally { await unlink(lockFile); } }
+}

package/package.json

@@ -1,6 +1,56 @@
 {
+  "version": "0.52.1",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/threadlabs-studio/looma.git",
+    "directory": "packages/looma-docs"
+  },
+  "bugs": {
+    "url": "https://github.com/threadlabs-studio/looma/issues"
+  },
+  "homepage": "https://github.com/threadlabs-studio/looma#readme",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=22.22.2 <23 || >=24.15 <25"
+  },
   "name": "@threadlabs/looma-docs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Local design-system documentation and theme customization for Looma.",
+  "type": "module",
+  "bin": {
+    "looma-docs": "./bin/looma-docs.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./docs/index.d.ts",
+      "import": "./docs/index.mjs"
+    }
+  },
+  "files": [
+    "bin/",
+    "docs/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@threadlabs/looma": ">=0.52.0",
+    "@nextwebwg/html-next": ">=1.0.0-alpha.84",
+    "@threadlabs/markupkit": ">=0.6.1",
+    "markupress": ">=0.18.4",
+    "vite": ">=8.3.0",
+    "@tiptap/core": "^2.11.5",
+    "@tiptap/pm": "^2.11.5",
+    "expressmark": ">=0.6.0",
+    "parse5": "^8.0.1"
+  },
+  "devDependencies": {
+    "jsdom": "^27.0.0"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "test": "node --test tooling/docs/*.test.mjs"
+  }
 }