@dooc-dev/dooc 0.0.0-stage → 0.0.2

package/dist/viewer/site-icon.d.ts

@@ -0,0 +1,8 @@
+export declare const siteIconResponse: (root: string, input: Record<string, unknown> | undefined) => {
+    status: number;
+    body: {
+        icon: string;
+    } | {
+        error: string;
+    };
+};

package/dist/viewer/site-icon.js

@@ -0,0 +1,56 @@
+import { existsSync } from "node:fs";
+import { Document, isSeq, parseDocument } from "yaml";
+import { ICONS_DIR, squareSvg } from "../compiler/icons.js";
+import { parseManifestText } from "../compiler/manifest.js";
+import { readTextfile, textfilePath, writeTextfile } from "../compiler/textfile.js";
+import { MANIFEST_FILE } from "../core/content-metadata.js";
+import { defaultFilePath } from "../core/files.js";
+export const siteIconResponse = (root, input) => {
+    const svg = typeof input?.data === "string"
+        ? squareSvg(Buffer.from(input.data, "base64").toString("utf8"))
+        : undefined;
+    if (!svg)
+        return {
+            status: 400,
+            body: { error: "specify an svg (viewBox or width / height required)" },
+        };
+    try {
+        const raw = existsSync(textfilePath(root, MANIFEST_FILE))
+            ? readTextfile(root, MANIFEST_FILE)
+            : null;
+        const manifest = parseManifestText(raw ?? "[]");
+        if (manifest.errors.length)
+            return { status: 409, body: { error: manifest.errors.join("\n") } };
+        const file = manifest.icon ??
+            (manifest.files?.defaultLayout !== false
+                ? defaultFilePath("_site.svg")
+                : `${ICONS_DIR}/_site.svg`);
+        if (!manifest.icon && existsSync(textfilePath(root, file)))
+            return {
+                status: 409,
+                body: { error: `${file} already exists; set dooc.yaml's icon to use it` },
+            };
+        const base = existsSync(textfilePath(root, file)) ? readTextfile(root, file) : null;
+        if (!writeTextfile(root, file, svg, base))
+            return { status: 409, body: { error: "Icon changed externally. Try again." } };
+        if (!manifest.icon) {
+            const parsed = parseDocument(raw ?? "docs: []\n");
+            const document = isSeq(parsed.contents) || parsed.contents == null
+                ? new Document({ docs: parsed.toJS() ?? [] })
+                : parsed;
+            document.set("icon", file);
+            if (!writeTextfile(root, MANIFEST_FILE, document.toString(), raw))
+                return { status: 409, body: { error: "Manifest changed externally. Try again." } };
+        }
+        return {
+            status: 200,
+            body: { icon: `data:image/svg+xml;base64,${Buffer.from(svg).toString("base64")}` },
+        };
+    }
+    catch (error) {
+        return {
+            status: 400,
+            body: { error: error instanceof Error ? error.message : String(error) },
+        };
+    }
+};

package/dist/viewer/textfile.d.ts

@@ -0,0 +1,9 @@
+export declare const previewTextfiles: (root: string, input: unknown) => ReadonlyMap<string, string>;
+export declare const textfileResponse: (root: string, input: Record<string, unknown> | undefined, domains?: readonly string[]) => Promise<{
+    status: number;
+    body: {
+        content?: string | null;
+        error?: string;
+        gitBase?: string | null;
+    };
+}>;

package/dist/viewer/textfile.js

