mordoc 0.1.13 → 1.0.0

package/src/app/skeleton/Skeleton.tsx

@@ -0,0 +1,75 @@
+/**
+ * Skeleton loading screen shown during SPA navigations.
+ *
+ * Mirrors the article-column layout (same max-width, padding, grid structure
+ * as Content.tsx) so the transition feels continuous rather than jarring.
+ * Rendered by App.tsx when useNavigation().state === 'loading'.
+ *
+ * Each Block is a shimmer pill whose width and height are supplied as inline
+ * styles. The shimmer animation is driven purely by CSS — no JS timers.
+ */
+
+import styles from './Skeleton.module.css';
+
+function Block({ width = '100%', height = '1rem' }: { width?: string; height?: string }) {
+  return <div className={styles.block} style={{ width, height }} aria-hidden="true" />;
+}
+
+export function Skeleton() {
+  return (
+    <div className={styles.page} aria-busy="true" aria-label="Loading page">
+      <div className={styles.articleArea}>
+        <div className={styles.article}>
+
+          {/* Breadcrumb stub */}
+          <div className={styles.breadcrumbRow}>
+            <Block width="8rem" height="0.75rem" />
+          </div>
+
+          {/* Article header: title, description lines, meta row */}
+          <div className={styles.header}>
+            <Block width="62%" height="2.5rem" />
+            <div className={styles.headerDesc}>
+              <Block width="85%" height="1rem" />
+              <Block width="58%" height="1rem" />
+            </div>
+            <Block width="5rem" height="0.7rem" />
+          </div>
+
+          {/* Prose body: paragraph groups + a heading break */}
+          <div className={styles.prose}>
+            <div className={styles.paraGroup}>
+              <Block width="100%" />
+              <Block width="96%" />
+              <Block width="88%" />
+              <Block width="72%" />
+            </div>
+
+            <div className={styles.paraGroup}>
+              <Block width="100%" />
+              <Block width="93%" />
+              <Block width="81%" />
+            </div>
+
+            <div className={styles.heading}>
+              <Block width="42%" height="1.5rem" />
+            </div>
+
+            <div className={styles.paraGroup}>
+              <Block width="100%" />
+              <Block width="97%" />
+              <Block width="89%" />
+              <Block width="64%" />
+            </div>
+
+            <div className={styles.paraGroup}>
+              <Block width="100%" />
+              <Block width="76%" />
+            </div>
+          </div>
+
+        </div>
+      </div>
+    </div>
+  );
+}

package/src/app/toc/Toc.module.css

@@ -0,0 +1,59 @@
+.toc {
+  /* positioning handled by .tocAside in Content.module.css */
+}
+
+.heading {
+  margin: 0 0 16px;
+  font-size: 14px;
+  font-weight: 600;
+  color: var(--color-fg);
+}
+
+.list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.item {
+  margin: 0;
+}
+
+/* Base link — H2 level (no extra indent) */
+.link {
+  display: block;
+  padding: 0.25rem 0;
+  padding-left: 12px;
+  color: var(--color-fg-muted);
+  text-decoration: none;
+  font-size: 14px;
+  font-weight: 400;
+  line-height: 1.5;
+  border-left: 2px solid transparent;
+  transition: color 200ms ease;
+  cursor: pointer;
+  width: 100%;
+  text-align: left;
+}
+
+/* Indentation by heading level */
+.link[data-level="3"] { padding-left: 28px; }
+.link[data-level="4"] { padding-left: 36px; }
+.link[data-level="5"] { padding-left: 44px; }
+.link[data-level="6"] { padding-left: 52px; }
+
+.link:hover {
+  color: var(--accent-emphasis);
+}
+
+.link:focus-visible {
+  outline: 2px solid var(--accent-emphasis);
+  outline-offset: 2px;
+  border-radius: 2px;
+}
+
+.link.active {
+  color: var(--accent-emphasis);
+  font-weight: 500;
+  border-left-color: var(--accent-emphasis);
+}

