@twentyfirstmedia/ui 0.0.0-stage → 0.1.1

package/dist/list.d.ts

@@ -0,0 +1,3 @@
+import { type Logger } from "./util.js";
+export declare function list(cwd: string, log: Logger): Map<string, string[]>;
+//# sourceMappingURL=list.d.ts.map

package/dist/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../src/list.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAAc,MAAM,WAAW,CAAC;AAEpD,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAgBpE"}

package/dist/list.js

@@ -0,0 +1,21 @@
+import { existsSync } from "node:fs";
+import { loadCore } from "./source.js";
+import { targetPath } from "./add.js";
+import { readConfig } from "./util.js";
+export function list(cwd, log) {
+    const core = loadCore(cwd);
+    const dir = readConfig(cwd)?.components ?? "components/ui";
+    const groups = new Map();
+    for (const [name, file] of core.components)
+        groups.set(file, [...(groups.get(file) ?? []), name]);
+    for (const [file, names] of groups) {
+        log.log(`${file}`);
+        log.log("  " +
+            names
+                .sort()
+                .map((n) => (existsSync(targetPath(cwd, dir, n)) ? `${n} (added)` : n))
+                .join(", "));
+    }
+    return groups;
+}
+//# sourceMappingURL=list.js.map

package/dist/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../src/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAe,UAAU,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,UAAU,IAAI,CAAC,GAAW,EAAE,GAAW;IAC3C,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,UAAU,IAAI,eAAe,CAAC;IAC3D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU;QAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAClG,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QACnB,GAAG,CAAC,GAAG,CACL,IAAI;YACF,KAAK;iBACF,IAAI,EAAE;iBACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBACtE,IAAI,CAAC,IAAI,CAAC,CAChB,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/mcp-init.d.ts

@@ -0,0 +1,21 @@
+import { type KitName } from "./knowledge.js";
+import { type Logger } from "./util.js";
+export type Client = "claude" | "cursor" | "vscode";
+export declare const CLIENTS: Client[];
+export declare const serverArgs: (kit: KitName) => string[];
+export declare const RULES_START = "<!-- twentyfirst-ui:start -->";
+export declare const RULES_END = "<!-- twentyfirst-ui:end -->";
+export declare function rulesBlock(kit: KitName): string;
+/** Reads `--client claude,cursor` (or `all`); no value means all clients. */
+export declare function parseClients(value: string | boolean | undefined): Client[];
+/** Puts the rules block into the file: replaces an existing block, else appends one. */
+export declare function withRules(content: string | null, kit: KitName): string;
+export interface McpInitOptions {
+    cwd: string;
+    kit: KitName;
+    clients: Client[];
+    rules: boolean;
+    log: Logger;
+}
+export declare function mcpInit({ cwd, kit, clients, rules, log }: McpInitOptions): void;
+//# sourceMappingURL=mcp-init.d.ts.map

package/dist/mcp-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-init.d.ts","sourceRoot":"","sources":["../src/mcp-init.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,KAAK,MAAM,EAAe,MAAM,WAAW,CAAC;AAErD,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACpD,eAAO,MAAM,OAAO,EAAE,MAAM,EAAmC,CAAC;AAUhE,eAAO,MAAM,UAAU,GAAI,KAAK,OAAO,aAAwD,CAAC;AAuBhG,eAAO,MAAM,WAAW,kCAAkC,CAAC;AAC3D,eAAO,MAAM,SAAS,gCAAgC,CAAC;AAEvD,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE/C;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,EAAE,CAc1E;AA0CD,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAQtE;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,cAAc,GAAG,IAAI,CAc/E"}

package/dist/mcp-init.js