@@ -0,0 +1,50 @@
+import { readTextfileAsync, textfilePath, writeTextfile } from "../compiler/textfile.js";
+import { TextfileUnavailable } from "../compiler/textfile-remote.js";
+import { isRemoteTextfile } from "../core/textfile.js";
+export const previewTextfiles = (root, input) => {
+    if (input === undefined)
+        return new Map();
+    if (!input || typeof input !== "object" || Array.isArray(input))
+        throw new Error("Expected text file drafts");
+    const files = new Map();
+    for (const [file, content] of Object.entries(input)) {
+        textfilePath(root, file);
+        if (typeof content !== "string" || /[\0\uD800-\uDFFF]/u.test(content))
+            throw new Error("Expected UTF-8 text file content");
+        files.set(file.replace(/^(\.\/)+/, ""), content);
+    }
+    return files;
+};
+export const textfileResponse = async (root, input, domains = []) => {
+    if (typeof input?.file !== "string" || !["read", "save"].includes(String(input.action)))
+        return { status: 400, body: { error: "Invalid text file request" } };
+    try {
+        if (input.action === "save") {
+            if (isRemoteTextfile(input.file))
+                return { status: 400, body: { error: "Remote files are read-only" } };
+            if (typeof input.content !== "string" ||
+                (input.base !== null && typeof input.base !== "string"))
+                return { status: 400, body: { error: "Content and original text are required" } };
+            if (!writeTextfile(root, input.file, input.content, input.base))
+                return {
+                    status: 409,
+                    body: { error: "File changed externally. Reload it before saving." },
+                };
+            return { status: 200, body: { content: input.content } };
+        }
+        return {
+            status: 200,
+            body: { content: await readTextfileAsync(root, input.file, true, domains) },
+        };
+    }
+    catch (error) {
+        if (input.action === "read" &&
+            (error.code === "ENOENT" ||
+                (error instanceof TextfileUnavailable && error.reason === "missing")))
+            return { status: 200, body: { content: null } };
+        return {
+            status: 400,
+            body: { error: error instanceof Error ? error.message : String(error) },
+        };
+    }
+};

package/dist/viewer/theme-picker.d.ts

@@ -0,0 +1,2 @@
+/** Self-contained because published viewers embed this function directly. */
+export declare const mountThemePickers: (icons: Record<string, string>, themes?: string[]) => void;

package/dist/viewer/theme-picker.js

