@terra-symposium/docs 0.0.0-stage → 0.1.17

package/lib-dist/workspace.js

@@ -0,0 +1,151 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { Button, ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuSeparator, ContextMenuTrigger, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, Input, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, ToggleGroup, ToggleGroupItem, } from '@terra-symposium/styling/ui';
+import { DocumentAttachment, Download, Link, OverflowMenuVertical, TrashCan, } from '@carbon/icons-react';
+function attachmentKind(attachment) {
+    const type = attachment.type?.toLowerCase() ?? '';
+    const path = attachment.href.toLowerCase().split('?')[0] ?? '';
+    if (type.startsWith('image/') || /\.(png|jpe?g|gif|webp|svg)$/.test(path))
+        return 'Images';
+    if (type.startsWith('video/') || /\.(mp4|webm|mov)$/.test(path))
+        return 'Videos';
+    if (type === 'text/html' ||
+        (/^(https?:)?\/\//.test(attachment.href) && !path.match(/\.[a-z0-9]+$/)))
+        return 'Links';
+    return 'Files';
+}
+function firstLeaf(section) {
+    return section.groups.flatMap((group) => group.leaves)[0]?.href ?? '/';
+}
+function sectionForPath(sections, path) {
+    return Math.max(0, sections.findIndex((section) => section.groups.some((group) => group.leaves.some((leaf) => leaf.href === path))));
+}
+export function DocsWorkspaceNavigation({ sections, currentPath, actions, }) {
+    const [sectionIndex, setSectionIndex] = useState(() => sectionForPath(sections, currentPath));
+    const [query, setQuery] = useState('');
+    const [error, setError] = useState('');
+    useEffect(() => setSectionIndex(sectionForPath(sections, currentPath)), [sections, currentPath]);
+    const section = sections[sectionIndex];
+    const groups = section?.groups ?? [];
+    const run = (action) => {
+        if (!actions?.available(action))
+            return;
+        if (action.name.startsWith('delete-') &&
+            !window.confirm(`Delete ${action.leaf?.title ?? action.group?.title ?? action.section.title}? This action cannot be undone.`))
+            return;
+        setError('');
+        void Promise.resolve(actions.perform(action)).catch((reason) => setError(reason instanceof Error ? reason.message : 'Action failed.'));
+    };
+    const leafAction = (name, group, leaf) => ({ name, section: section, group, leaf });
+    const menuItems = (group, leaf, kind) => {
+        const Item = kind === 'context' ? ContextMenuItem : DropdownMenuItem;
+        const Separator = kind === 'context' ? ContextMenuSeparator : DropdownMenuSeparator;
+        return (_jsxs(_Fragment, { children: [_jsx(Item, { onSelect: () => window.open(leaf.href, '_blank', 'noopener,noreferrer'), children: "Open in new tab" }), _jsxs(Item, { onSelect: () => {
+                        void navigator.clipboard.writeText(new URL(leaf.href, window.location.href).href);
+                    }, children: [_jsx(Link, { className: "size-4" }), "Copy link"] }), _jsxs(Item, { onSelect: () => {
+                        sessionStorage.setItem('terra-docs:mode', 'attachments');
+                        window.location.assign(leaf.href);
+                    }, children: [_jsx(DocumentAttachment, { className: "size-4" }), "Attachments view"] }), actions &&
+                    [
+                        'move-leaf-up',
+                        'move-leaf-down',
+                        'move-leaf',
+                        'rename-leaf',
+                        'duplicate-leaf',
+                        'manage-attachments',
+                        'download-leaf',
+                        'delete-leaf',
+                    ]
+                        .filter((name) => actions.available(leafAction(name, group, leaf)))
+                        .map((name, index) => (_jsxs("span", { children: [index === 0 && _jsx(Separator, {}), _jsx(Item, { onSelect: () => run(leafAction(name, group, leaf)), children: name === 'move-leaf-up' ? ('Move up') : name === 'move-leaf-down' ? ('Move down') : name === 'move-leaf' ? ('Move to group') : name === 'rename-leaf' ? ('Rename page') : name === 'duplicate-leaf' ? ('Duplicate page') : name === 'manage-attachments' ? ('Manage attachments') : name === 'download-leaf' ? (_jsxs(_Fragment, { children: [_jsx(Download, { className: "size-4" }), "Download page"] })) : (_jsxs(_Fragment, { children: [_jsx(TrashCan, { className: "size-4" }), "Delete page"] })) })] }, name)))] }));
+    };
+    return (_jsxs("nav", { className: "terra-docs-workspace-nav", "aria-label": "Documentation", children: [_jsx("label", { className: "terra-docs-control-label", htmlFor: "terra-docs-section", children: "Section" }), _jsxs("div", { className: "terra-docs-workspace-section-select", children: [_jsxs(Select, { value: String(sectionIndex), onValueChange: (value) => {
+                            const index = Number(value);
+                            setSectionIndex(index);
+                            setQuery('');
+                            const href = sections[index] && firstLeaf(sections[index]);
+                            if (href)
+                                window.location.assign(href);
+                        }, children: [_jsx(SelectTrigger, { id: "terra-docs-section", "aria-label": "Section", children: _jsx(SelectValue, {}) }), _jsx(SelectContent, { children: sections.map((entry, index) => (_jsx(SelectItem, { value: String(index), children: entry.title }, `${entry.title}-${index}`))) })] }), section && actions && (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { variant: "ghost", size: "xs", "aria-label": `Actions for section ${section.title}`, children: _jsx(OverflowMenuVertical, { size: 16 }) }) }), _jsx(DropdownMenuContent, { children: ['rename-section', 'download-section', 'delete-section']
+                                    .filter((name) => actions.available({ name, section }))
+                                    .map((name) => (_jsx(DropdownMenuItem, { onSelect: () => run({ name, section }), children: name === 'rename-section'
+                                        ? 'Rename section'
+                                        : name === 'download-section'
+                                            ? 'Download section'
+                                            : 'Delete section' }, name))) })] }))] }), _jsx(Input, { "aria-label": "Search pages", placeholder: "Search pages", value: query, onChange: (event) => setQuery(event.currentTarget.value) }), error && _jsx("p", { role: "alert", children: error }), _jsx("div", { className: "terra-docs-workspace-groups", children: groups
+                    .filter((group) => !query ||
+                    group.title.toLowerCase().includes(query.toLowerCase()) ||
+                    group.leaves.some((leaf) => leaf.title.toLowerCase().includes(query.toLowerCase())))
+                    .map((group, index) => (_jsxs("div", { className: "terra-docs-workspace-group", children: [_jsxs("div", { className: "terra-docs-workspace-group-heading", children: [_jsx("h2", { children: group.title }), actions && (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { variant: "ghost", size: "xs", "aria-label": `Actions for group ${group.title}`, children: _jsx(OverflowMenuVertical, { size: 16 }) }) }), _jsx(DropdownMenuContent, { children: [
+                                                'create-leaf',
+                                                'move-group-up',
+                                                'move-group-down',
+                                                'rename-group',
+                                                'delete-group',
+                                            ]
+                                                .filter((name) => actions.available({ name, section: section, group }))
+                                                .map((name) => (_jsx(DropdownMenuItem, { onSelect: () => run({ name, section: section, group }), children: name === 'create-leaf'
+                                                    ? 'New page'
+                                                    : name === 'move-group-up'
+                                                        ? 'Move group up'
+                                                        : name === 'move-group-down'
+                                                            ? 'Move group down'
+                                                            : name === 'rename-group'
+                                                                ? 'Rename group'
+                                                                : 'Delete group' }, name))) })] }))] }), _jsx("ul", { children: group.leaves
+                                .filter((leaf) => !query ||
+                                group.title.toLowerCase().includes(query.toLowerCase()) ||
+                                leaf.title.toLowerCase().includes(query.toLowerCase()))
+                                .map((leaf, leafIndex) => (_jsxs("li", { children: [_jsxs(ContextMenu, { children: [_jsx(ContextMenuTrigger, { asChild: true, children: _jsx("a", { href: leaf.href, "aria-current": leaf.href === currentPath ? 'page' : undefined, children: leaf.title }) }), _jsx(ContextMenuContent, { children: menuItems(group, leaf, 'context') })] }), _jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { variant: "ghost", size: "xs", "aria-label": `Actions for ${leaf.title}`, children: _jsx(OverflowMenuVertical, { size: 16 }) }) }), _jsx(DropdownMenuContent, { children: menuItems(group, leaf, 'dropdown') })] })] }, `${leaf.href}-${leafIndex}`))) })] }, `${group.title}-${index}`))) }), groups.length === 0 && _jsx("p", { className: "terra-docs-empty", children: "No pages in this section." })] }));
+}
+export function DocsWorkspaceToolbar({ attachments = [], capabilities = {}, onEdit, onSave, onHistory, onPublish, remoteProvider, onModeChange, }) {
+    const [mode, setMode] = useState('view');
+    const [attachmentFilter, setAttachmentFilter] = useState('All');
+    const attachmentTypes = [...new Set(attachments.map(attachmentKind))];
+    useEffect(() => {
+        const requested = sessionStorage.getItem('terra-docs:mode');
+        if (requested === 'attachments') {
+            setMode('attachments');
+            onModeChange?.('attachments');
+            sessionStorage.removeItem('terra-docs:mode');
+        }
+    }, [onModeChange]);
+    useEffect(() => {
+        const element = document.querySelector('.terra-docs-site');
+        if (element)
+            element.dataset.docsMode = mode;
+        return () => {
+            if (element)
+                delete element.dataset.docsMode;
+        };
+    }, [mode]);
+    return (_jsxs("div", { className: "terra-docs-workspace-toolbar", role: "toolbar", "aria-label": "Document controls", "data-can-edit": Boolean(capabilities.edit && remoteProvider), children: [_jsxs(Select, { size: "xs", value: mode, onValueChange: (value) => {
+                    const next = value;
+                    setMode(next);
+                    onModeChange?.(next);
+                    if (next === 'edit')
+                        onEdit?.();
+                }, children: [_jsx(SelectTrigger, { "aria-label": "Mode", children: _jsx(SelectValue, {}) }), _jsxs(SelectContent, { children: [_jsx(SelectItem, { value: "view", children: "View" }), capabilities.edit && remoteProvider && _jsx(SelectItem, { value: "edit", children: "Edit" }), _jsx(SelectItem, { value: "attachments", children: "Attachments" })] })] }), mode === 'attachments' && attachmentTypes.length > 1 && (_jsx(ToggleGroup, { type: "single", value: attachmentFilter, onValueChange: (value) => {
+                    const next = value || 'All';
+                    setAttachmentFilter(next);
+                    window.dispatchEvent(new CustomEvent('terra-docs:attachment-filter', { detail: next }));
+                }, "aria-label": "Filter attachments", children: ['All', ...attachmentTypes].map((kind) => (_jsx(ToggleGroupItem, { value: kind, size: "sm", children: kind }, kind))) })), mode === 'edit' && capabilities.save && (_jsx(Button, { type: "button", size: "xs", onClick: onSave, children: "Save" })), mode === 'edit' && capabilities.history && (_jsx(Button, { type: "button", size: "xs", variant: "ghost", onClick: onHistory, children: "History" })), mode === 'edit' && capabilities.publish && (_jsx(Button, { type: "button", size: "xs", variant: "tonal", onClick: onPublish, children: "Publish" }))] }));
+}
+export function DocsAttachmentsView({ attachments = [], onUpload, }) {
+    const [filter, setFilter] = useState('All');
+    useEffect(() => {
+        const update = (event) => setFilter(event.detail);
+        window.addEventListener('terra-docs:attachment-filter', update);
+        return () => window.removeEventListener('terra-docs:attachment-filter', update);
+    }, []);
+    const visible = filter === 'All'
+        ? attachments
+        : attachments.filter((attachment) => attachmentKind(attachment) === filter);
+    return (_jsxs("section", { className: "terra-docs-attachments-view", "aria-label": "Attachments", children: [_jsx("h2", { children: "Attachments" }), onUpload && (_jsxs("label", { className: "terra-docs-attachment-upload", children: ["Add attachment", ' ', _jsx("input", { type: "file", onChange: (event) => {
+                            const file = event.currentTarget.files?.[0];
+                            if (file)
+                                void onUpload(file);
+                            event.currentTarget.value = '';
+                        } })] })), visible.length ? (_jsx("ul", { children: visible.map((attachment, index) => (_jsxs("li", { children: [_jsx("a", { href: attachment.href, target: "_blank", rel: "noopener noreferrer", children: attachment.title }), attachment.type && _jsx("span", { children: attachment.type })] }, `${attachment.href}-${index}`))) })) : (_jsx("p", { children: "No attachments found." }))] }));
+}
+//# sourceMappingURL=workspace.js.map

