@terra-symposium/docs 0.0.0-stage → 0.1.71

package/package.json

@@ -1,6 +1,111 @@
 {
   "name": "@terra-symposium/docs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.71",
+  "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/components/navigation.tsx",
+    "src/components/SiteLayout.astro",
+    "src/components/NotFound.astro",
+    "src/components/NotFound.tsx"
+  ],
+  "exports": {
+    ".": {
+      "types": "./lib-dist/lib/index.d.ts",
+      "import": "./lib-dist/lib/index.js"
+    },
+    "./style.css": "./lib-dist/style.css",
+    "./astro": {
+      "types": "./lib-dist/lib/astro.d.ts",
+      "import": "./lib-dist/lib/astro.js"
+    },
+    "./local-workspace": {
+      "types": "./lib-dist/components/LocalDocsWorkspace.d.ts",
+      "import": "./lib-dist/components/LocalDocsWorkspace.js"
+    },
+    "./site-layout.astro": "./src/components/SiteLayout.astro",
+    "./not-found.astro": "./src/components/NotFound.astro"
+  },
+  "peerDependencies": {
+    "@terra-symposium/styling": "^0.1.24",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@astrojs/react": "^7.1.0",
+    "@changesets/cli": "^3.0.3",
+    "@eslint/js": "10.0.1",
+    "@playwright/test": "^1.64.1",
+    "@terra-symposium/styling": "file:vendor/terra-symposium-styling-parity-0.1.34.tgz",
+    "@types/katex": "^0.16.8",
+    "@types/node": "^24.19.2",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "@types/sanitize-html": "^2.16.2",
+    "@terra-symposium/standards-quality": "file:vendor/terra-symposium-standards-quality-2.1.0.tgz",
+    "@vitejs/plugin-react": "6.1.2",
+    "astro": "^7.4.2",
+    "eslint": "10.13.0",
+    "husky": "^9.1.7",
+    "postcss": "8.5.31",
+    "postcss-import": "15.1.0",
+    "prettier": "3.9.10",
+    "react": "19.3.1",
+    "react-dom": "19.3.1",
+    "tailwindcss": "^3.4.3",
+    "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",
+    "jszip": "^3.10.1",
+    "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",
+    "yaml": "^2.7.0"
+  },
+  "license": "Apache-2.0",
+  "scripts": {
+    "dev": "terra-quality-dev -- vite --host 127.0.0.1 --open",
+    "docs:dev": "pnpm build && terra-quality-dev --port 4311 -- astro dev --host 127.0.0.1 --open",
+    "docs:build": "pnpm build && astro build",
+    "docs:preview": "pnpm docs:build && astro preview --host 127.0.0.1",
+    "dev:library": "tsc --watch",
+    "build": "rm -rf lib-dist && tsc && tailwindcss --postcss tailwind.postcss.config.cjs -c tailwind.docs.config.mjs -i src/styles/style.css -o lib-dist/style.css --minify && tailwindcss --postcss tailwind.postcss.config.cjs -c tailwind.docs.config.mjs -i src/styles/workspace.css -o lib-dist/workspace.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 && node scripts/acquire-playwright-port.mjs && playwright test",
+    "test:consumer": "playwright test --config=playwright.consumer.config.ts",
+    "changeset": "changeset",
+    "version-packages": "changeset version"
+  }
 }

package/src/components/NotFound.astro

@@ -0,0 +1,6 @@
+---
+import { DocsNotFound } from './NotFound.tsx';
+import '../../lib-dist/style.css';
+---
+
+<DocsNotFound {...Astro.props} />

package/src/components/NotFound.tsx

@@ -0,0 +1,48 @@
+import type { JSX } from 'react';
+import {
+  Badge,
+  ButtonLink,
+  Card,
+  CardContent,
+  CardDescription,
+  CardFooter,
+  CardHeader,
+  CardHeading,
+} from '@terra-symposium/styling/ui/terra-original';
+
+export type DocsNotFoundProps = {
+  appName?: string;
+  homeHref?: string;
+  description?: string;
+};
+
+export function DocsNotFound({
+  appName = 'Terra Docs',
+  homeHref = '/',
+  description = 'The page may have moved, or the link may be out of date.',
+}: DocsNotFoundProps): JSX.Element {
+  return (
+    <div className="docs-theme-scope">
+      <main className="terra-docs-workspace flex items-center justify-center bg-background px-5 text-primary-12">
+        <Card variant="primary-outline" size="sm" className="w-full text-center sm:max-w-lg">
+          <CardHeader className="items-center text-center">
+            <Badge variant="destructive" size="sm" rounded="md" aria-label="Error 404">
+              404
+            </Badge>
+            <CardHeading as="h1" className="font-serif text-4xl italic tracking-tight">
+              Page not found
+            </CardHeading>
+          </CardHeader>
+          <CardContent className="text-center">
+            <CardDescription className="text-base leading-relaxed">{description}</CardDescription>
+          </CardContent>
+          <CardFooter className="justify-center">
+            <ButtonLink href={homeHref} variant="primary-tonal" size="sm">
+              Return to {appName}
+            </ButtonLink>
+          </CardFooter>
+        </Card>
+      </main>
+    </div>
+  );
+}

package/src/components/SiteLayout.astro

@@ -0,0 +1,42 @@
+---
+import { DocsStaticWorkspace } from '../../lib-dist/components/StaticWorkspace.js';
+import '../../lib-dist/style.css';
+import type { DocsAttachment, DocsSection, DocsNavNode } from '../../lib-dist/lib/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;
+const staticContent = Astro.slots.has('default');
+---
+
+<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}
+	staticContent={staticContent}
+>
+	<slot />
+</DocsStaticWorkspace>

package/src/components/navigation.tsx

@@ -0,0 +1,48 @@
+import { colors } from '@terra-symposium/styling';
+import type { DocsAttachment } from '../lib/workspace-types.js';
+import type { CSSProperties, JSX } from 'react';
+
+export type DocsNavNode = {
+  id?: string;
+  path?: string;
+  title: string;
+  href?: string;
+  description?: string;
+  updatedAt?: string;
+  attachments?: 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>
+  );
+}