package/src/app/toc/Toc.tsx

@@ -0,0 +1,77 @@
+import React, { useEffect, useRef, useState } from 'react';
+import type { TocEntry } from '../../types/content.js';
+import styles from './Toc.module.css';
+
+interface TocProps {
+  items: TocEntry[];
+}
+
+export function Toc({ items }: TocProps) {
+  const [activeId, setActiveId] = useState<string | null>(null);
+  const observerRef = useRef<IntersectionObserver | null>(null);
+
+  useEffect(() => {
+    if (items.length === 0) return;
+
+    observerRef.current?.disconnect();
+
+    const headingIds = items.map((item) => item.id);
+    const headerHeight = document.querySelector('header')?.offsetHeight ?? 64;
+
+    observerRef.current = new IntersectionObserver(
+      (entries) => {
+        for (const entry of entries) {
+          if (entry.isIntersecting) {
+            setActiveId(entry.target.id);
+            break;
+          }
+        }
+      },
+      {
+        rootMargin: `-${headerHeight + 16}px 0px -80% 0px`,
+        threshold: 0,
+      },
+    );
+
+    for (const id of headingIds) {
+      const el = document.getElementById(id);
+      if (el) observerRef.current.observe(el);
+    }
+
+    return () => {
+      observerRef.current?.disconnect();
+    };
+  }, [items]);
+
+  function handleClick(e: React.MouseEvent<HTMLAnchorElement>, id: string) {
+    e.preventDefault();
+    const el = document.getElementById(id);
+    if (!el) return;
+    // scroll-margin-top on headings (Content.module.css) accounts for the sticky
+    // header height via --header-total, so scrollIntoView gives the correct offset.
+    el.scrollIntoView({ behavior: 'smooth', block: 'start' });
+    history.pushState(null, '', `#${id}`);
+  }
+
+  if (items.length === 0) return null;
+
+  return (
+    <nav className={styles.toc} aria-label="On this page">
+      <p className={styles.heading}>On this page</p>
+      <ul className={styles.list}>
+        {items.map((entry) => (
+          <li key={entry.id} className={styles.item}>
+            <a
+              href={`#${entry.id}`}
+              data-level={entry.level}
+              className={`${styles.link} ${activeId === entry.id ? styles.active : ''}`}
+              onClick={(e) => handleClick(e, entry.id)}
+            >
+              {entry.title}
+            </a>
+          </li>
+        ))}
+      </ul>
+    </nav>
+  );
+}

package/src/app/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "//": "TypeScript config for the browser-facing React app. Separate from the root tsconfig because the app ships as source (Vite compiles it at the user's dev/build time) rather than being emitted into dist/. This config exists purely for IDE type-checking and emits nothing. Located inside src/app/ so the TS language server auto-discovers it as the nearest tsconfig for every app file.",
+
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "isolatedModules": true,
+    "types": []
+  },
+  "include": ["**/*", "../types/**/*"]
+}

package/src/app/virtual-modules.d.ts