package/lib-dist/workspace.js.map

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

package/package.json

@@ -1,6 +1,93 @@
 {
   "name": "@terra-symposium/docs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.17",
+  "description": "Reusable React document editor and viewer.",
+  "repository": "https://github.com/Terra-Symposium/docs",
+  "type": "module",
+  "engines": {
+    "node": ">=24.12.0"
+  },
+  "files": [
+    "lib-dist",
+    "src/style.css",
+    "src/navigation.tsx",
+    "src/SiteLayout.astro"
+  ],
+  "exports": {
+    ".": {
+      "types": "./lib-dist/index.d.ts",
+      "import": "./lib-dist/index.js"
+    },
+    "./style.css": "./lib-dist/style.css",
+    "./site-layout.astro": "./src/SiteLayout.astro"
+  },
+  "peerDependencies": {
+    "@terra-symposium/styling": "^0.1.6",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@astrojs/react": "^7.1.0",
+    "@eslint/js": "10.0.1",
+    "@playwright/test": "^1.64.1",
+    "@types/katex": "^0.16.8",
+    "@types/node": "^24.19.2",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "@terra-symposium/styling": "file:vendor/terra-symposium-styling-0.1.6.tgz",
+    "@types/sanitize-html": "^2.16.2",
+    "tailwindcss": "^3.4.3",
+    "@vitejs/plugin-react": "6.1.2",
+    "astro": "^7.4.2",
+    "eslint": "10.13.0",
+    "prettier": "3.9.10",
+    "react": "19.3.1",
+    "react-dom": "19.3.1",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.71.2",
+    "vite": "8.3.4"
+  },
+  "dependencies": {
+    "@carbon/icons-react": "11.90.0",
+    "@codemirror/commands": "^6.10.0",
+    "@codemirror/lang-markdown": "^6.1.3",
+    "@codemirror/language": "^6.11.3",
+    "@codemirror/language-data": "^6.5.1",
+    "@codemirror/state": "^6.5.2",
+    "@codemirror/theme-one-dark": "^6.1.3",
+    "@codemirror/view": "^6.39.4",
+    "@dagrejs/dagre": "^1.1.4",
+    "@lexical/rich-text": "^0.35.0",
+    "@portabletext/editor": "7.9.0",
+    "@radix-ui/react-popover": "^1.1.15",
+    "@radix-ui/react-select": "2.4.1",
+    "@uiw/codemirror-theme-github": "^4.25.9",
+    "@xyflow/react": "^12.3.6",
+    "katex": "^0.19.1",
+    "lexical": "^0.35.0",
+    "marked": "^18.1.1",
+    "nanostores": "^1.3.0",
+    "pdf-lib": "^1.17.1",
+    "sanitize-html": "^2.18.1",
+    "sonner": "^1.4.41",
+    "jszip": "^3.10.1",
+    "yaml": "^2.7.0"
+  },
+  "license": "Apache-2.0",
+  "scripts": {
+    "dev": "vite --host 127.0.0.1 --open",
+    "docs:dev": "astro dev --host 127.0.0.1 --open",
+    "docs:build": "pnpm build && astro build",
+    "docs:preview": "astro preview --host 127.0.0.1",
+    "dev:library": "tsc --watch",
+    "build": "tsc && tailwindcss -c tailwind.docs.config.mjs -i src/style.css -o lib-dist/docs-style.css --minify && node scripts/copy-runtime.mjs",
+    "build:demo": "vite build",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.demo.json",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check": "pnpm run format:check && pnpm run lint && pnpm run typecheck",
+    "test": "pnpm build && node --test test/*.test.mjs",
+    "test:browser": "pnpm docs:build && playwright test"
+  }
 }