@@ -0,0 +1,114 @@
+/**
+ * `twentyfirst-ui mcp init`: registers the MCP server with the coding agents of a project and
+ * writes the kit rules into AGENTS.md (and CLAUDE.md when it exists).
+ */
+import { join } from "node:path";
+import { agentRules } from "./knowledge.js";
+import { SERVER_NAME } from "./mcp.js";
+import { read, write } from "./util.js";
+export const CLIENTS = ["claude", "cursor", "vscode"];
+export const serverArgs = (kit) => ["-y", "@twentyfirstmedia/ui", "mcp", "--kit", kit];
+const CONFIGS = {
+    claude: {
+        label: "Claude Code",
+        file: ".mcp.json",
+        key: "mcpServers",
+        entry: (kit) => ({ command: "npx", args: serverArgs(kit) }),
+    },
+    cursor: {
+        label: "Cursor",
+        file: ".cursor/mcp.json",
+        key: "mcpServers",
+        entry: (kit) => ({ command: "npx", args: serverArgs(kit) }),
+    },
+    vscode: {
+        label: "VS Code",
+        file: ".vscode/mcp.json",
+        key: "servers",
+        entry: (kit) => ({ type: "stdio", command: "npx", args: serverArgs(kit) }),
+    },
+};
+export const RULES_START = "<!-- twentyfirst-ui:start -->";
+export const RULES_END = "<!-- twentyfirst-ui:end -->";
+export function rulesBlock(kit) {
+    return `${RULES_START}\n## Twentyfirst UI\n\n${agentRules(kit)}\n${RULES_END}`;
+}
+/** Reads `--client claude,cursor` (or `all`); no value means all clients. */
+export function parseClients(value) {
+    if (value === undefined || value === true || value === "all")
+        return [...CLIENTS];
+    if (value === false)
+        return [];
+    const list = value
+        .split(",")
+        .map((s) => s.trim().toLowerCase())
+        .filter(Boolean);
+    if (list.includes("all"))
+        return [...CLIENTS];
+    const bad = list.filter((c) => !CLIENTS.includes(c));
+    if (bad.length || !list.length)
+        throw new Error(`--client takes ${CLIENTS.join(", ")} or all (comma-separated), not ${bad.join(", ") || "nothing"}`);
+    return [...new Set(list)];
+}
+function writeIfChanged(path, content, name, log) {
+    const before = read(path);
+    if (before === content) {
+        log.log(`  unchanged  ${name}`);
+        return;
+    }
+    write(path, content);
+    log.log(`  ${before === null ? "created" : "updated"}    ${name}`);
+}
+function writeClientConfig(cwd, client, kit, log) {
+    const cfg = CONFIGS[client];
+    const path = join(cwd, cfg.file);
+    const raw = read(path);
+    let data = {};
+    if (raw !== null && raw.trim()) {
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (e) {
+            throw new Error(`${cfg.file} is not valid JSON (${e.message}); fix it and rerun.`, {
+                cause: e,
+            });
+        }
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+            throw new Error(`${cfg.file} must hold a JSON object.`);
+        data = parsed;
+    }
+    const existing = data[cfg.key];
+    const servers = typeof existing === "object" && existing !== null && !Array.isArray(existing)
+        ? existing
+        : {};
+    data[cfg.key] = { ...servers, [SERVER_NAME]: cfg.entry(kit) };
+    writeIfChanged(path, `${JSON.stringify(data, null, 2)}\n`, `${cfg.file} (${cfg.label})`, log);
+}
+/** Puts the rules block into the file: replaces an existing block, else appends one. */
+export function withRules(content, kit) {
+    const block = rulesBlock(kit);
+    if (content === null || !content.trim())
+        return `${block}\n`;
+    const start = content.indexOf(RULES_START);
+    const end = content.indexOf(RULES_END, start);
+    if (start >= 0 && end > start)
+        return content.slice(0, start) + block + content.slice(end + RULES_END.length);
+    return `${content.replace(/\s*$/, "")}\n\n${block}\n`;
+}
+export function mcpInit({ cwd, kit, clients, rules, log }) {
+    log.log(`Setting up the ${SERVER_NAME} MCP server (${kit} kit):`);
+    for (const c of clients)
+        writeClientConfig(cwd, c, kit, log);
+    if (rules) {
+        for (const file of ["AGENTS.md", "CLAUDE.md"]) {
+            const path = join(cwd, file);
+            const content = read(path);
+            if (file === "CLAUDE.md" && content === null)
+                continue;
+            writeIfChanged(path, withRules(content, kit), `${file} (rules)`, log);
+        }
+    }
+    log.log(`Done. Restart your agent or reload its MCP servers; the server runs \`npx ${serverArgs(kit).join(" ")}\`.`);
+}
+//# sourceMappingURL=mcp-init.js.map