@@ -0,0 +1,135 @@
+/** Self-contained because published viewers embed this function directly. */
+export const mountThemePickers = (icons, themes = ["light", "dark"]) => {
+    const root = document.documentElement;
+    const documentChoices = themes.length === 1 ? themes : ["auto", ...themes];
+    const read = (key) => {
+        try {
+            const value = localStorage.getItem(key);
+            return value === "light" || value === "dark" ? value : "auto";
+        }
+        catch {
+            return "auto";
+        }
+    };
+    let documentDefault = read("docs-preview:theme");
+    if (!documentChoices.includes(documentDefault))
+        documentDefault = documentChoices[0] ?? "auto";
+    root.dataset.theme = documentDefault;
+    root.dataset.editorTheme = read("docs-editor:theme");
+    const t = (key) => window.__docsTranslate?.(key) ??
+        key;
+    const popup = document.createElement("div");
+    popup.className = "theme-picker";
+    popup.id = "theme-picker";
+    popup.popover = "auto";
+    popup.setAttribute("role", "menu");
+    document.body.append(popup);
+    let trigger;
+    const target = (button) => button.dataset.themePicker === "editor"
+        ? root
+        : (button.closest(".preview-pane") ?? root);
+    const current = (button) => button.dataset.themePicker === "editor"
+        ? (root.dataset.editorTheme ?? "auto")
+        : (target(button).dataset.theme ?? "auto");
+    const sync = () => {
+        for (const pane of document.querySelectorAll(".resources-pane"))
+            if (pane.dataset.theme !== root.dataset.editorTheme)
+                pane.dataset.theme = root.dataset.editorTheme;
+        for (const pane of document.querySelectorAll(".preview-pane:not(.resources-pane)"))
+            if (!documentChoices.includes(pane.dataset.theme ?? ""))
+                pane.dataset.theme = documentDefault;
+        for (const button of document.querySelectorAll("[data-theme-picker]")) {
+            const value = current(button);
+            const markup = icons[value === "auto" ? "" : value] ?? "";
+            if (button.dataset.themeIcon !== value) {
+                button.innerHTML = markup;
+                button.dataset.themeIcon = value;
+            }
+            const label = t(button.dataset.themePicker === "editor" ? "Editor theme" : "Preview theme");
+            button.title = `${label}: ${t(value === "auto" ? "Auto" : value === "light" ? "Light" : "Dark")}`;
+            button.setAttribute("aria-label", button.title);
+            button.setAttribute("aria-haspopup", "menu");
+            button.setAttribute("aria-controls", popup.id);
+        }
+    };
+    document.addEventListener("click", (event) => {
+        const button = event.target instanceof Element
+            ? event.target.closest("[data-theme-picker]")
+            : null;
+        if (!button)
+            return;
+        if (trigger === button && popup.matches(":popover-open")) {
+            popup.hidePopover();
+            return;
+        }
+        if (popup.matches(":popover-open"))
+            popup.hidePopover();
+        trigger = button;
+        popup.dataset.theme = current(button);
+        popup.replaceChildren();
+        for (const value of button.dataset.themePicker === "editor"
+            ? ["auto", "light", "dark"]
+            : documentChoices) {
+            const option = document.createElement("button");
+            option.type = "button";
+            option.dataset.value = value;
+            option.setAttribute("role", "menuitemradio");
+            option.setAttribute("aria-checked", String(value === current(button)));
+            option.innerHTML = icons[value === "auto" ? "" : value] ?? "";
+            option.append(document.createTextNode(t(value === "auto" ? "Auto" : value === "light" ? "Light" : "Dark")));
+            popup.append(option);
+        }
+        const rect = button.getBoundingClientRect();
+        popup.style.left = `${Math.max(8, Math.min(rect.left, innerWidth - 156))}px`;
+        popup.style.top = `${Math.min(rect.bottom + 6, innerHeight - 140)}px`;
+        popup.showPopover();
+        button.setAttribute("aria-expanded", "true");
+        popup.querySelector('[aria-checked="true"]')?.focus();
+    });
+    popup.addEventListener("click", (event) => {
+        const option = event.target instanceof Element
+            ? event.target.closest("[data-value]")
+            : null;
+        if (!option || !trigger)
+            return;
+        const value = option.dataset.value ?? "auto";
+        const editor = trigger.dataset.themePicker === "editor";
+        if (editor)
+            root.dataset.editorTheme = value;
+        else {
+            target(trigger).dataset.theme = value;
+            documentDefault = value;
+        }
+        try {
+            localStorage.setItem(editor ? "docs-editor:theme" : "docs-preview:theme", value);
+        }
+        catch {
+            /* Theme selection still works without persistence. */
+        }
+        popup.hidePopover();
+        trigger.focus();
+        sync();
+    });
+    popup.addEventListener("keydown", (event) => {
+        const options = [...popup.querySelectorAll("button")];
+        const index = options.indexOf(document.activeElement);
+        if (event.key === "ArrowDown" || event.key === "ArrowUp") {
+            event.preventDefault();
+            options[(index + (event.key === "ArrowDown" ? 1 : options.length - 1)) % options.length]?.focus();
+        }
+        if (event.key === "Escape")
+            trigger?.focus();
+    });
+    popup.addEventListener("toggle", () => {
+        if (!popup.matches(":popover-open"))
+            trigger?.setAttribute("aria-expanded", "false");
+    });
+    document.addEventListener("docs:ui-language", sync);
+    new MutationObserver(sync).observe(root, {
+        childList: true,
+        subtree: true,
+        attributes: true,
+        attributeFilter: ["data-theme", "data-editor-theme"],
+    });
+    sync();
+};

package/dist/viewer/workspace.d.ts

@@ -0,0 +1,4 @@
+import type { WorkspaceSource } from "../core/workspace.js";
+export declare const gitHeadFile: (root: string) => string | undefined;
+/** Read only local metadata; no Git commands, credentials or network access are needed. */
+export declare const readWorkspaceSource: (root: string) => WorkspaceSource;