@@ -0,0 +1,74 @@
+// Type declarations for the virtual modules exposed by mordoc's Vite plugin.
+// These files don't exist on disk — the plugin generates their contents at
+// import time. These declarations let the client code import them with full
+// type safety despite the "virtual:" prefix.
+//
+// Kept in sync with EAGER_VIRTUAL_IDS in src/vite/plugin.ts.
+//
+// Uses inline `import()` type expressions rather than top-level `import type`
+// statements, because:
+//   1. TS forbids relative imports inside `declare module 'x' { ... }` blocks.
+//   2. Hoisting imports to file scope would make this file a module, and
+//      module-scope `declare module` declarations only register globally if
+//      the containing file is imported elsewhere. Staying fully ambient (no
+//      top-level imports) keeps the declarations globally available to every
+//      file in the project without ceremony.
+
+declare module 'virtual:mordoc/site' {
+  const value: import('../types/site.js').SiteConfig;
+  export default value;
+}
+
+declare module 'virtual:mordoc/language' {
+  const value: import('../types/language.js').LanguageConfig | null;
+  export default value;
+}
+
+declare module 'virtual:mordoc/navigation' {
+  const value: import('../types/pipeline.js').NavigationConfig;
+  export default value;
+}
+
+declare module 'virtual:mordoc/assets' {
+  const value: import('../types/assets.js').ResolvedAssets;
+  export default value;
+}
+
+declare module 'virtual:mordoc/pages-index' {
+  const value: import('../types/content.js').PageMeta[];
+  export default value;
+}
+
+declare module 'virtual:mordoc/page-loaders' {
+  // A record keyed by routePath, each value a function that dynamically
+  // imports the matching lazy page module. The plugin emits a literal
+  // `import()` expression per route so Vite can statically code-split.
+  const value: Record<
+    string,
+    () => Promise<{ default: import('../types/content.js').PageData }>
+  >;
+  export default value;
+}
+
+declare module 'virtual:mordoc/translations' {
+  // Outer key: language code (e.g. "de"). Inner key: default (English) label.
+  // Value: translated label. Empty for single-language projects.
+  const value: Record<string, Record<string, string>>;
+  export default value;
+}
+
+// CSS-only side-effect import; resolves to config/theme.css when present.
+declare module 'virtual:mordoc/theme' {}
+
+// Wildcard declaration for per-route lazy page modules.
+//
+// Every specifier of the form `virtual:mordoc/page/<routePath>` resolves
+// to a module whose default export is the page's full `PageData` payload.
+// TypeScript accepts any path after the prefix here; the plugin throws at
+// runtime if the routePath doesn't exist. In practice, specifiers are
+// only ever produced by the static `page-loaders` map, which enumerates
+// known routes, so invalid specifiers shouldn't occur.
+declare module 'virtual:mordoc/page/*' {
+  const value: import('../types/content.js').PageData;
+  export default value;
+}

package/dist/assets/fonts/inter/OFL.txt

@@ -1,93 +0,0 @@
-Copyright 2020 The Inter Project Authors (https://github.com/rsms/inter)
-
-This Font Software is licensed under the SIL Open Font License, Version 1.1.
-This license is copied below, and is also available with a FAQ at:
-https://openfontlicense.org
-
-
------------------------------------------------------------
-SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
------------------------------------------------------------
-
-PREAMBLE
-The goals of the Open Font License (OFL) are to stimulate worldwide
-development of collaborative font projects, to support the font creation
-efforts of academic and linguistic communities, and to provide a free and
-open framework in which fonts may be shared and improved in partnership
-with others.
-
-The OFL allows the licensed fonts to be used, studied, modified and
-redistributed freely as long as they are not sold by themselves. The
-fonts, including any derivative works, can be bundled, embedded, 
-redistributed and/or sold with any software provided that any reserved
-names are not used by derivative works. The fonts and derivatives,
-however, cannot be released under any other type of license. The
-requirement for fonts to remain under this license does not apply
-to any document created using the fonts or their derivatives.
-
-DEFINITIONS
-"Font Software" refers to the set of files released by the Copyright
-Holder(s) under this license and clearly marked as such. This may
-include source files, build scripts and documentation.
-
-"Reserved Font Name" refers to any names specified as such after the
-copyright statement(s).
-
-"Original Version" refers to the collection of Font Software components as
-distributed by the Copyright Holder(s).
-
-"Modified Version" refers to any derivative made by adding to, deleting,
-or substituting -- in part or in whole -- any of the components of the
-Original Version, by changing formats or by porting the Font Software to a
-new environment.
-
-"Author" refers to any designer, engineer, programmer, technical
-writer or other person who contributed to the Font Software.
-
-PERMISSION & CONDITIONS
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of the Font Software, to use, study, copy, merge, embed, modify,
-redistribute, and sell modified and unmodified copies of the Font
-Software, subject to the following conditions:
-
-1) Neither the Font Software nor any of its individual components,
-in Original or Modified Versions, may be sold by itself.
-
-2) Original or Modified Versions of the Font Software may be bundled,
-redistributed and/or sold with any software, provided that each copy
-contains the above copyright notice and this license. These can be
-included either as stand-alone text files, human-readable headers or
-in the appropriate machine-readable metadata fields within text or
-binary files as long as those fields can be easily viewed by the user.
-
-3) No Modified Version of the Font Software may use the Reserved Font
-Name(s) unless explicit written permission is granted by the corresponding
-Copyright Holder. This restriction only applies to the primary font name as
-presented to the users.
-
-4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
-Software shall not be used to promote, endorse or advertise any
-Modified Version, except to acknowledge the contribution(s) of the
-Copyright Holder(s) and the Author(s) or with their explicit written
-permission.
-
-5) The Font Software, modified or unmodified, in part or in whole,
-must be distributed entirely under this license, and must not be
-distributed under any other license. The requirement for fonts to
-remain under this license does not apply to any document created
-using the Font Software.
-
-TERMINATION
-This license becomes null and void if any of the above conditions are
-not met.
-
-DISCLAIMER
-THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
-OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
-COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
-DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
-OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/build/Builder.d.ts