package/dist/mcp-init.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,72 @@
+import { type Entry, type KitName, type Knowledge } from "./knowledge.js";
+export declare const SERVER_NAME = "twentyfirst-ui";
+export declare const PROTOCOL_VERSIONS: readonly ["2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05"];
+export declare const LATEST_PROTOCOL_VERSION: "2025-11-25";
+export type JsonRpcId = string | number | null;
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id?: JsonRpcId;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export type JsonRpcResponse = {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    result: unknown;
+} | {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    error: JsonRpcError;
+};
+export declare const ErrorCode: {
+    readonly ParseError: -32700;
+    readonly InvalidRequest: -32600;
+    readonly MethodNotFound: -32601;
+    readonly InvalidParams: -32602;
+    readonly InternalError: -32603;
+    readonly ResourceNotFound: -32002;
+};
+interface TextContent {
+    type: "text";
+    text: string;
+}
+export interface ToolResult {
+    content: TextContent[];
+    isError?: boolean;
+}
+export interface ServerOptions {
+    /** Kit the answers use unless a tool call names another. */
+    kit: KitName;
+}
+export interface McpServer {
+    /** Answers one JSON-RPC message; notifications and responses get null. */
+    handle(message: unknown): Promise<JsonRpcResponse | null>;
+}
+/** `import { A, B } from "@twentyfirstmedia/<kit>";` for the components a page documents. */
+export declare function importLine(k: Knowledge, e: Entry, kit: KitName): string;
+/**
+ * Docs of a component by name. A page of its own wins; a component without one (Button, Badge…)
+ * gets its import, props and the example of the page that shows it best; else any page that
+ * documents it (findEntry).
+ */
+export declare function componentDoc(k: Knowledge, name: string, kit: KitName): string | undefined;
+export declare function createServer(k: Knowledge, options: ServerOptions): McpServer;
+/** Loads the docs bundled with the CLI (dist/knowledge.json). */
+export declare function loadKnowledge(url?: URL): Knowledge;
+/**
+ * Serves newline-delimited JSON-RPC over stdin/stdout. Messages are answered in order; the
+ * promise resolves when the input ends and every answer is written, or when the client closes the
+ * output (EPIPE): then there is nobody left to answer, so the server stops quietly.
+ */
+export declare function serveStdio(server: McpServer, io?: {
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+    onError?: (msg: string) => void;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AASA,OAAO,EAqBL,KAAK,KAAK,EACV,KAAK,OAAO,EACZ,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,WAAW,mBAAmB,CAAC;AAC5C,eAAO,MAAM,iBAAiB,mEAAoE,CAAC;AACnG,eAAO,MAAM,uBAAuB,cAAuB,CAAC;AAM5D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAClD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AAE3D,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAC;AAcX,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAwBD,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,0EAA0E;IAC1E,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;CAC3D;AAsCD,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAIvE;AA4DD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAsDzF;AAcD,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,CA8jB5E;AAYD,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,GAAG,GAAE,GAAkD,GAAG,SAAS,CAUhG;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,EACjB,EAAE,GAAE;IACF,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B,GACL,OAAO,CAAC,IAAI,CAAC,CA4Ff"}