@dooc-dev/dooc 0.0.0-stage → 0.0.1

package/dist/viewer/language-picker.js

@@ -0,0 +1,233 @@
+/** Keep the native select as the language enum and change-event source. */
+export const mountLanguagePickers = (t) => {
+    for (const select of document.querySelectorAll("#fm-lang, #ui-language")) {
+        const translations = select.id === "fm-lang";
+        const trigger = select
+            .closest(".fm-language")
+            ?.querySelector("[data-language-open]");
+        const wrapper = document.createElement("div");
+        wrapper.className = "language-select";
+        const popup = document.createElement("div");
+        popup.className = "language-picker";
+        popup.id = `${select.id}-picker`;
+        popup.popover = "manual";
+        const input = document.createElement("input");
+        input.type = "text";
+        input.className = "language-select-input";
+        input.autocomplete = "off";
+        input.spellcheck = false;
+        input.setAttribute("role", "combobox");
+        input.setAttribute("aria-autocomplete", "list");
+        input.setAttribute("aria-haspopup", "listbox");
+        input.setAttribute("aria-expanded", "false");
+        const list = document.createElement("div");
+        list.className = "language-options";
+        list.id = `${select.id}-options`;
+        list.tabIndex = -1;
+        list.setAttribute("role", "listbox");
+        if (translations) {
+            list.setAttribute("aria-multiselectable", "true");
+            input.setAttribute("aria-keyshortcuts", "Control+Enter");
+        }
+        input.setAttribute("aria-controls", list.id);
+        const empty = document.createElement("div");
+        empty.className = "language-empty";
+        empty.setAttribute("role", "status");
+        popup.append(list, empty);
+        select.before(wrapper);
+        wrapper.append(select, input, popup);
+        select.hidden = true;
+        let active = 0;
+        let query = "";
+        const isOpen = () => popup.matches(":popover-open");
+        const selectedText = () => select.selectedOptions[0]?.text ?? "";
+        const position = () => {
+            const rect = input.getBoundingClientRect();
+            const below = innerHeight - rect.bottom;
+            const above = below < 240 && rect.top > below;
+            Object.assign(popup.style, {
+                width: `${rect.width}px`,
+                left: `${rect.left}px`,
+                maxHeight: `${Math.max(80, Math.min(360, (above ? rect.top : below) - 12))}px`,
+                top: above ? "auto" : `${rect.bottom + 4}px`,
+                bottom: above ? `${innerHeight - rect.top + 4}px` : "auto",
+            });
+        };
+        const highlight = (index) => {
+            const options = [...list.querySelectorAll("button")];
+            active = options.length ? (index + options.length) % options.length : 0;
+            options.forEach((option, i) => {
+                option.dataset.active = String(i === active);
+            });
+            const option = options[active];
+            if (option) {
+                input.setAttribute("aria-activedescendant", option.id);
+                if (isOpen())
+                    option.scrollIntoView({ block: "nearest" });
+            }
+            else
+                input.removeAttribute("aria-activedescendant");
+        };
+        const render = () => {
+            const words = query.normalize("NFKC").toLowerCase().trim().split(/\s+/).filter(Boolean);
+            const fragment = document.createDocumentFragment();
+            let selected = 0;
+            let count = 0;
+            for (const [i, option] of [...select.options].entries()) {
+                if (option.disabled ||
+                    !words.every((word) => option.text.normalize("NFKC").toLowerCase().includes(word)))
+                    continue;
+                const item = document.createElement("button");
+                item.type = "button";
+                item.tabIndex = -1;
+                item.id = `${select.id}-option-${i}`;
+                item.dataset.value = option.value;
+                item.textContent = item.title = option.text;
+                item.disabled = select.disabled;
+                item.setAttribute("role", "option");
+                item.setAttribute("aria-selected", translations ? (option.dataset.added ?? "false") : String(option.selected));
+                if (translations) {
+                    const marker = document.createElement("span");
+                    marker.className = "language-toggle";
+                    marker.textContent = option.dataset.added === "true" ? "✓" : "+";
+                    marker.title = t(option.value === select.dataset.source
+                        ? "Source language cannot be removed"
+                        : option.dataset.added === "true"
+                            ? "Remove translation"
+                            : "Add translation");
+                    item.textContent = option.text;
+                    item.prepend(marker);
+                    item.setAttribute("aria-current", String(option.selected));
+                }
+                if (option.selected)
+                    selected = count;
+                fragment.append(item);
+                count++;
+            }
+            list.replaceChildren(fragment);
+            empty.hidden = count > 0;
+            empty.textContent = t("No results");
+            highlight(selected);
+        };
+        const sync = () => {
+            input.title = selectedText();
+            input.readOnly = select.disabled;
+            if (trigger)
+                trigger.disabled = select.disabled;
+            input.setAttribute("aria-disabled", String(select.disabled));
+            input.placeholder = t("Search languages");
+            input.setAttribute("aria-label", select.getAttribute("aria-label") ?? t("Language"));
+            if (translations)
+                input.setAttribute("aria-description", t("Enter to edit; Ctrl+Enter to add or remove translation"));
+            if (!isOpen() || !query)
+                input.value = selectedText();
+            if (isOpen())
+                render();
+        };
+        popup.addEventListener("beforetoggle", (event) => {
+            const open = event.newState === "open";
+            input.setAttribute("aria-expanded", String(open));
+            trigger?.setAttribute("aria-expanded", String(open));
+            if (open) {
+                render();
+                position();
+            }
+            else {
+                query = "";
+                input.value = selectedText();
+                input.removeAttribute("aria-activedescendant");
+            }
+        });
+        const choose = (item) => {
+            if (!item || select.disabled)
+                return;
+            select.value = item.dataset.value ?? "";
+            if (!translations)
+                popup.hidePopover();
+            select.dispatchEvent(new Event("change", { bubbles: true }));
+            sync();
+        };
+        const toggle = (item) => {
+            if (!item || select.disabled || item.dataset.value === select.dataset.source)
+                return;
+            select.dispatchEvent(new CustomEvent("docs:toggle-language", { detail: item.dataset.value }));
+        };
+        const open = () => {
+            if (isOpen() || select.disabled)
+                return;
+            popup.showPopover();
+            input.select();
+        };
+        input.addEventListener("focus", open);
+        trigger?.addEventListener("click", () => {
+            input.focus();
+            open();
+        });
+        input.addEventListener("click", open);
+        input.addEventListener("input", () => {
+            query = input.value;
+            if (isOpen())
+                render();
+            else
+                popup.showPopover();
+        });
+        input.addEventListener("keydown", (event) => {
+            if (event.isComposing)
+                return;
+            if (event.key === "ArrowDown" || event.key === "ArrowUp") {
+                event.preventDefault();
+                if (isOpen())
+                    highlight(active + (event.key === "ArrowDown" ? 1 : -1));
+                else
+                    open();
+            }
+            else if (event.key === "Enter" && isOpen()) {
+                event.preventDefault();
+                const item = list.querySelector('[data-active="true"]');
+                if (translations && event.ctrlKey)
+                    toggle(item);
+                else
+                    choose(item);
+            }
+            else if (event.key === "Escape" && isOpen()) {
+                event.preventDefault();
+                popup.hidePopover();
+                input.select();
+            }
+        });
+        list.addEventListener("pointerdown", (event) => event.preventDefault());
+        list.addEventListener("click", (event) => {
+            const target = event.target;
+            const item = target.closest("button");
+            if (translations && target.closest(".language-toggle"))
+                toggle(item);
+            else
+                choose(item);
+        });
+        popup.addEventListener("toggle", () => {
+            if (isOpen())
+                highlight(active);
+        });
+        wrapper.addEventListener("focusout", (event) => {
+            if (isOpen() &&
+                !(event.relatedTarget instanceof Node && wrapper.contains(event.relatedTarget)))
+                popup.hidePopover();
+        });
+        document.addEventListener("pointerdown", (event) => {
+            if (isOpen() && event.target instanceof Node && !wrapper.contains(event.target))
+                popup.hidePopover();
+        });
+        new ResizeObserver(() => {
+            if (isOpen())
+                position();
+        }).observe(input);
+        select.addEventListener("change", sync);
+        new MutationObserver(sync).observe(select, {
+            childList: true,
+            subtree: true,
+            attributes: true,
+        });
+        document.addEventListener("docs:ui-language", sync);
+        sync();
+    }
+};