package/dist/viewer/workspace.js

@@ -0,0 +1,47 @@
+import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+/** Git worktrees use a .git file pointing at their own metadata directory. */
+const gitMetadata = (root) => {
+    let directory = realpathSync(root);
+    for (;;) {
+        const git = join(directory, ".git");
+        try {
+            const target = statSync(git).isDirectory()
+                ? git
+                : /^gitdir: (.+)\r?\n?$/.exec(readFileSync(git, "utf8"))?.[1];
+            const head = target ? join(resolve(directory, target.trim()), "HEAD") : undefined;
+            return head && existsSync(head) ? { head, directory } : undefined;
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                return undefined;
+        }
+        const parent = dirname(directory);
+        if (parent === directory)
+            return undefined;
+        directory = parent;
+    }
+};
+export const gitHeadFile = (root) => gitMetadata(root)?.head;
+/** Read only local metadata; no Git commands, credentials or network access are needed. */
+export const readWorkspaceSource = (root) => {
+    const git = gitMetadata(root);
+    if (git) {
+        try {
+            const common = join(dirname(git.head), "commondir");
+            const repo = basename(existsSync(common)
+                ? dirname(resolve(dirname(git.head), readFileSync(common, "utf8").trim()))
+                : git.directory);
+            const head = readFileSync(git.head, "utf8").trim();
+            const branch = /^ref: refs\/heads\/(.+)$/.exec(head)?.[1];
+            if (branch)
+                return { protocol: "git", repo, branch };
+            if (/^(?:[a-f\d]{40}|[a-f\d]{64})$/i.test(head))
+                return { protocol: "git", repo, branch: `HEAD (${head.slice(0, 7)})` };
+        }
+        catch {
+            // Unreadable Git metadata must not prevent access to the document files.
+        }
+    }
+    return { protocol: "storage", folder: basename(resolve(root)) || root, service: "Local" };
+};

package/package.json