@@ -1,92 +0,0 @@
-/**
- * Builder - Main build orchestrator for Mordoc
- * Coordinates the entire static site generation process
- */
-export interface BuilderOptions {
-    projectRoot: string;
-    outputDir?: string;
-    clean?: boolean;
-    includeDrafts?: boolean;
-    verbose?: boolean;
-}
-export declare class Builder {
-    private projectRoot;
-    private outputDir;
-    private contentDir;
-    private configDir;
-    private publicDir;
-    private clean;
-    private includeDrafts;
-    private verbose;
-    constructor(options: BuilderOptions);
-    /**
-     * Execute the complete build process
-     */
-    build(): Promise<void>;
-    /**
-     * Load site configuration
-     */
-    private loadConfig;
-    /**
-     * Load and process all content files
-     */
-    private loadAndProcessContent;
-    /**
-     * Generate static HTML pages for all content
-     */
-    private generateHtmlPages;
-    /**
-     * Write HTML file for a content page
-     */
-    private writeHtmlFile;
-    /**
-     * Generate JSON data files for SPA navigation
-     */
-    private generateContentDataFiles;
-    /**
-     * Generate theme CSS and component styles
-     */
-    private generateThemeCSS;
-    /**
-     * Bundle client React application
-     */
-    private bundleClientApp;
-    /**
-     * Copy static assets (logo, favicon, public/ folder, and MORDOC fonts)
-     */
-    private copyStaticAssets;
-    /**
-     * Copy MORDOC's built-in assets (fonts, etc.)
-     * Uses pre-copied assets from dist/ in installed package
-     */
-    private copyMordocAssets;
-    /**
-     * Generate client configuration JSON
-     */
-    private generateClientConfig;
-    /**
-     * Generate search index using Pagefind
-     */
-    private generateSearchIndex;
-    /**
-     * Clean output directory
-     */
-    private cleanOutputDir;
-    /**
-     * Ensure output directory exists
-     */
-    private ensureOutputDir;
-    /**
-     * Copy directory recursively
-     */
-    private copyDirectory;
-    /**
-     * Log message if verbose mode is enabled
-     */
-    private log;
-    /**
-     * Print build statistics
-     */
-    private printBuildStats;
-}
-//# sourceMappingURL=Builder.d.ts.map

package/dist/build/Builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Builder.d.ts","sourceRoot":"","sources":["../../src/build/Builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,EAAE,cAAc;IAWnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2D5B;;OAEG;YACW,UAAU;IAKxB;;OAEG;YACW,qBAAqB;IAkBnC;;OAEG;YACW,iBAAiB;IAsB/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAyBrB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAyDhC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;YACW,eAAe;IAc7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwCxB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;OAEG;YACW,mBAAmB;IAmBjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,GAAG;IAOX;;OAEG;IACH,OAAO,CAAC,eAAe;CAmBxB"}