package/dist/viewer/languages.d.ts

@@ -0,0 +1,11 @@
+import type { LanguageRegistration } from "shiki/core";
+import type { LanguageAdapter } from "../core/language.js";
+export declare const BUILTIN_LANGUAGES: readonly LanguageAdapter[];
+export interface SiteLanguages {
+    languages: readonly LanguageAdapter[];
+    codeLanguages?: string[];
+    codeGrammars?: LanguageRegistration[];
+}
+export declare const DEFAULT_SITE_LANGUAGES: SiteLanguages;
+/** docs.config.mjs + built-ins (configured adapters first, so they override a built-in code). */
+export declare const loadSiteLanguages: (root: string) => Promise<SiteLanguages>;

package/dist/viewer/languages.js

@@ -0,0 +1,20 @@
+// Built-in language adapters for the Node tools (viewer / CLI / MCP): the browser-safe core
+// adapters plus their Node-only prose lint. docs.config.mjs adapters take precedence.
+import { loadCodeLanguages } from "../compiler/code-languages.js";
+import { loadDocsConfig } from "../compiler/config.js";
+import { ja } from "../core/languages/ja.js";
+export const BUILTIN_LANGUAGES = [
+    // textlint is heavy; load it on the first lint request.
+    { ...ja, lint: async (body) => (await import("./ja-lint.js")).lintJa(body) },
+];
+export const DEFAULT_SITE_LANGUAGES = {
+    languages: BUILTIN_LANGUAGES,
+};
+/** docs.config.mjs + built-ins (configured adapters first, so they override a built-in code). */
+export const loadSiteLanguages = async (root) => {
+    const config = await loadDocsConfig(root);
+    return {
+        ...(await loadCodeLanguages(root)),
+        languages: [...config.languages, ...BUILTIN_LANGUAGES],
+    };
+};

