@polyxd/ds-kit 0.2.1 → 0.3.0

package/dist/dev.js

@@ -0,0 +1,373 @@
+/**
+ * `polyxd dev`: a local preview for people who author Polyxd documents in their editor.
+ *
+ *   npx polyxd dev                         the documents in this folder
+ *   npx polyxd dev ./screens --port 4310 --theme material3 --data ./sample.json --open
+ *   npx polyxd dev ./screens --pack ./ds-acme/manifest.json --verify
+ *
+ * It watches a folder for documents, renders the selected one with the real renderer in any
+ * built-in pack (or one of yours), light or dark, at phone, tablet and desktop widths, and shows
+ * beside it what the static check finds, the document, its data, and the actions it dispatches.
+ * Save a file and the surface reloads in place, keeping your selection and controls.
+ *
+ * Nothing but Node here: http, fs.watch, server-sent events, and the renderer's browser bundle
+ * from @polyxd/react/preview.
+ */
+import { spawn } from "node:child_process";
+import { existsSync, watch } from "node:fs";
+import { mkdtemp, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { createServer } from "node:http";
+import { tmpdir } from "node:os";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
+import { parseArgs } from "node:util";
+import { fileURLToPath } from "node:url";
+import { validateDocument } from "@polyxd/spec";
+import { packCss } from "./dev-pack.js";
+import { devPage } from "./dev-page.js";
+const SKIP_DIRS = new Set(["node_modules", "dist", "build", "coverage"]);
+const THEMES = ["material3", "carbon", "antd", "fluent", "shadcn", "bootstrap", "mantine", "radix", "polaris", "primer", "spectrum", "govuk", "chakra"];
+const isDocument = (v) => !!v && typeof v === "object" && typeof v.specVersion === "string" && Array.isArray(v.components);
+const posix = (p) => p.split(sep).join("/");
+/** The static check: schema and structure, and every binding against the data the surface will show. */
+export function checkDocument(document, data) {
+    const doc = data !== undefined ? { ...document, data } : document;
+    let issues;
+    try {
+        issues = validateDocument(doc, { missingData: "warning" }).issues;
+    }
+    catch (e) {
+        issues = [{ severity: "error", at: "/", message: `validator failed: ${e.message}` }];
+    }
+    return { errors: issues.filter((i) => i.severity === "error").length, warnings: issues.filter((i) => i.severity === "warning").length, issues };
+}
+async function* jsonFiles(dir, depth = 0) {
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+    for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+        if (e.name.startsWith("."))
+            continue;
+        if (e.isDirectory()) {
+            if (!SKIP_DIRS.has(e.name) && depth < 4)
+                yield* jsonFiles(join(dir, e.name), depth + 1);
+        }
+        else if (e.name.endsWith(".json"))
+            yield join(dir, e.name);
+    }
+}
+/**
+ * Every document under `dir`: a JSON file with `specVersion` and `components`, or an intent-shaped
+ * file whose `document` has them. Data is the document's own, else `<name>.data.json` beside it,
+ * else `defaultData`. Everything else (packs, reports, registries, tsconfigs) is ignored.
+ */
+export async function discoverDocuments(dir, options = {}) {
+    const documents = [];
+    const broken = [];
+    for await (const path of jsonFiles(dir)) {
+        if (path.endsWith(".data.json"))
+            continue;
+        const file = posix(relative(dir, path));
+        let raw;
+        try {
+            raw = JSON.parse(await readFile(path, "utf8"));
+        }
+        catch (e) {
+            broken.push({ file, message: e.message });
+            continue;
+        }
+        const kind = isDocument(raw) ? "document" : isDocument(raw?.document) ? "intent" : undefined;
+        if (!kind)
+            continue;
+        const document = kind === "intent" ? raw.document : raw;
+        let data = document.data;
+        let dataFrom = data !== undefined ? "embedded" : "none";
+        if (data === undefined) {
+            const sibling = path.replace(/\.json$/, ".data.json");
+            if (existsSync(sibling)) {
+                try {
+                    data = JSON.parse(await readFile(sibling, "utf8"));
+                    dataFrom = "sibling";
+                }
+                catch (e) {
+                    broken.push({ file: posix(relative(dir, sibling)), message: e.message });
+                }
+            }
+        }
+        if (data === undefined && options.defaultData !== undefined) {
+            data = options.defaultData;
+            dataFrom = "default";
+        }
+        const surface = document.surface ?? {};
+        documents.push({
+            file,
+            id: String(surface.id ?? (kind === "intent" ? raw.id : "") ?? ""),
+            title: String(surface.title ?? raw.title ?? basename(file, ".json")),
+            kind,
+            origin: surface.origin,
+            pattern: surface.pattern,
+            dataFrom,
+            document,
+            data,
+            check: checkDocument(document, data),
+        });
+    }
+    return { documents, broken };
+}
+/** One line per document, the way the pack command reports. */
+export function describe(d) {
+    const status = d.check.errors ? "error" : d.check.warnings ? "warn " : "ok   ";
+    const counts = [d.check.errors ? `${d.check.errors} error${d.check.errors === 1 ? "" : "s"}` : "", d.check.warnings ? `${d.check.warnings} warning${d.check.warnings === 1 ? "" : "s"}` : ""].filter(Boolean).join(", ");
+    const what = [d.kind === "intent" ? "intent" : "document", d.origin, d.dataFrom === "none" ? "no data" : d.dataFrom === "embedded" ? "" : `data: ${d.dataFrom}`].filter(Boolean).join(" · ");
+    return `  ${status}  ${d.file.padEnd(32)} ${d.title.slice(0, 28).padEnd(28)} ${what}${counts ? `  (${counts})` : ""}`;
+}
+/** Where the renderer's browser bundle lives, if @polyxd/react is installed with one. */
+export function findBundle() {
+    try {
+        const js = fileURLToPath(import.meta.resolve("@polyxd/react/preview/polyxd.js"));
+        return existsSync(js) && existsSync(js.replace(/\.js$/, ".css")) ? dirname(js) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The verifier's command line, if @polyxd/verifier is installed. */
+export function findVerifier() {
+    try {
+        const cli = fileURLToPath(import.meta.resolve("@polyxd/verifier/dist/cli.js"));
+        return existsSync(cli) ? cli : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+const meta = (d) => ({ file: d.file, id: d.id, title: d.title, kind: d.kind, origin: d.origin, pattern: d.pattern, dataFrom: d.dataFrom, check: { errors: d.check.errors, warnings: d.check.warnings } });
+const json = (res, status, body) => {
+    res.writeHead(status, { "content-type": "application/json; charset=utf-8", "cache-control": "no-store" });
+    res.end(JSON.stringify(body));
+};
+const text = (res, status, body, type = "text/plain") => {
+    res.writeHead(status, { "content-type": `${type}; charset=utf-8`, "cache-control": "no-store" });
+    res.end(body);
+};
+const sse = (res) => {
+    res.writeHead(200, { "content-type": "text/event-stream", "cache-control": "no-store", connection: "keep-alive" });
+    res.write(": polyxd dev\n\n");
+    return (event, data) => res.write(`event: ${event}\ndata: ${JSON.stringify(data)}\n\n`);
+};
+export async function createDevServer(options) {
+    const dir = resolve(options.dir);
+    const info = await stat(dir).catch(() => null);
+    if (!info?.isDirectory())
+        throw new Error(`${options.dir} is not a folder`);
+    const dataFile = options.data ? resolve(options.data) : undefined;
+    const readDefaultData = async () => (dataFile ? JSON.parse(await readFile(dataFile, "utf8")) : undefined);
+    const pack = options.pack ? await packCss(resolve(options.pack)) : undefined;
+    const bundle = options.bundle ?? findBundle();
+    const theme = options.theme ?? (pack?.name ?? "material3");
+    let defaultData = await readDefaultData();
+    let found = await discoverDocuments(dir, { defaultData });
+    const clients = new Set();
+    const broadcast = (event, data) => {
+        for (const send of clients)
+            send(event, data);
+    };
+    const listing = () => ({ dir, theme, pack: pack?.name, verify: !!options.verify, bundle: !!bundle, documents: found.documents.map(meta), broken: found.broken });
+    const rescan = async () => {
+        try {
+            defaultData = await readDefaultData();
+        }
+        catch {
+            // A half-saved default data file: keep the last good one until the next save.
+        }
+        const before = new Map(found.documents.map((d) => [d.file, JSON.stringify({ d: d.document, x: d.data })]));
+        found = await discoverDocuments(dir, { defaultData });
+        const changed = found.documents.filter((d) => before.get(d.file) !== JSON.stringify({ d: d.document, x: d.data })).map((d) => d.file);
+        const removed = [...before.keys()].filter((f) => !found.documents.some((d) => d.file === f));
+        broadcast("change", { changed, removed, ...listing() });
+    };
+    let timer;
+    const schedule = () => {
+        clearTimeout(timer);
+        timer = setTimeout(() => void rescan(), 80);
+    };
+    const watchers = [];
+    try {
+        watchers.push(watch(dir, { recursive: true }, schedule));
+    }
+    catch {
+        watchers.push(watch(dir, schedule));
+    }
+    if (dataFile && !dataFile.startsWith(dir + sep))
+        watchers.push(watch(dataFile, schedule));
+    let verifying = false;
+    const verify = async (doc, send, done) => {
+        const cli = findVerifier();
+        if (!cli) {
+            send("line", { text: "The verifier isn't installed here. It renders in a real browser, so it's a separate package:" });
+            send("line", { text: "  npm install -D @polyxd/verifier && npx playwright install chromium" });
+            send("done", { code: 2 });
+            return done();
+        }
+        if (verifying) {
+            send("line", { text: "A verification is already running; wait for it to finish." });
+            send("done", { code: 3 });
+            return done();
+        }
+        verifying = true;
+        const tmp = await mkdtemp(join(tmpdir(), "polyxd-dev-verify-"));
+        const file = join(tmp, `${basename(doc.file, ".json")}.json`);
+        await writeFile(file, JSON.stringify(doc.data !== undefined ? { ...doc.document, data: doc.data } : doc.document));
+        send("line", { text: `polyxd-verify ${basename(file)} --themes ${THEMES.join(",")} --modes light,dark --widths 390,1100` });
+        const child = spawn(process.execPath, [cli, file, "--themes", THEMES.join(","), "--modes", "light,dark", "--widths", "390,1100"], { stdio: ["ignore", "pipe", "pipe"] });
+        let rest = "";
+        const lines = (chunk, stream) => {
+            rest += chunk.toString();
+            const parts = rest.split("\n");
+            rest = parts.pop() ?? "";
+            for (const line of parts)
+                send("line", { text: line, stream });
+        };
+        child.stdout.on("data", (c) => lines(c, "out"));
+        child.stderr.on("data", (c) => lines(c, "err"));
+        child.on("close", async (code) => {
+            if (rest)
+                send("line", { text: rest });
+            send("done", { code: code ?? 1 });
+            verifying = false;
+            await rm(tmp, { recursive: true, force: true });
+            done();
+        });
+    };
+    const handle = async (req, res) => {
+        const url = new URL(req.url ?? "/", "http://localhost");
+        const path = decodeURIComponent(url.pathname);
+        if (path === "/")
+            return text(res, 200, devPage({ dir, theme, pack: pack?.name, verify: !!options.verify, bundle: !!bundle, themes: THEMES }), "text/html");
+        if (path === "/preview/polyxd.js" || path === "/preview/polyxd.css") {
+            if (!bundle)
+                return text(res, 404, "The renderer bundle isn't installed: npm install @polyxd/react");
+            const body = await readFile(join(bundle, basename(path))).catch(() => null);
+            if (!body)
+                return text(res, 404, "not found");
+            res.writeHead(200, { "content-type": path.endsWith(".js") ? "text/javascript; charset=utf-8" : "text/css; charset=utf-8", "cache-control": "no-store" });
+            return res.end(body);
+        }
+        if (path === "/pack.css")
+            return pack ? text(res, 200, pack.css, "text/css") : text(res, 404, "no --pack");
+        if (path === "/api/documents")
+            return json(res, 200, listing());
+        if (path === "/api/events") {
+            const send = sse(res);
+            clients.add(send);
+            send("hello", listing());
+            req.on("close", () => clients.delete(send));
+            return;
+        }
+        const doc = (prefix) => (path.startsWith(prefix) ? found.documents.find((d) => d.file === path.slice(prefix.length)) : undefined);
+        if (path.startsWith("/api/documents/")) {
+            const d = doc("/api/documents/");
+            return d ? json(res, 200, { ...meta(d), document: d.document, data: d.data, issues: d.check.issues }) : json(res, 404, { error: "no such document" });
+        }
+        if (path.startsWith("/api/verify/")) {
+            const d = doc("/api/verify/");
+            if (!d)
+                return json(res, 404, { error: "no such document" });
+            const send = sse(res);
+            return verify(d, send, () => res.end());
+        }
+        text(res, 404, "not found");
+    };
+    const server = createServer((req, res) => {
+        handle(req, res).catch((e) => {
+            if (!res.headersSent)
+                json(res, 500, { error: e.message });
+            else
+                res.end();
+        });
+    });
+    const port = await new Promise((ok, fail) => {
+        server.once("error", fail);
+        server.listen(options.port ?? 4310, "127.0.0.1", () => ok(server.address().port));
+    });
+    return {
+        url: `http://localhost:${port}/`,
+        port,
+        documents: () => found.documents,
+        broken: () => found.broken,
+        pack,
+        rescan,
+        close: async () => {
+            clearTimeout(timer);
+            for (const w of watchers)
+                w.close();
+            for (const send of clients)
+                send("bye", {});
+            // Event streams never end on their own; close them so the server can.
+            const closed = new Promise((ok) => server.close(() => ok()));
+            server.closeAllConnections();
+            await closed;
+        },
+    };
+}
+const USAGE = `polyxd dev [dir] [--port 4310] [--theme material3] [--data <file.json>] [--pack <manifest.json|theme.css>] [--verify] [--open]
+
+  Previews the Polyxd documents in a folder (default: this one) in the browser, rendered with the
+  real renderer in any built-in design system, light or dark, at phone, tablet and desktop widths,
+  with the static check, the document, its data and the actions it dispatches beside it. Save a
+  file and the surface reloads in place.`;
+export async function main(argv) {
+    let values;
+    let positionals;
+    try {
+        ({ values, positionals } = parseArgs({
+            args: argv,
+            allowPositionals: true,
+            options: { port: { type: "string" }, theme: { type: "string" }, data: { type: "string" }, pack: { type: "string" }, verify: { type: "boolean" }, open: { type: "boolean" }, help: { type: "boolean", short: "h" } },
+        }));
+    }
+    catch (e) {
+        console.error(e.message);
+        console.log(USAGE);
+        return 2;
+    }
+    if (values.help) {
+        console.log(USAGE);
+        return 0;
+    }
+    const port = values.port === undefined ? 4310 : Number(values.port);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        console.error(`--port should be a number, not ${values.port}`);
+        return 2;
+    }
+    if (values.theme && !THEMES.includes(String(values.theme)) && !values.pack) {
+        console.error(`--theme should be one of ${THEMES.join(", ")}, or the pack given with --pack`);
+        return 2;
+    }
+    let server;
+    try {
+        server = await createDevServer({ dir: positionals[0] ?? ".", port, theme: values.theme, data: values.data, pack: values.pack, verify: !!values.verify });
+    }
+    catch (e) {
+        const err = e;
+        console.error(err.code === "EADDRINUSE" ? `Port ${port} is taken; pass --port with another.` : err.message);
+        return 1;
+    }
+    const docs = server.documents();
+    const absolute = resolve(positionals[0] ?? ".");
+    const rel = relative(process.cwd(), absolute);
+    const dir = rel === "" ? "." : rel.startsWith("..") ? absolute : rel;
+    console.log(`polyxd dev  ${server.url}`);
+    console.log(`${docs.length} document${docs.length === 1 ? "" : "s"} in ${dir}, watching for changes${server.pack ? ` · pack ${server.pack.name} from --pack` : ""}${values.verify ? findVerifier() ? " · verifier ready" : " · verifier not installed (npm install -D @polyxd/verifier)" : ""}`);
+    if (!findBundle())
+        console.log("The renderer bundle isn't installed, so the page can list and check documents but not render them: npm install @polyxd/react");
+    for (const d of docs)
+        console.log(describe(d));
+    for (const b of server.broken())
+        console.log(`  error  ${b.file.padEnd(32)} did not parse: ${b.message}`);
+    if (!docs.length)
+        console.log("  (no documents yet: a document is a JSON file with specVersion and components, or an intent file with a document inside)");
+    if (values.open) {
+        const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+        spawn(opener, [server.url], { stdio: "ignore", detached: true, shell: process.platform === "win32" }).on("error", () => undefined).unref();
+    }
+    return 0;
+}
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

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

package/dist/polyxd.js

@@ -2,11 +2,12 @@
 /**
  * The `polyxd` command.
  *
- *   polyxd pack ./tokens.css     make a design-system pack out of your own tokens
- *   polyxd check ./manifest.json check a pack against the semantic token contract
+ *   polyxd pack ./tokens.css       make a design-system pack out of your own tokens
+ *   polyxd check ./manifest.json   check a pack against the semantic token contract
+ *   polyxd studio push ./ --to …   send your tokens to Polyxd Studio (from CI, with an API key)
  *
- * Two commands, because those are the two things a team does before anything else works: point
- * Polyxd at their design system, and find out what it still needs.
+ * Three commands, because those are the things a team does before anything else works: point
+ * Polyxd at their design system, find out what it still needs, and keep Studio in step with it.
  */
 const [command, ...rest] = process.argv.slice(2);
 process.argv = [process.argv[0], process.argv[1], ...rest];
@@ -29,6 +30,18 @@ switch (command) {
         console.log(issues.length ? `\n${issues.length} issue(s)` : "Design system satisfies the semantic token contract.");
         process.exit(issues.length ? 1 : 0);
     }
+    case "studio": {
+        const { main } = await import("./studio.js");
+        process.exit(await main(rest));
+    }
+    case "dev": {
+        // Stays up once it has started: the server and the watcher keep the process alive.
+        const { main } = await import("./dev.js");
+        const code = await main(rest);
+        if (code || rest.includes("--help") || rest.includes("-h"))
+            process.exit(code);
+        break;
+    }
     default:
         console.log(`polyxd <command>
 
@@ -38,7 +51,16 @@ switch (command) {
 
   check <manifest.json>
       Checks a pack against the semantic token contract: every token present and correctly
-      typed, every contrast pair measured, every constraint met.`);
+      typed, every contrast pair measured, every constraint met.
+
+  studio push <package dir | tarball | token file> --to <studio>/api/w/<workspace>
+      Sends your tokens to Polyxd Studio as a new version of your design system, using an
+      API key from POLYXD_STUDIO_KEY. Made for a CI step on every release.
+
+  dev [dir] [--port 4310] [--theme material3] [--data <file.json>] [--pack <manifest.json|theme.css>] [--verify] [--open]
+      Previews the documents in a folder as you edit them: rendered with the real renderer in
+      any built-in pack or one of yours, light or dark, phone to desktop, with the static check,
+      the document, its data and the actions it dispatches beside it. Reloads on save.`);
         process.exit(command ? 1 : 0);
 }
 export {};

package/dist/polyxd.js.map

@@ -1 +1 @@
-{"version":3,"file":"polyxd.js","sourceRoot":"","sources":["../src/polyxd.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACjD,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AAE3D,QAAQ,OAAO,EAAE,CAAC;IAChB,KAAK,MAAM;QACT,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACzB,MAAM;IACR,KAAK,OAAO,EAAE,CAAC;QACb,sFAAsF;QACtF,6BAA6B;QAC7B,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/F,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC,CAAC,sDAAsD,CAAC,CAAC;QACpH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IACD;QACE,OAAO,CAAC,GAAG,CAAC;;;;;;;;iEAQiD,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"polyxd.js","sourceRoot":"","sources":["../src/polyxd.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACjD,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AAE3D,QAAQ,OAAO,EAAE,CAAC;IAChB,KAAK,MAAM;QACT,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACzB,MAAM;IACR,KAAK,OAAO,EAAE,CAAC;QACb,sFAAsF;QACtF,6BAA6B;QAC7B,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/F,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC,CAAC,sDAAsD,CAAC,CAAC;QACpH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,QAAQ,EAAE,CAAC;QACd,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,KAAK,KAAK,EAAE,CAAC;QACX,mFAAmF;QACnF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/E,MAAM;IACR,CAAC;IACD;QACE,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;uFAiBuE,CAAC,CAAC;QACrF,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/studio.d.ts

@@ -0,0 +1,45 @@
+export interface PushOptions {
+    /** Directory, tarball or token file. */
+    path: string;
+    /** The workspace's API base, e.g. https://studio.polyxd.com/api/w/acme */
+    to: string;
+    key: string;
+    /** Add a version to this design system instead of matching by package name. */
+    into?: string;
+    /** Name for a new design system (defaults to the package name or the file name). */
+    name?: string;
+    /** Override fetch, for tests. */
+    fetch?: typeof fetch;
+}
+export interface PushResult {
+    designSystemId: string;
+    versionId: string;
+    number: number;
+    /** Where to review the mapping in Studio. */
+    url: string;
+    scan: {
+        format: string;
+        total: number;
+        byTier: Record<string, number>;
+        modes: {
+            name: string;
+        }[];
+        issues: {
+            kind: string;
+            count: number;
+        }[];
+        picked?: string[];
+    };
+}
+/** What gets uploaded: the bytes, the file name, and the package identity when there is one. */
+export declare function prepare(path: string): Promise<{
+    bytes: Uint8Array;
+    fileName: string;
+    packageName?: string;
+    packageVersion?: string;
+    cleanup: () => Promise<void>;
+}>;
+export declare function push(opts: PushOptions): Promise<PushResult>;
+/** One line per fact, the way the pack command reports. */
+export declare function describe(r: PushResult, fileName: string): string;
+export declare function main(argv: string[]): Promise<number>;

package/dist/studio.js

@@ -0,0 +1,121 @@
+/**
+ * `polyxd studio push`: send a design system's tokens to Polyxd Studio from wherever the tokens
+ * live: a package directory (packed with npm, so private dependencies and registries never
+ * matter), a tarball, or one token file (DTCG or Tokens Studio JSON, or CSS custom properties).
+ *
+ *   POLYXD_STUDIO_KEY=… npx polyxd studio push ./ --to https://studio.polyxd.com/api/w/acme
+ *   npx polyxd studio push ./tokens.css --to … --name "Acme tokens"
+ *   npx polyxd studio push ./dist/tokens-2.4.0.tgz --to … --into <designSystemId>
+ *
+ * Studio scans the tokens (tiers, modes, aliases, issues) and answers with a link to review the
+ * mapping. A push with the same package name lands as a new version of the same design system,
+ * so a CI step can run it on every release.
+ */
+import { execFile } from "node:child_process";
+import { mkdtemp, readFile, rm, stat } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { basename, join, resolve } from "node:path";
+import { promisify } from "node:util";
+const exec = promisify(execFile);
+/** What gets uploaded: the bytes, the file name, and the package identity when there is one. */
+export async function prepare(path) {
+    const target = resolve(path);
+    const info = await stat(target).catch(() => null);
+    if (!info)
+        throw new Error(`${path} does not exist`);
+    if (info.isDirectory()) {
+        const pkgFile = join(target, "package.json");
+        const pkg = JSON.parse(await readFile(pkgFile, "utf8").catch(() => {
+            throw new Error(`${path} has no package.json; point at a token file instead`);
+        }));
+        // npm pack honours "files", .npmignore and prepack, so the tarball is what a release would be.
+        const dir = await mkdtemp(join(tmpdir(), "polyxd-push-"));
+        const { stdout } = await exec("npm", ["pack", "--json", "--pack-destination", dir, "--ignore-scripts"], { cwd: target, maxBuffer: 16 * 1024 * 1024 });
+        const [packed] = JSON.parse(stdout);
+        const bytes = new Uint8Array(await readFile(join(dir, packed.filename)));
+        return { bytes, fileName: packed.filename, packageName: packed.name ?? pkg.name, packageVersion: packed.version ?? pkg.version, cleanup: () => rm(dir, { recursive: true, force: true }) };
+    }
+    const bytes = new Uint8Array(await readFile(target));
+    return { bytes, fileName: basename(target), cleanup: async () => undefined };
+}
+export async function push(opts) {
+    const to = opts.to.replace(/\/+$/, "");
+    if (!/^https?:\/\/.+\/api\/w\/[a-z0-9-]+$/i.test(to))
+        throw new Error(`--to should look like https://studio.example.com/api/w/<workspace>, not ${opts.to}`);
+    if (!opts.key)
+        throw new Error("No key: set POLYXD_STUDIO_KEY or pass --key (Team → API keys in Studio)");
+    const prepared = await prepare(opts.path);
+    try {
+        const form = new FormData();
+        form.set("file", new Blob([prepared.bytes.slice().buffer]), prepared.fileName);
+        if (opts.name)
+            form.set("name", opts.name);
+        if (opts.into)
+            form.set("designSystemId", opts.into);
+        if (prepared.packageName)
+            form.set("packageName", prepared.packageName);
+        if (prepared.packageVersion)
+            form.set("packageVersion", prepared.packageVersion);
+        const res = await (opts.fetch ?? fetch)(`${to}/design-systems/import`, { method: "POST", headers: { authorization: `Bearer ${opts.key}` }, body: form });
+        const text = await res.text();
+        let data = {};
+        try {
+            data = text ? JSON.parse(text) : {};
+        }
+        catch {
+            /* an HTML error page from a proxy: the status line says enough */
+        }
+        if (!res.ok)
+            throw new Error(data.error ?? `Studio answered ${res.status} ${res.statusText}`);
+        const app = new URL(to);
+        const slug = to.split("/").pop();
+        return { ...data, url: data.url ?? `${app.origin}/w/${slug}/design-systems/${data.designSystemId}/versions/${data.versionId}/scan` };
+    }
+    finally {
+        await prepared.cleanup();
+    }
+}
+/** One line per fact, the way the pack command reports. */
+export function describe(r, fileName) {
+    const tiers = Object.entries(r.scan.byTier ?? {})
+        .filter(([, n]) => n)
+        .map(([t, n]) => `${n} ${t}`)
+        .join(", ");
+    const modes = (r.scan.modes ?? []).map((m) => m.name).join(", ");
+    const issues = (r.scan.issues ?? []).reduce((s, i) => s + i.count, 0);
+    return [
+        `Pushed ${fileName} as version ${r.number}.`,
+        `${r.scan.total} tokens (${r.scan.format}${tiers ? `; ${tiers}` : ""})${modes ? ` · modes: ${modes}` : ""}${issues ? ` · ${issues} thing${issues === 1 ? "" : "s"} to look at` : ""}`,
+        `Review the mapping: ${r.url}`,
+    ].join("\n");
+}
+export async function main(argv) {
+    const [sub, ...rest] = argv;
+    if (sub !== "push") {
+        console.log(`polyxd studio push <package dir | tarball | token file> --to <studio>/api/w/<workspace> [--into <designSystemId>] [--name <name>] [--key <key>]
+
+  Sends your tokens to Polyxd Studio. A directory is packed with npm (so it's what a release would
+  be); the key comes from POLYXD_STUDIO_KEY or --key (Team → API keys). The same package name lands
+  as a new version of the same design system each time.`);
+        return sub ? 1 : 0;
+    }
+    const flag = (name) => {
+        const i = rest.indexOf(`--${name}`);
+        return i > -1 ? rest[i + 1] : undefined;
+    };
+    const path = rest.find((a, i) => !a.startsWith("--") && (i === 0 || !rest[i - 1].startsWith("--")));
+    if (!path || !flag("to")) {
+        console.log("usage: polyxd studio push <path> --to <studio>/api/w/<workspace> [--into <id>] [--name <name>] [--key <key>]");
+        return 2;
+    }
+    try {
+        const r = await push({ path, to: flag("to"), key: flag("key") ?? process.env.POLYXD_STUDIO_KEY ?? "", into: flag("into"), name: flag("name") });
+        console.log(describe(r, basename(path)));
+        return 0;
+    }
+    catch (e) {
+        console.error(e.message);
+        return 1;
+    }
+}
+//# sourceMappingURL=studio.js.map