package/src/SiteLayout.astro

@@ -0,0 +1,38 @@
+---
+import { DocsStaticWorkspace } from '../lib-dist/StaticWorkspace.js';
+import '../lib-dist/style.css';
+import type { DocsAttachment, DocsSection, DocsNavNode } from '../lib-dist/index.js';
+
+type Props = {
+	title: string;
+	homeHref?: string;
+	description?: string;
+	pageTitle?: string;
+	nodes?: DocsNavNode[];
+	sections?: DocsSection[];
+	currentPath: string;
+	rootPath?: string;
+	markdown?: string;
+	content?: unknown;
+	attachments?: DocsAttachment[];
+	updatedAt?: string;
+};
+
+const { title, homeHref = '/', description, pageTitle, nodes = [], sections, currentPath, rootPath = '/', markdown = '', content, attachments = [], updatedAt } = Astro.props;
+---
+
+<DocsStaticWorkspace
+	client:load
+	title={title}
+	homeHref={homeHref}
+	description={description}
+	pageTitle={pageTitle}
+	nodes={nodes}
+	sections={sections}
+	currentPath={currentPath}
+	rootPath={rootPath}
+	markdown={markdown}
+	content={content}
+	attachments={attachments}
+	updatedAt={updatedAt}
+/>

package/src/navigation.tsx