package/dist/viewer/locales/eng.json

@@ -0,0 +1,294 @@
+{
+    "Editor font": "Editor font",
+    "Viewer font": "Viewer font",
+    "Default font": "Default font",
+    "Loading fonts": "Loading fonts",
+    "Font choice applies only to this tab": "Font choice applies only to this tab; browser storage is unavailable.",
+    "Invalid font file": "This font file could not be loaded. Choose a valid font supported by your browser.",
+    "Preview theme": "Preview theme",
+    "Editor theme": "Editor theme",
+    "Open link": "Open link",
+    "Copy link": "Copy link",
+    "Collapse preview": "Collapse preview",
+    "Expand preview": "Expand preview",
+    "Resize plugin card": "Resize plugin card",
+    "Open the local viewer to load plugin data": "Open the local viewer to load plugin data",
+    "Load data": "Load data",
+    "Connect account": "Connect account",
+    "Forget connection": "Forget connection",
+    "Load data using your connected account": "Load data using your connected account",
+    "Loading plugin data": "Loading plugin data",
+    "Continue to service": "Continue to service",
+    "Connected as {name}": "Connected as {name}",
+    "Connection forgotten in dooc": "Connection forgotten in dooc",
+    "Connect this plugin again": "Connect this plugin again",
+    "Plugin is not configured": "Plugin is not configured",
+    "Plugin request failed": "Plugin request failed",
+    "Plugin service request failed": "Plugin service request failed",
+    "Access denied by the service": "Access denied by the service",
+    "Collapse code": "Collapse code",
+    "Expand code": "Expand code",
+    "Language": "Editor language",
+    "Save": "Save",
+    "Save (Ctrl+S)": "Save (Ctrl+S)",
+    "View settings": "View settings",
+    "Auto save": "Auto save",
+    "Front-matter fields": "Front-matter fields",
+    "title": "title",
+    "desc": "desc",
+    "lang": "lang",
+    "Remove icon": "Remove icon",
+    "icon": "icon",
+    "rename": "rename",
+    "Enter to save / Esc to cancel": "Enter to save / Esc to cancel",
+    "Change doc id": "Change doc id",
+    "Delete doc": "Delete doc",
+    "Add doc": "Add doc",
+    "Resources": "Resources",
+    "markdown": "Markdown",
+    "figures": "Figures",
+    "html": "HTML",
+    "icons": "Icons",
+    "Resize sidebar": "Resize sidebar",
+    "Resize document tree": "Resize document tree",
+    "Resize editor": "Resize editor",
+    "Close sidebar": "Close sidebar",
+    "Open sidebar": "Open sidebar",
+    "Create": "Create",
+    "Unsaved changes": "Unsaved changes",
+    "Modified (waiting for auto-save)": "Modified (waiting for auto-save)",
+    "Enter to rename / Esc to cancel (file links follow)": "Enter to rename / Esc to cancel (file links follow)",
+    "Icon must be svg": "Icon must be svg",
+    "Change site icon": "Change site icon",
+    "Icon set (auto-padded to 1:1)": "Icon set (auto-padded to 1:1)",
+    "Icon removed": "Icon removed",
+    "Only svg / png / webp / jpeg can be added": "Only svg / png / webp / jpeg can be added",
+    "Updated externally (keeping unsaved changes)": "Updated externally (keeping unsaved changes)",
+    "Changed externally — keeping your changes (you'll be asked again on save)": "Changed externally — keeping your changes (you'll be asked again on save)",
+    "You have unsaved changes. Discard them and leave?": "You have unsaved changes. Discard them and leave?",
+    "Saved": "Saved",
+    "Auto": "Auto",
+    "Light": "Light",
+    "Dark": "Dark",
+    "Theme": "Theme",
+    "Saved {time}": "Saved {time}",
+    "Saved (validation errors: {count})": "Saved (validation errors: {count})",
+    "Failed to save: {error}": "Failed to save: {error}",
+    "Delete \"{file}\"? (this cannot be undone)": "Delete \"{file}\" and all its translations? (this cannot be undone)",
+    "Failed to delete: {error}": "Failed to delete: {error}",
+    "Adding figures… ({count})": "Adding figures… ({count})",
+    "Added figures: {names}": "Added figures: {names}",
+    "Failed to add figures: {error}": "Failed to add figures: {error}",
+    "Failed to set icon: {error}": "Failed to set icon: {error}",
+    "Failed to update preview: {error}": "Failed to update preview: {error}",
+    "Failed to apply external changes: {error}": "Failed to apply external changes: {error}",
+    "Can't rename: {error}": "Can't rename: {error}",
+    "Applied external changes": "Applied external changes",
+    "Contents": "Contents",
+    "Copy code": "Copy code",
+    "External conflict": "This doc was updated elsewhere. Apply the external changes?\n\nOK: discard unsaved edits and apply external changes\nCancel: keep your edits and skip this save",
+    "Referenced documents: {list}": "Referenced by these documents:\n{list}\n\nDelete anyway? (links will be left dangling)",
+    "heading": "heading",
+    "subheading": "subheading",
+    "code fence": "code fence",
+    "figure reference": "figure reference",
+    "Templates": "Templates",
+    "Figures": "Figures",
+    "Doc links": "Doc links",
+    "Terms": "Terms",
+    "Custom syntax": "Custom syntax",
+    "path": "path",
+    "size": "size",
+    "kind": "kind",
+    "syntax": "syntax",
+    "doc": "doc",
+    "used in": "used in",
+    "none": "none",
+    "Split view": "Split view",
+    "Change language": "Change language",
+    "Active pane": "Active pane",
+    "Activate pane": "Activate pane",
+    "Failed to load pane": "Failed to load pane",
+    "Close pane and discard its unsaved changes?": "Close pane and discard its unsaved changes?",
+    "Validate and apply": "Validate and apply",
+    "Auto validate": "Auto validate",
+    "Source mapping": "Source mapping",
+    "Validation pending": "Validation pending",
+    "Validating": "Validating",
+    "Validation passed": "Validation passed",
+    "Validation errors": "Validation errors",
+    "Saving": "Saving",
+    "Save failed": "Save failed",
+    "Expand section": "Expand section",
+    "Collapse section": "Collapse section",
+    "terms": "Terms",
+    "Edit text file": "Edit text file",
+    "Create file": "Create file",
+    "Reload file": "Reload file",
+    "Working…": "Working…",
+    "File not found — save to create it.": "File not found — save to create it.",
+    "Discard file edits and reload?": "Discard file edits and reload?",
+    "File changed externally. Reload it before saving.": "File changed externally. Reload it before saving.",
+    "Edits made while reloading were kept. Reload again when ready.": "Edits made while reloading were kept. Reload again when ready.",
+    "File not found": "File not found",
+    "File has not been loaded": "File has not been loaded",
+    "File could not be loaded": "File could not be loaded",
+    "View remote text file": "View remote text file",
+    "Remote files are read-only": "Remote files are read-only",
+    "Edits made while validating were kept. Validate again when ready.": "Edits made while validating were kept. Validate again when ready.",
+    "Updating preview": "Updating preview",
+    "Preview is up to date": "Preview is up to date",
+    "Preview could not be updated": "Preview could not be updated",
+    "Conflicting changes": "Conflicting changes",
+    "Use my edits": "Use my edits",
+    "Use external changes": "Use external changes",
+    "File was deleted": "File was deleted",
+    "Cancel": "Cancel",
+    "Search documents": "Search documents",
+    "No results": "No results",
+    "Searching…": "Searching…",
+    "Could not load search. Press Ctrl+F to retry.": "Could not load search. Press Ctrl+F to retry.",
+    "{count} results": "{count} results",
+    "Showing {shown} of {count} results": "Showing {shown} of {count} results",
+    "Add translation": "Add translation",
+    "Folder": "Folder",
+    "Move search": "Move search",
+    "Resize search": "Resize search",
+    "Notice": "Notice",
+    "OK": "OK",
+    "Discard changes": "Discard changes",
+    "Copy section URL": "Copy section URL",
+    "Copied": "Copied",
+    "Could not copy URL": "Could not copy URL",
+    "Search languages": "Search languages",
+    "Remove translation": "Remove translation",
+    "Source language cannot be removed": "Source language cannot be removed",
+    "Enter to edit; Ctrl+Enter to add or remove translation": "Enter to edit; Ctrl+Enter to add or remove translation",
+    "Preview has not been updated": "Preview has not been updated",
+    "Table": "Table",
+    "Image": "Image",
+    "HTML": "HTML",
+    "Markdown": "Markdown",
+    "Code": "Code",
+    "Video": "Video",
+    "Loading": "Loading",
+    "Retry": "Retry",
+    "Reload": "Reload",
+    "Close": "Close",
+    "File preview": "File preview",
+    "Files": "Files",
+    "Search files": "Search files",
+    "Extension": "Extension",
+    "Default folder layout": "Default folder layout",
+    "Folder restructure": "Folder restructure",
+    "Move": "Move",
+    "Move up": "Move up",
+    "Move down": "Move down",
+    "Move to root": "Move to root",
+    "Name": "Name",
+    "Size": "Size",
+    "Select": "Select",
+    "Copy path": "Copy path",
+    "File path": "File path",
+    "File created": "File created",
+    "Copy failed": "Copy failed",
+    "Place new files in files/<extension>/": "Place new files in files/<extension>/",
+    "Document changed. Retry from the current block.": "Document changed. Retry from the current block.",
+    "Document changed. Insert the file from Files.": "Document changed. Insert the file from Files.",
+    "File name": "File name",
+    "Renamed to {filename}": "Renamed to {filename}",
+    "Enter a file name ending in .md": "Enter a file name ending in .md",
+    "Upload files": "Upload files",
+    "Uploading {count}/{total}": "Uploading {count}/{total}",
+    "Files uploaded": "Files uploaded",
+    "File exceeds 64 MiB": "File exceeds 64 MiB",
+    "Choose files inside the folder": "Choose files inside the folder",
+    "Click a column to sort; row numbers refer to the source": "Click a column to sort; row numbers refer to the source",
+    "Column": "Column",
+    "Resize table": "Resize table",
+    "Back to document": "Back to document",
+    "File details": "File details",
+    "Show Git changes": "Show Git changes",
+    "Resource views": "Resource views",
+    "Dictionary": "Dictionary",
+    "Code blocks": "Code blocks",
+    "Code language": "Code language",
+    "URLs": "URLs",
+    "Domain": "Domain",
+    "All": "All",
+    "references": "references",
+    "Definitions from term files and Markdown": "Definitions from term files and Markdown",
+    "Code blocks collected from Markdown files": "Code blocks collected from Markdown files",
+    "External links and embeds with their source locations": "External links and embeds with their source locations",
+    "Search resources": "Search resources",
+    "Files with errors": "Files with errors",
+    "No matching resources": "No matching resources",
+    "Organize files": "Organize files",
+    "Auto-save paused": "Auto-save paused",
+    "Reload failed": "Reload failed",
+    "Waiting for auto-save": "Waiting for auto-save",
+    "Conflict unresolved. Auto-save is paused; your edits are kept.": "Conflict unresolved. Auto-save is paused; your edits are kept.",
+    "File not found — editing will create it automatically.": "File not found — editing will create it automatically.",
+    "Play": "Play",
+    "Pause": "Pause",
+    "Seek": "Seek",
+    "Mute": "Mute",
+    "Unmute": "Unmute",
+    "Volume": "Volume",
+    "Video settings": "Video settings",
+    "Playback speed": "Playback speed",
+    "Fullscreen": "Fullscreen",
+    "Video could not be played": "Video could not be played",
+    "Fullscreen is unavailable": "Fullscreen is unavailable",
+    "Some registered fonts could not be loaded": "Some registered fonts could not be loaded",
+    "Done": "Done",
+    "Git operation failed": "Git operation failed",
+    "Create pull request": "Create pull request",
+    "Base branch": "Base branch",
+    "Draft": "Draft",
+    "Open pull request": "Open pull request",
+    "Merge method": "Merge method",
+    "Merge pull request": "Merge pull request",
+    "Merge #{number} into {base} using {method}?": "Merge #{number} into {base} using {method}?",
+    "Reset edits": "Reset edits",
+    "Discard these pull request edits?": "Discard these pull request edits?",
+    "Branch": "Branch",
+    "Switch branch": "Switch branch",
+    "New branch": "New branch",
+    "Create branch": "Create branch",
+    "Changes": "Changes",
+    "Git uses saved files.": "Git uses saved files.",
+    "Stage": "Stage",
+    "Unstage": "Unstage",
+    "Working tree clean": "Working tree clean",
+    "Commit message": "Commit message",
+    "Commit staged changes": "Commit staged changes",
+    "Fetch": "Fetch",
+    "Pull (fast-forward)": "Pull (fast-forward)",
+    "Push": "Push",
+    "Connect an origin provider from the viewer module to enable remote operations.": "Connect an origin provider from the viewer module to enable remote operations.",
+    "Pull requests": "Pull requests",
+    "No open pull requests": "No open pull requests",
+    "Description": "Description",
+    "Operation completed, but reload failed: {error}": "Operation completed, but reload failed: {error}",
+    "Stash is occupied. Commit the current changes before switching branches.": "Stash is occupied. Commit the current changes before switching branches.",
+    "Stash saved changes and switch to {branch}?": "Stash saved changes and switch to {branch}?",
+    "Stash and switch": "Stash and switch",
+    "Create the first commit to switch branches.": "Create the first commit to switch branches.",
+    "Stash · empty": "Stash · empty",
+    "Restore stash": "Restore stash",
+    "Stash changes": "Stash changes",
+    "Statics": "Statics",
+    "Workspace tools": "Workspace tools",
+    "Resize workspace tools": "Resize workspace tools",
+    "Git controls": "Git controls",
+    "Actions": "Actions",
+    "Updated": "Updated",
+    "Copy": "Copy",
+    "Edit": "Edit",
+    "Saving…": "Saving…",
+    "Reload actions before saving again.": "Reload actions before saving again.",
+    "Saved, but refresh failed. Reload actions before saving again.": "Saved, but refresh failed. Reload actions before saving again.",
+    "Actions could not be loaded.": "Actions could not be loaded.",
+    "An open draft is no longer editable. Copy or cancel it before reloading.": "An open draft is no longer editable. Copy or cancel it before reloading."
+}