@sourcescape/ds-cli 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -0,0 +1,127 @@
+/**
+ * One-shot rendering convenience.
+ *
+ * Collapses the full pipeline (buildRegistry → resolveMarkup → bundleJs → buildPreviewHtml)
+ * into a single async call.
+ */
+interface RenderResult {
+    html: string;
+    unmatchedTags: string[];
+}
+/**
+ * Render design-system markup to a complete HTML document.
+ *
+ * @param system - Design system name (e.g. "fw-prd")
+ * @param markup - Raw HTML/XML markup containing custom elements
+ * @returns Rendered HTML and any unmatched custom element tags
+ */
+declare function renderMarkup(system: string, markup: string): Promise<RenderResult>;
+
+/**
+ * Dependency resolution for raw markup rendering.
+ *
+ * Scans component directories to build a tag→component registry,
+ * then resolves which CSS/JS files a given markup document needs.
+ */
+interface ComponentEntry {
+    name: string;
+    kind: "molecules" | "cells";
+    dir: string;
+    tags: string[];
+    dynamicTags: string[];
+    hasCss: boolean;
+    hasJs: boolean;
+}
+interface ComponentRegistry {
+    tagMap: Map<string, ComponentEntry>;
+    entries: ComponentEntry[];
+}
+interface ResolvedDeps {
+    cssFiles: string[];
+    jsFiles: string[];
+    unmatchedTags: string[];
+}
+/** Scan all component directories and build a tag-to-component map. */
+declare function buildRegistry(system: string): ComponentRegistry;
+/** Resolve which components are needed for the given markup. */
+declare function resolveMarkup(registry: ComponentRegistry, markup: string): ResolvedDeps;
+/** Bundle the system's JS entry point in memory using esbuild. */
+declare function bundleJs(system: string): Promise<string | null>;
+/** Assemble a complete HTML document with inlined CSS and module script tags. */
+declare function buildPreviewHtml(system: string, markup: string, deps: ResolvedDeps, bundledJs?: string): string;
+
+/**
+ * Token loading and CSS generation.
+ *
+ * Reads W3C Design Token format JSON files and generates CSS custom properties.
+ */
+interface TokenLeaf {
+    path: string[];
+    type: string;
+    value: unknown;
+}
+/** Load all token JSON files for a design system. */
+declare function loadTokens(system: string): {
+    name: string;
+    data: Record<string, unknown>;
+}[];
+/** Recursively walk a W3C token tree, returning flat leaf tokens. */
+declare function walkTokens(obj: Record<string, unknown>, path?: string[]): TokenLeaf[];
+/** Convert a path array to a CSS custom property name. */
+declare function toCssVarName(path: string[]): string;
+/** Format a token value for CSS output. Returns null for composite types that should be skipped. */
+declare function formatValue(type: string, value: unknown): string | null;
+/** Generate complete _tokens.css content from a system's token files. */
+declare function generateTokensCss(system: string): string;
+
+/**
+ * Filesystem operations for reading design system data.
+ */
+interface SystemInfo {
+    name: string;
+    description: string;
+}
+interface ComponentInfo {
+    name: string;
+    kind: "molecules" | "cells";
+    description: string;
+    tag?: string;
+    example?: string;
+}
+/** List all design system names */
+declare function listSystems(): string[];
+/** Get the root directory for a specific system */
+declare function systemDir(system: string): string;
+/** Check if a system exists */
+declare function systemExists(system: string): boolean;
+/** List components for a system, grouped by kind */
+declare function listComponents(system: string): ComponentInfo[];
+/** Find a component by name, searching both molecules and cells */
+declare function findComponent(system: string, name: string): {
+    kind: "molecules" | "cells";
+    dir: string;
+} | null;
+
+/**
+ * Static file preview server via node:http.
+ *
+ * Serves the entire system directory so that relative font paths
+ * (e.g. assets/fonts/...) resolve correctly.
+ */
+interface PreviewServer {
+    url: string;
+    stop: () => void;
+}
+interface PreviewServerOpts {
+    /** Pre-rendered HTML string to serve at GET / */
+    html?: string;
+}
+/**
+ * Start a preview server rooted at `systemDir`.
+ *
+ * When `opts.html` is provided, GET / returns that HTML string directly;
+ * all other paths serve static files from systemDir (fonts, images, etc.).
+ */
+declare function startPreviewServer(systemDir: string, opts: PreviewServerOpts): Promise<PreviewServer>;
+
+export { type ComponentEntry, type ComponentInfo, type ComponentRegistry, type PreviewServer, type PreviewServerOpts, type RenderResult, type ResolvedDeps, type SystemInfo, buildPreviewHtml, buildRegistry, bundleJs, findComponent, formatValue, generateTokensCss, listComponents, listSystems, loadTokens, renderMarkup, resolveMarkup, startPreviewServer, systemDir, systemExists, toCssVarName, walkTokens };

package/dist/index.js

@@ -0,0 +1,47 @@
+import {
+  buildPreviewHtml,
+  buildRegistry,
+  bundleJs,
+  findComponent,
+  formatValue,
+  generateTokensCss,
+  listComponents,
+  listSystems,
+  loadTokens,
+  resolveMarkup,
+  startPreviewServer,
+  systemDir,
+  systemExists,
+  toCssVarName,
+  walkTokens
+} from "./chunk-U44UTENA.js";
+
+// src/render.ts
+async function renderMarkup(system, markup) {
+  const registry = buildRegistry(system);
+  const deps = resolveMarkup(registry, markup);
+  const js = await bundleJs(system);
+  const html = buildPreviewHtml(system, markup, deps, js ?? void 0);
+  return {
+    html,
+    unmatchedTags: deps.unmatchedTags
+  };
+}
+export {
+  buildPreviewHtml,
+  buildRegistry,
+  bundleJs,
+  findComponent,
+  formatValue,
+  generateTokensCss,
+  listComponents,
+  listSystems,
+  loadTokens,
+  renderMarkup,
+  resolveMarkup,
+  startPreviewServer,
+  systemDir,
+  systemExists,
+  toCssVarName,
+  walkTokens
+};

package/package.json

@@ -1,20 +1,29 @@
 {
   "name": "@sourcescape/ds-cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "CLI for browsing design system definitions",
   "license": "MIT",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
   "bin": {
     "design-system": "./dist/cli.js"
   },
   "files": ["dist"],
   "scripts": {
-    "build": "tsup src/cli.ts --format esm --dts --clean",
+    "build": "tsup src/cli.ts src/index.ts --format esm --dts --clean",
     "prepublishOnly": "npm run build"
   },
   "engines": {
     "node": ">=18"
   },
+  "dependencies": {
+    "esbuild": "^0.25.0"
+  },
   "devDependencies": {
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"