@@ -1,6 +1,129 @@
 {
-  "name": "@dooc-dev/dooc",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "@dooc-dev/dooc",
+    "version": "0.0.2",
+    "description": "View and edit source files with dooc.yaml configuration, and share them as source ZIPs or standalone HTML.",
+    "type": "module",
+    "files": [
+        "dist"
+    ],
+    "bin": {
+        "dooc": "./dist/cli.js"
+    },
+    "exports": {
+        "./check": {
+            "types": "./dist/compiler/check.d.ts",
+            "default": "./dist/compiler/check.js"
+        },
+        "./viewer-plugins": {
+            "types": "./dist/viewer/plugins.d.ts",
+            "default": "./dist/viewer/plugins.js"
+        },
+        "./plugins": {
+            "types": "./dist/plugins/index.d.ts",
+            "default": "./dist/plugins/index.js"
+        },
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./flow": {
+            "types": "./dist/core/schema-graph-mount.d.ts",
+            "default": "./dist/core/schema-graph-mount.js"
+        },
+        "./flow.global.js": "./dist/flow.global.js"
+    },
+    "peerDependencies": {
+        "@xyflow/react": ">=12",
+        "react": ">=19",
+        "react-dom": ">=19"
+    },
+    "peerDependenciesMeta": {
+        "@xyflow/react": {
+            "optional": true
+        },
+        "react": {
+            "optional": true
+        },
+        "react-dom": {
+            "optional": true
+        }
+    },
+    "packageManager": "pnpm@10.28.2",
+    "engines": {
+        "node": ">=22"
+    },
+    "scripts": {
+        "build:plugin": "node -e \"require('node:fs').rmSync('packages/dooc-plugin/dist', {recursive:true, force:true})\" && tsc -p tsconfig.plugin.json",
+        "test:plugin-package": "node --import tsx scripts/test-plugin-package.mjs",
+        "build": "node -e \"require('node:fs').rmSync('dist', {recursive:true, force:true})\" && pnpm run build:css && pnpm run build:fonts && tsc -p tsconfig.build.json && pnpm run build:flow && pnpm run build:edit",
+        "build:binary": "bun scripts/build-binary.mjs",
+        "build:css": "node --import tsx src/core/build-flow-css.ts",
+        "build:flow": "esbuild src/core/schema-graph-global.tsx --bundle --format=iife --target=es2022 --minify --outfile=dist/flow.global.js",
+        "build:edit": "esbuild src/viewer/edit-client.ts --bundle --format=iife --target=es2022 --minify --outfile=dist/edit.global.js && esbuild src/viewer/ui-client.ts --bundle --format=iife --target=es2022 --minify --outfile=dist/ui.global.js && esbuild src/viewer/code-highlight.ts --bundle --format=iife --target=es2022 --minify --outfile=dist/code.global.js",
+        "test": "vitest run",
+        "test:binary": "node scripts/test-binary.mjs",
+        "test:install": "node scripts/test-install.mjs",
+        "check": "biome check . && tsc --noEmit && pnpm run build && vitest run && pnpm run test:install && pnpm run test:plugin-package",
+        "fix": "biome check --write .",
+        "build:fonts": "node -e \"require('node:fs').cpSync('src/viewer/fonts', 'dist/viewer/fonts', {recursive:true})\"",
+        "build:sample-extension": "node --import tsx scripts/build-sample-extension.mjs"
+    },
+    "devDependencies": {
+        "@biomejs/biome": "2.4.15",
+        "@codemirror/autocomplete": "^6.20.4",
+        "@codemirror/commands": "^6.11.1",
+        "@codemirror/lang-markdown": "^6.5.2",
+        "@codemirror/language": "^6.13.1",
+        "@codemirror/lint": "6.9.7",
+        "@codemirror/search": "6.7.2",
+        "@codemirror/state": "^6.7.6",
+        "@codemirror/view": "^6.43.15",
+        "@lezer/common": "^1.5.4",
+        "@lezer/highlight": "^1.2.5",
+        "@shikijs/themes": "^4.5.0",
+        "@types/mdast": "^4.0.4",
+        "@types/node": "^22.10.0",
+        "@types/react": "^19.2.17",
+        "@types/react-dom": "^19.2.3",
+        "@xyflow/react": "^12.11.2",
+        "diff": "8.0.4",
+        "esbuild": "^0.28.1",
+        "react": "^19.2.8",
+        "react-dom": "^19.2.8",
+        "textlint": "^15.8.0",
+        "tsx": "^4.19.2",
+        "typescript": "^5.8.3",
+        "vitest": "^2.1.9"
+    },
+    "dependencies": {
+        "@dagrejs/dagre": "^3.0.0",
+        "@shikijs/langs": "4.5.0",
+        "@textlint/kernel": "^15.8.0",
+        "@textlint/module-interop": "^15.8.0",
+        "@textlint/textlint-plugin-markdown": "^15.8.0",
+        "franc": "^6.2.0",
+        "iso-639-3": "^3.0.1",
+        "mermaid": "^12.3.0",
+        "parse5": "8.0.0",
+        "postcss": "8.5.32",
+        "postcss-value-parser": "4.2.0",
+        "remark-frontmatter": "^5.0.0",
+        "remark-gfm": "^4.0.1",
+        "remark-parse": "^11.0.0",
+        "remark-stringify": "11.0.0",
+        "shiki": "^4.5.0",
+        "string-width": "4.2.3",
+        "textlint-rule-preset-ja-technical-writing": "^12.0.2",
+        "unified": "^11.0.5",
+        "unist-util-visit": "^5.0.0",
+        "yaml": "^2.7.0"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/dooc-dev/dooc.git"
+    },
+    "publishConfig": {
+        "registry": "https://registry.npmjs.org",
+        "access": "public"
+    }
+}