@@ -0,0 +1,47 @@
+import { colors } from '@terra-symposium/styling';
+import type { CSSProperties, JSX } from 'react';
+
+export type DocsNavNode = {
+  id?: string;
+  path?: string;
+  title: string;
+  href?: string;
+  description?: string;
+  updatedAt?: string;
+  attachments?: import('./workspace.js').DocsAttachment[];
+  children?: DocsNavNode[];
+};
+
+export function DocsNavigation({
+  nodes,
+  currentPath,
+  hue = 210,
+}: {
+  nodes: DocsNavNode[];
+  currentPath: string;
+  hue?: number | null;
+}): JSX.Element {
+  const [accent] = colors(hue);
+  const style = { '--docs-accent': `rgb(${accent.light[8]})` } as CSSProperties;
+  const render = (items: DocsNavNode[]): JSX.Element => (
+    <ul className="terra-docs-nav-list">
+      {items.map((node, index) => (
+        <li key={`${node.href ?? node.title}-${index}`}>
+          {node.href ? (
+            <a href={node.href} aria-current={node.href === currentPath ? 'page' : undefined}>
+              {node.title}
+            </a>
+          ) : (
+            <span>{node.title}</span>
+          )}
+          {node.children?.length ? render(node.children) : null}
+        </li>
+      ))}
+    </ul>
+  );
+  return (
+    <nav className="terra-docs-nav" aria-label="Documentation" style={style}>
+      {render(nodes)}
+    </nav>
+  );
+}