@rse/specbook 0.9.5 → 0.9.6

package/dst/specbook-export-common.d.ts

@@ -1,13 +1,14 @@
-import type { Specification, Object as SpecObject } from "./specbook-struct-spec.js";
+import type { Spec, SpecObject } from "./specbook-format-spec.js";
 export declare const escapeHtml: (text: string) => string;
 export declare const stylesheet: () => string;
 export declare const searchScript: () => string;
-export declare const fallbackLogo: () => string;
+export declare const fallbackLogo: (theme: string) => string;
 export declare const isTitleObject: (object: SpecObject) => boolean;
-export declare const documentLang: (specification: Specification) => string | undefined;
-export declare const documentCharset: (specification: Specification) => string | undefined;
-export declare const documentThemeStyle: (specification: Specification) => string | undefined;
-export declare const documentThemeTone: (specification: Specification) => string | undefined;
+export declare const titleObject: (specification: Spec) => SpecObject | undefined;
+export declare const documentLang: (specification: Spec) => string | undefined;
+export declare const documentCharset: (specification: Spec) => string | undefined;
+export declare const documentThemeStyle: (specification: Spec) => string | undefined;
+export declare const documentThemeTone: (specification: Spec) => string | undefined;
 export type PaperSetup = {
     unit: "mm" | "in";
     height: number;
@@ -21,12 +22,12 @@ export type PaperSetup = {
 export declare const paperSizeDefault = "A4";
 export declare const paperSetup: (paper: string) => PaperSetup;
 export declare const paperLength: (setup: PaperSetup, value: number) => string;
-export declare const documentPaperSize: (specification: Specification) => string;
+export declare const documentPaperSize: (specification: Spec) => string;
 export declare const paperStylesheet: (paper: string) => string;
 export declare const charsetCodepoints: (charset: string) => number[] | undefined;
 export declare const subsetStylesheet: (charset?: string) => Promise<string>;
-export declare const documentTitle: (specification: Specification) => {
+export declare const documentTitle: (specification: Spec) => {
     title: string;
     subtitle?: string;
 };
-export declare const documentLogo: (specification: Specification) => string;
+export declare const documentLogo: (specification: Spec) => string;

package/dst/specbook-export-common.js

@@ -14,13 +14,26 @@ export const escapeHtml = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&
 export const stylesheet = () => fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), "specbook-export-html.css"), "utf8");
 /*  provide the build-time bundled client-side fuzzy search script  */
 export const searchScript = () => fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), "specbook-export-html-search.js"), "utf8");
-/*  provide the build-time bundled fallback logo of SpecBook itself
-    (as a self-contained data: URL, to keep its styles isolated)  */
-export const fallbackLogo = () => "data:image/svg+xml;base64," + fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), "specbook-export-logo.svg")).toString("base64");
+/*  provide a theme variant of the build-time bundled fallback logo of
+    SpecBook itself (as a self-contained data: URL, to keep its styles isolated)  */
+export const fallbackLogo = (theme) => "data:image/svg+xml;base64," + fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), `specbook-export-logo-${theme}.svg`)).toString("base64");
 /*  check whether an object is the specification title object  */
 export const isTitleObject = (object) => object.kind === "META" && object.name.toUpperCase() === "TITLE";
-/*  determine the title object of the specification  */
-const titleObject = (specification) => specification.artifacts.flatMap((artifact) => artifact.objects).find(isTitleObject);
+/*  determine the title object of the specification, searched at any
+    nesting level in document order, where the first match wins  */
+export const titleObject = (specification) => {
+    const search = (objects) => {
+        for (const object of objects) {
+            if (isTitleObject(object))
+                return object;
+            const found = search(object.childs);
+            if (found !== undefined)
+                return found;
+        }
+        return undefined;
+    };
+    return search(specification.artifacts.flatMap((artifact) => artifact.objects));
+};
 /*  determine a property value of the title object  */
 const titleProperty = (specification, name) => titleObject(specification)?.properties.find((property) => property.key === name)?.value;
 /*  determine the document language (LANG) from the title object  */
@@ -142,14 +155,15 @@ export const documentTitle = (specification) => ({
     subtitle: titleProperty(specification, "SUBTITLE")
 });
 /*  determine the document logo as a self-contained data: URL, taken from the
-    embedded image of the LOGO property of the title object, and falling back
-    onto the built-in SpecBook logo (for use in isolated rendering contexts,
-    like the print header/footer, which load no external resources)  */
+    first embedded image of the LOGO property of the title object -- the light
+    variant of a "{theme}" reference -- and falling back onto the built-in
+    SpecBook logo (for use in isolated rendering contexts, like the print
+    header/footer, which load no external resources and are always light)  */
 export const documentLogo = (specification) => {
     const content = titleObject(specification)
         ?.properties.find((property) => property.key === "LOGO")?.embedding?.[0];
     if (content === undefined)
-        return fallbackLogo();
+        return fallbackLogo("light");
     return content.startsWith("data:") ? content :
         `data:image/svg+xml;base64,${Buffer.from(content, "utf8").toString("base64")}`;
 };

package/dst/specbook-export-html.css

@@ -94,7 +94,7 @@ html.theme-dark             { --theme-color-specbook-background:  var(--theme-co
                               --gradia-color-group-name:          var(--theme-color-accent-15);
                               --gradia-color-group-box:           var(--theme-color-accent-1);
                               --gradia-color-group-border:        var(--theme-color-accent-7);
-                              --gradia-color-edge-line:           var(--theme-color-base-16);
+                              --gradia-color-edge-line:           var(--theme-color-base-20);
                               --gradia-color-edge-name:           var(--theme-color-base-29);
                               --gradia-color-edge-arity:          var(--theme-color-base-29);
                               --gradia-color-edge-halo:           var(--theme-color-specbook-background); }
@@ -222,13 +222,24 @@ div.description li          { margin: 0.1rem 0; }
 div.embedding               { margin: 0.5rem 0; }
 div.embedding img,
 div.embedding svg           { max-width: 100%; height: auto; }
+
+/*  the two theme variants of a "{theme}" image embedding: the containers
+    are layout-neutral and only the variant matching the active theme stays
+    visible, where print (like the theme mapping above) always falls back
+    onto the light variant  */
+span.theme-light-only       { display: contents; }
+span.theme-dark-only        { display: none; }
+@media screen {
+html.theme-dark span.theme-light-only { display: none; }
+html.theme-dark span.theme-dark-only  { display: contents; }
+}
+
 div.diagram                 { margin: 1.0rem 0; }
 div.diagram svg             { max-width: 100%; height: auto; }
 span.rationale              { color: var(--theme-color-specbook-muted); }
 p.rationale                 { color: var(--theme-color-specbook-muted); margin: 0.5rem 0 0 0; }
 span.keyword                { font-weight: bold; }
 code                        { font-family: "Source Code Pro", monospace; font-size: 1.0em; letter-spacing: -0.030rem; }
-div.meta                    { color: var(--theme-color-specbook-muted); font-size: 0.8rem; }
 
 div.titlepage               { text-align: center; margin: 6rem 0 4rem 0;
                               page-break-after: always; }
@@ -261,7 +272,6 @@ div.search                  { display: none; }
 /*  the search result filtering and matched word highlighting  */
 .search-hide                { display: none; }
 body.searching nav.toc,
-body.searching div.meta,
 body.searching div.embedding { display: none; }
 mark.search-hit             { color: var(--theme-color-specbook-mark-text);
                               background-color: var(--theme-color-specbook-mark-back);

package/dst/specbook-export-html.d.ts

@@ -1,9 +1,9 @@
-import type { Specification } from "./specbook-struct-spec.js";
-import type { SchemaSpecification } from "./specbook-struct-schema.js";
+import type { Spec } from "./specbook-format-spec.js";
+import type { Schema } from "./specbook-format-schema.js";
 export type OutlineEntry = {
     title: string;
     anchor: string;
     childs: OutlineEntry[];
 };
-export declare const htmlOutline: (specification: Specification, config?: SchemaSpecification) => OutlineEntry[];
-export declare const renderHtml: (specification: Specification, config?: SchemaSpecification, tocPages?: Map<string, number>, css?: string) => Promise<string>;
+export declare const htmlOutline: (specification: Spec, config?: Schema) => OutlineEntry[];
+export declare const renderHtml: (specification: Spec, config?: Schema, tocPages?: Map<string, number>, css?: string) => Promise<string>;

package/dst/specbook-export-html.js

@@ -11,8 +11,8 @@ import textframe from "textframe";
 import { Gradia } from "@rse/gradia";
 import { buildLinkIndex, resolveUnique, expandReferences, anchorPaths } from "./specbook-link.js";
 import { compileValueExpr, splitItems } from "./specbook-parse-value.js";
-import { embeddingRegex, embeddingMimeType } from "./specbook-parse-common.js";
-import { escapeHtml, stylesheet, searchScript, fallbackLogo, isTitleObject, documentTitle, documentLang, documentThemeStyle } from "./specbook-export-common.js";
+import { embeddingRegex, embeddingMimeType, embeddingThemes, embeddingVariants } from "./specbook-parse-common.js";
+import { escapeHtml, stylesheet, searchScript, fallbackLogo, isTitleObject, titleObject, documentTitle, documentLang, documentThemeStyle } from "./specbook-export-common.js";
 import { specDiagrams } from "./specbook-diagram.js";
 /*  ==== Templates ====  */
 /*  the built-in Nunjucks templates for the HTML export  */
@@ -51,7 +51,6 @@ const templates = {
             <body>
                 <div class="theme-switch" onclick="themeSwitch()" title="switch color theme">&#x25D0;</div>
                 {{ Document.titlepage }}
-                {% if not Document.titlepage %}<div class="meta">created: {{ Document.created }}, modified: {{ Document.modified }}</div>{% endif %}
                 {{ Document.toc }}
                 {{ Document.artifacts }}
                 {% if Document.search %}<script>{{ Document.search }}</script>{% endif %}
@@ -242,16 +241,35 @@ const isBlock = (text) => {
     const tokens = marked.lexer(text).filter((token) => token.type !== "space");
     return tokens.length > 0 && !(tokens.length === 1 && tokens[0].type === "paragraph");
 };
-/*  render the embedded image files of a text into HTML (SVG inlined
-    as-is, PNG/JPEG placed onto <img> tags), taking the image alternate
-    texts from the corresponding "![alt](file)" markups  */
+/*  render a single embedded image file into HTML (SVG inlined as-is,
+    PNG/JPEG placed onto an <img> tag)  */
+const renderImage = (content, alt) => content.startsWith("data:") ?
+    `<img src="${content}" alt="${escapeHtml(alt)}"/>` :
+    content.replace(/^\s*<\?xml[^>]*\?>\s*(?:<!DOCTYPE[^>]*>\s*)?/i, "");
+/*  wrap the theme variants of an image into their layout-neutral theme
+    containers, of which the stylesheet shows just the one matching the
+    color theme currently active in the document  */
+const renderThemed = (images) => images.map((image, i) => `<span class="theme-${embeddingThemes[i]}-only">${image}</span>`).join("");
+/*  render the embedded image files of a text into HTML, taking the image
+    alternate texts from the corresponding "![alt](file)" markups and
+    pairing up the consecutive theme variants of a "{theme}" markup  */
 const renderEmbeddings = (text, embedding) => {
-    const alts = [...text.matchAll(embeddingRegex)]
-        .filter((m) => embeddingMimeType(m[2].trim()) !== undefined)
-        .map((m) => m[1].trim());
-    return embedding.map((content, i) => content.startsWith("data:") ?
-        `<img src="${content}" alt="${escapeHtml(alts[i] ?? "")}"/>` :
-        content.replace(/^\s*<\?xml[^>]*\?>\s*(?:<!DOCTYPE[^>]*>\s*)?/i, ""));
+    const result = new Array();
+    let i = 0;
+    for (const m of text.matchAll(embeddingRegex)) {
+        const reference = m[2].trim();
+        if (embeddingMimeType(reference) === undefined)
+            continue;
+        const variants = embeddingVariants(reference);
+        const images = embedding.slice(i, i + variants.length)
+            .map((content) => renderImage(content, m[1].trim()));
+        i += variants.length;
+        if (variants.length > 1 && images.length === variants.length)
+            result.push(renderThemed(images));
+        else
+            result.push(...images);
+    }
+    return result;
 };
 /*  render a description into HTML, expanding its inline Markdown and
     moving the file embeddings to the end of the description  */
@@ -312,13 +330,10 @@ const collectSchemas = (specification, config) => {
     }
     return result;
 };
-/*  strip a trailing parenthesized annotation from a
-    property key (e.g. "WHEN (Context)")  */
-const plainKey = (key) => key.replace(/\s*\([^)]*\)\s*$/, "").trim();
 /*  render a property value, badging the individual members of an
     "enum(...)" (a single member) or "tags(...)" (a member set) value  */
 const inlineValue = (kind, key, value) => {
-    const member = members?.get(`${kind}${plainKey(key)}`);
+    const member = members?.get(`${kind}${key}`);
     if (member === undefined)
         return inline(value);
     const items = member === "tags" ? splitItems(value) : [value.trim()];
@@ -340,7 +355,7 @@ const effectiveProperties = (object) => {
     if (schema?.format?.withUnusedProps !== true)
         return object.properties;
     const merged = (schema.props ?? []).flatMap((prop) => {
-        const present = object.properties.filter((property) => plainKey(property.key) === prop.name);
+        const present = object.properties.filter((property) => property.key === prop.name);
         return present.length > 0 ? present : [{ key: prop.name, value: "" }];
     });
     return [...merged, ...object.properties.filter((property) => !merged.includes(property))];
@@ -357,24 +372,29 @@ const tableShape = (childs) => {
     const schema = schemas?.get(childs[0]);
     if (schema?.format?.withUnusedProps === true) {
         const merged = (schema.props ?? []).flatMap((prop) => {
-            const present = keys.filter((key) => plainKey(key) === prop.name);
+            const present = keys.filter((key) => key === prop.name);
             return present.length > 0 ? present : [prop.name];
         });
         keys = [...merged, ...keys.filter((key) => !merged.includes(key))];
     }
     return { keys, desc: childs.some((child) => child.description !== undefined || child.childs.length > 0) };
 };
+/*  provide the childs of an object taking part in the regular document
+    flow: a nested title object leaves the flow, as it is rendered as the
+    title page instead (a top-level one instead removes its whole artifact)  */
+const flowChilds = (object) => object.childs.filter((child) => !isTitleObject(child));
 /*  decide whether the childs of an object collapse into the concise
     (tabular) rendering: an explicit "format" type wins, "auto" collapses
     the deepest level only, and inside an already concise rendering
     context "auto" childs implicitly stay concise, too  */
 const conciseChilds = (object, schemaMap, concise) => {
-    if (object.childs.length === 0)
+    const childs = flowChilds(object);
+    if (childs.length === 0)
         return false;
     const type = schemaMap?.get(object)?.format?.type ?? "auto";
     if (type !== "auto")
         return type === "concise";
-    return concise || object.childs.every((child) => child.childs.length === 0);
+    return concise || childs.every((child) => child.childs.length === 0);
 };
 /*  group the childs of an object by their kind, preserving order  */
 const groupChilds = (childs) => {
@@ -394,10 +414,11 @@ const groupChilds = (childs) => {
     ones as regular nested object renderings pressed into the cell)  */
 const renderCell = (child) => {
     let html = child.description !== undefined ? renderDescription(child.description) : "";
-    if (child.childs.length > 0)
+    const childs = flowChilds(child);
+    if (childs.length > 0)
         html += conciseChilds(child, schemas, true) ?
-            groupChilds(child.childs).map((group) => renderTable(group, maxColumnsOf(child))).join("") :
-            child.childs.map((sub) => renderObject(sub, 6, true)).join("");
+            groupChilds(childs).map((group) => renderTable(group, maxColumnsOf(child))).join("") :
+            childs.map((sub) => renderObject(sub, 6, true)).join("");
     return html;
 };
 /*  render a single-kind group of childs into one compact table:
@@ -474,8 +495,8 @@ const renderObject = (object, level, concise) => {
             description: object.description !== undefined ?
                 safe(renderDescription(object.description)) : "",
             childs: conciseChilds(object, schemas, concise) ?
-                safe(groupChilds(object.childs).map((group) => renderTable(group, maxColumnsOf(object))).join("")) :
-                safe(object.childs.map((child) => renderObject(child, level + 1, concise)).join(""))
+                safe(groupChilds(flowChilds(object)).map((group) => renderTable(group, maxColumnsOf(object))).join("")) :
+                safe(flowChilds(object).map((child) => renderObject(child, level + 1, concise)).join(""))
         } });
 };
 /*  render the title object into a title page  */
@@ -489,11 +510,13 @@ const renderTitlePage = (object, created, modified) => {
         "LANG", "CHARSET", "PAPER-SIZE", "THEME-STYLE", "THEME-TONE"].includes(property.key));
     /*  the logo is rendered above the title, from the embedded image content
         of the LOGO property or, for a non-embeddable reference, as its inline
-        Markdown; without a LOGO property the built-in SpecBook logo is used  */
+        Markdown; without a LOGO property the built-in SpecBook logo is used,
+        in both its theme variants  */
     const logo = object.properties.find((property) => property.key === "LOGO");
     const image = logo !== undefined ? renderEmbeddings(logo.value, logo.embedding ?? []) : [];
     return render("TitlePage", { TitlePage: {
-            logo: logo === undefined ? safe(`<img src="${fallbackLogo()}" alt="SpecBook"/>`) :
+            logo: logo === undefined ?
+                safe(renderThemed(embeddingThemes.map((theme) => `<img src="${fallbackLogo(theme)}" alt="SpecBook"/>`))) :
                 (image.length > 0 ? safe(image.join("")) : inline(logo.value)),
             title: inline(prop("TITLE") ?? object.name),
             subtitle: inlineProp("SUBTITLE"),
@@ -518,13 +541,22 @@ export const htmlOutline = (specification, config) => {
     const entry = (object) => ({
         title: (object.kind !== "" ? `${object.kind}: ` : "") + object.name,
         anchor: paths.get(object) ?? object.id,
-        childs: conciseChilds(object, schemaMap, false) ? [] : object.childs.map(entry)
+        childs: conciseChilds(object, schemaMap, false) ? [] : flowChilds(object).map(entry)
     });
     return specification.artifacts
         .filter((artifact) => !artifact.objects.some(isTitleObject))
         .flatMap((artifact) => artifact.objects)
         .map(entry);
 };
+/*  determine the object a title page is rendered from: the title object
+    has to carry a non-empty "TITLE" property, as without it there is
+    nothing to render a title page from (the object stays suppressed in
+    the regular flow nevertheless)  */
+const titlePageObject = (specification) => {
+    const object = titleObject(specification);
+    const title = object?.properties.find((property) => property.key === "TITLE");
+    return title !== undefined && title.value.trim() !== "" ? object : undefined;
+};
 /*  render the entire specification into a self-contained HTML document,
     with the build-time pre-assembled stylesheet embedded inline, the
     artifact timestamps aggregated into min(Created)/max(Modified), and
@@ -577,8 +609,7 @@ export const renderHtml = async (specification, config, tocPages, css) => {
     const created = new Date(Math.min(...specification.artifacts.map((artifact) => artifact.created.getTime())));
     const modified = new Date(Math.max(...specification.artifacts.map((artifact) => artifact.modified.getTime())));
     /*  a "META: Title" object becomes the title page and leaves the regular flow  */
-    const title = specification.artifacts
-        .flatMap((artifact) => artifact.objects).find(isTitleObject);
+    const title = titlePageObject(specification);
     const artifacts = specification.artifacts
         .filter((artifact) => !artifact.objects.some(isTitleObject));
     const entries = artifacts.flatMap((artifact) => artifact.objects)
@@ -589,8 +620,6 @@ export const renderHtml = async (specification, config, tocPages, css) => {
             lang,
             theme: documentThemeStyle(specification)?.toLowerCase(),
             css: safe(css ?? stylesheet()),
-            created: created.toISOString(),
-            modified: modified.toISOString(),
             titlepage: title !== undefined ?
                 safe(renderTitlePage(title, created.toISOString().slice(0, 10), modified.toISOString().slice(0, 10))) : "",
             search: title !== undefined ? safe(searchScript()) : "",

package/dst/specbook-export-logo-dark.svg

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Layer_1" xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0 0 260.8 110.5">
+  <!-- Generator: Adobe Illustrator 30.7.0, SVG Export Plug-In . SVG Version: 2.1.4 Build 114)  -->
+  <defs>
+    <style>
+      .st0 {
+        fill: none;
+      }
+
+      .st1 {
+        fill: #69c;
+      }
+
+      .st2 {
+        fill: #9fc9eb;
+      }
+    </style>
+  </defs>
+  <g>
+    <rect class="st0" x="128" y="5.9" width="297.7" height="245.4"/>
+    <path class="st2" d="M132.6,41.3c2.6,1.3,6.7,2.7,10.8,2.7s6.8-1.9,6.8-4.7-2-4.2-7.2-6c-7.2-2.6-11.9-6.5-11.9-12.8s6.2-12.9,16.3-12.9,8.4,1,11,2.2l-2.2,7.8c-1.7-.8-4.8-2-9-2s-6.3,2-6.3,4.2,2.4,4,8,6.1c7.6,2.8,11.1,6.8,11.1,12.9s-5.5,13.4-17.3,13.4-9.8-1.3-12.2-2.7l2-8Z"/>
+    <path class="st2" d="M163.3,30.5c0-4.1-.1-7.6-.3-10.5h8.4l.4,4.4h.1c2.3-3.3,5.9-5.1,10.4-5.1,6.8,0,13,6,13,15.9s-7.2,16.8-14.2,16.8-6.7-1.5-8.1-3.6h-.1v15.6h-9.7V30.5ZM173,37.9c0,.8,0,1.4.2,2,.6,2.6,2.9,4.6,5.7,4.6,4.2,0,6.7-3.5,6.7-8.8s-2.2-8.8-6.6-8.8-5.2,2-5.8,4.9c-.1.5-.2,1.2-.2,1.7v4.3Z"/>
+    <path class="st2" d="M206,38.8c.3,4,4.3,6,8.8,6s6-.4,8.6-1.3l1.3,6.6c-3.2,1.3-7.1,2-11.3,2-10.6,0-16.7-6.1-16.7-15.9s4.9-16.7,15.8-16.7,14,7.9,14,15.6-.2,3.1-.3,3.8h-20.2ZM217.5,32.1c0-2.4-1-6.3-5.5-6.3s-5.8,3.8-6,6.3h11.5Z"/>
+    <path class="st2" d="M252.6,50.5c-1.7.8-5,1.5-8.7,1.5-10.1,0-16.6-6.2-16.6-16s6.3-16.6,17.9-16.6,5.4.4,7.4,1.2l-1.5,7.2c-1.2-.5-2.9-1-5.4-1-5.1,0-8.4,3.6-8.4,8.8,0,5.7,3.8,8.8,8.6,8.8s4.1-.4,5.6-1l1.2,7.2Z"/>
+  </g>
+  <path class="st2" d="M25.4,18.5h0c-1,0-2,.4-2.7,1.1-.7.7-1.1,1.7-1.1,2.8v58.4c0,2.1,1.7,3.9,3.9,3.9,9.1,0,24.3,1.9,34.7,12.9v-61.1c0-.7-.2-1.4-.5-2-8.6-13.9-25.1-16-34.2-16Z"/>
+  <path class="st2" d="M104.8,80.9V22.4c0-1-.4-2-1.1-2.8-.7-.7-1.7-1.1-2.7-1.1h0c-9.1,0-25.6,2.1-34.2,16-.4.6-.5,1.2-.5,2v61.1c10.5-11,25.7-12.9,34.7-12.9,2.2,0,3.9-1.8,3.9-3.9Z"/>
+  <path class="st1" d="M113.7,32h-2.8v48.8c0,5.5-4.5,9.9-9.9,9.9-7.7,0-20.4,1.5-29.4,10,15.5-3.8,31.9-1.3,41.2.8,1.2.3,2.4,0,3.3-.8.9-.7,1.5-1.9,1.5-3v-61.9c0-2.1-1.7-3.9-3.9-3.9Z"/>
+  <path class="st1" d="M15.4,80.9v-48.8h-2.8c-2.1,0-3.9,1.7-3.9,3.9v61.9c0,1.2.5,2.3,1.5,3,.9.7,2.1,1,3.3.8,9.3-2.1,25.7-4.6,41.2-.8-9-8.5-21.7-10-29.4-10-5.5,0-9.9-4.5-9.9-9.9Z"/>
+  <g>
+    <path class="st1" d="M131.7,55.6c2.6-.6,6.8-1,11-1,6,0,9.9,1,12.7,3.4,2.4,1.8,3.9,4.6,3.9,8.2s-3,8.5-7.9,10.2v.2c4.4,1,9.6,4.7,9.6,11.6s-1.6,7.1-4,9.3c-3.2,3-8.4,4.4-16,4.4s-7.3-.3-9.3-.6v-45.7ZM137.7,74.6h5.5c6.3,0,10-3.4,10-7.9s-4.1-7.6-10.2-7.6-4.4.2-5.3.4v15.1ZM137.7,96.9c1.2.2,2.9.3,5,.3,6.2,0,12-2.3,12-9.1s-5.5-9-12-9h-5v17.8Z"/>
+    <path class="st1" d="M206.1,66.9c-9.3,0-16.6,6.6-16.6,17.8s0,.2,0,.4h0c-.3,7.2-4.5,12.3-10.1,12.3s-10.2-5.5-10.2-12.8,3.1-13,10.3-13,7,2.6,8.5,5.8c.8-2.1,1.9-4,3.4-5.5-2.8-3.1-6.9-4.9-11.8-4.9-9.3,0-16.6,6.6-16.6,17.8s7,17.2,16,17.2,16.2-5.1,16.6-16.8h0c0-.2,0-.4,0-.6,0-6.4,3.1-13,10.3-13s10,7.2,10,12.8-4.4,13-10.2,13-7.3-2.6-8.9-6.5c-.7,2.3-1.9,4.2-3.3,5.8,2.9,3.4,7.1,5.3,12,5.3,8.1,0,16.6-5.4,16.6-17.8s-6.5-17.2-16.1-17.2Z"/>
+    <path class="st1" d="M230.6,83.8h.1c.8-1.2,1.9-2.6,2.9-3.8l9.9-11.5h7.3l-12.9,13.7,14.7,19.7h-7.5l-11.5-16-3.1,3.5v12.6h-6v-49.1h6v31Z"/>
+  </g>
+</svg>

package/dst/specbook-export-logo-light.svg

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Layer_1" xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0 0 260.8 110.5">
+  <!-- Generator: Adobe Illustrator 30.7.0, SVG Export Plug-In . SVG Version: 2.1.4 Build 114)  -->
+  <defs>
+    <style>
+      .st0 {
+        fill: none;
+      }
+
+      .st1 {
+        fill: #69c;
+      }
+
+      .st2 {
+        fill: #33669a;
+      }
+    </style>
+  </defs>
+  <g>
+    <rect class="st0" x="128" y="5.9" width="297.7" height="245.4"/>
+    <path class="st2" d="M132.6,41.3c2.6,1.3,6.7,2.7,10.8,2.7s6.8-1.9,6.8-4.7-2-4.2-7.2-6c-7.2-2.6-11.9-6.5-11.9-12.8s6.2-12.9,16.3-12.9,8.4,1,11,2.2l-2.2,7.8c-1.7-.8-4.8-2-9-2s-6.3,2-6.3,4.2,2.4,4,8,6.1c7.6,2.8,11.1,6.8,11.1,12.9s-5.5,13.4-17.3,13.4-9.8-1.3-12.2-2.7l2-8Z"/>
+    <path class="st2" d="M163.3,30.5c0-4.1-.1-7.6-.3-10.5h8.4l.4,4.4h.1c2.3-3.3,5.9-5.1,10.4-5.1,6.8,0,13,6,13,15.9s-7.2,16.8-14.2,16.8-6.7-1.5-8.1-3.6h-.1v15.6h-9.7V30.5ZM173,37.9c0,.8,0,1.4.2,2,.6,2.6,2.9,4.6,5.7,4.6,4.2,0,6.7-3.5,6.7-8.8s-2.2-8.8-6.6-8.8-5.2,2-5.8,4.9c-.1.5-.2,1.2-.2,1.7v4.3Z"/>
+    <path class="st2" d="M206,38.8c.3,4,4.3,6,8.8,6s6-.4,8.6-1.3l1.3,6.6c-3.2,1.3-7.1,2-11.3,2-10.6,0-16.7-6.1-16.7-15.9s4.9-16.7,15.8-16.7,14,7.9,14,15.6-.2,3.1-.3,3.8h-20.2ZM217.5,32.1c0-2.4-1-6.3-5.5-6.3s-5.8,3.8-6,6.3h11.5Z"/>
+    <path class="st2" d="M252.6,50.5c-1.7.8-5,1.5-8.7,1.5-10.1,0-16.6-6.2-16.6-16s6.3-16.6,17.9-16.6,5.4.4,7.4,1.2l-1.5,7.2c-1.2-.5-2.9-1-5.4-1-5.1,0-8.4,3.6-8.4,8.8,0,5.7,3.8,8.8,8.6,8.8s4.1-.4,5.6-1l1.2,7.2Z"/>
+  </g>
+  <path class="st2" d="M25.4,18.5h0c-1,0-2,.4-2.7,1.1-.7.7-1.1,1.7-1.1,2.8v58.4c0,2.1,1.7,3.9,3.9,3.9,9.1,0,24.3,1.9,34.7,12.9v-61.1c0-.7-.2-1.4-.5-2-8.6-13.9-25.1-16-34.2-16Z"/>
+  <path class="st2" d="M104.8,80.9V22.4c0-1-.4-2-1.1-2.8-.7-.7-1.7-1.1-2.7-1.1h0c-9.1,0-25.6,2.1-34.2,16-.4.6-.5,1.2-.5,2v61.1c10.5-11,25.7-12.9,34.7-12.9,2.2,0,3.9-1.8,3.9-3.9Z"/>
+  <path class="st1" d="M113.7,32h-2.8v48.8c0,5.5-4.5,9.9-9.9,9.9-7.7,0-20.4,1.5-29.4,10,15.5-3.8,31.9-1.3,41.2.8,1.2.3,2.4,0,3.3-.8.9-.7,1.5-1.9,1.5-3v-61.9c0-2.1-1.7-3.9-3.9-3.9Z"/>
+  <path class="st1" d="M15.4,80.9v-48.8h-2.8c-2.1,0-3.9,1.7-3.9,3.9v61.9c0,1.2.5,2.3,1.5,3,.9.7,2.1,1,3.3.8,9.3-2.1,25.7-4.6,41.2-.8-9-8.5-21.7-10-29.4-10-5.5,0-9.9-4.5-9.9-9.9Z"/>
+  <g>
+    <path class="st1" d="M131.7,55.6c2.6-.6,6.8-1,11-1,6,0,9.9,1,12.7,3.4,2.4,1.8,3.9,4.6,3.9,8.2s-3,8.5-7.9,10.2v.2c4.4,1,9.6,4.7,9.6,11.6s-1.6,7.1-4,9.3c-3.2,3-8.4,4.4-16,4.4s-7.3-.3-9.3-.6v-45.7ZM137.7,74.6h5.5c6.3,0,10-3.4,10-7.9s-4.1-7.6-10.2-7.6-4.4.2-5.3.4v15.1ZM137.7,96.9c1.2.2,2.9.3,5,.3,6.2,0,12-2.3,12-9.1s-5.5-9-12-9h-5v17.8Z"/>
+    <path class="st1" d="M206.1,66.9c-9.3,0-16.6,6.6-16.6,17.8s0,.2,0,.4h0c-.3,7.2-4.5,12.3-10.1,12.3s-10.2-5.5-10.2-12.8,3.1-13,10.3-13,7,2.6,8.5,5.8c.8-2.1,1.9-4,3.4-5.5-2.8-3.1-6.9-4.9-11.8-4.9-9.3,0-16.6,6.6-16.6,17.8s7,17.2,16,17.2,16.2-5.1,16.6-16.8h0c0-.2,0-.4,0-.6,0-6.4,3.1-13,10.3-13s10,7.2,10,12.8-4.4,13-10.2,13-7.3-2.6-8.9-6.5c-.7,2.3-1.9,4.2-3.3,5.8,2.9,3.4,7.1,5.3,12,5.3,8.1,0,16.6-5.4,16.6-17.8s-6.5-17.2-16.1-17.2Z"/>
+    <path class="st1" d="M230.6,83.8h.1c.8-1.2,1.9-2.6,2.9-3.8l9.9-11.5h7.3l-12.9,13.7,14.7,19.7h-7.5l-11.5-16-3.1,3.5v12.6h-6v-49.1h6v31Z"/>
+  </g>
+</svg>

package/dst/specbook-export-md.d.ts

@@ -1,3 +1,3 @@
-import type { Specification } from "./specbook-struct-spec.js";
-import type { SchemaSpecification } from "./specbook-struct-schema.js";
-export declare const renderMarkdown: (specification: Specification, config?: SchemaSpecification) => Promise<string>;
+import type { Spec } from "./specbook-format-spec.js";
+import type { Schema } from "./specbook-format-schema.js";
+export declare const renderMarkdown: (specification: Spec, config?: Schema) => Promise<string>;

package/dst/{specbook-struct-schema.d.ts → specbook-format-schema.d.ts}

@@ -1,6 +1,6 @@
 import * as v from "valibot";
 import { type Config as GradiaConfig } from "@rse/gradia";
-export type SchemaSpecification = SchemaObject[];
+export type Schema = SchemaObject[];
 export type SchemaObject = {
     kind: string;
     name?: string;
@@ -19,6 +19,7 @@ export type SchemaDiagram = {
     edges?: string;
     center?: string;
     links?: "props" | "all";
+    edgeSource?: string;
     edgeTarget?: string;
     edgeArity?: string;
     hierarchy?: boolean;
@@ -39,4 +40,4 @@ export type SchemaProperty = {
     value?: string;
     optional?: boolean;
 };
-export declare const SchemaSpecification: v.GenericSchema<SchemaSpecification>;
+export declare const Schema: v.GenericSchema<Schema>;

package/dst/{specbook-struct-schema.js → specbook-format-schema.js}

@@ -25,6 +25,7 @@ const SchemaDiagram = v.strictObject({
     edges: v.optional(v.string()),
     center: v.optional(v.string()),
     links: v.optional(v.picklist(["props", "all"])),
+    edgeSource: v.optional(v.string()),
     edgeTarget: v.optional(v.string()),
     edgeArity: v.optional(v.string()),
     hierarchy: v.optional(v.boolean()),
@@ -51,4 +52,4 @@ const SchemaObject = v.strictObject({
     props: v.optional(v.array(SchemaProperty)),
     childs: v.optional(v.array(v.lazy(() => SchemaObject)))
 });
-export const SchemaSpecification = v.pipe(v.array(SchemaObject), v.minLength(1));
+export const Schema = v.pipe(v.array(SchemaObject), v.minLength(1));

package/dst/specbook-format-spec.d.ts

@@ -0,0 +1,31 @@
+import * as v from "valibot";
+export type Spec = {
+    artifacts: SpecArtifact[];
+};
+export type SpecArtifact = {
+    created: Date;
+    modified: Date;
+    objects: SpecObject[];
+};
+export type SpecObject = {
+    kind: string;
+    id: string;
+    anchor?: string;
+    paren?: string;
+    name: string;
+    primary?: boolean;
+    description?: SpecDescription;
+    properties: SpecProperty[];
+    childs: SpecObject[];
+};
+export type SpecDescription = {
+    description: string;
+    rationale?: string;
+    embedding?: string[];
+};
+export type SpecProperty = {
+    key: string;
+    value: string;
+    embedding?: string[];
+};
+export declare const Spec: v.GenericSchema<Spec>;

package/dst/{specbook-struct-spec.js → specbook-format-spec.js}

@@ -5,32 +5,32 @@
 */
 import * as v from "valibot";
 /*  ==== Schema ====  */
-const Property = v.object({
+const SpecProperty = v.object({
     key: v.string(),
     value: v.string(),
     embedding: v.optional(v.array(v.string()))
 });
-const Description = v.object({
+const SpecDescription = v.object({
     description: v.string(),
     rationale: v.optional(v.string()),
     embedding: v.optional(v.array(v.string()))
 });
-const Object = v.object({
+const SpecObject = v.object({
     kind: v.string(),
     id: v.string(),
     anchor: v.optional(v.string()),
     paren: v.optional(v.string()),
     name: v.string(),
     primary: v.optional(v.boolean()),
-    description: v.optional(Description),
-    properties: v.array(Property),
-    childs: v.array(v.lazy(() => Object))
+    description: v.optional(SpecDescription),
+    properties: v.array(SpecProperty),
+    childs: v.array(v.lazy(() => SpecObject))
 });
-const Artifact = v.object({
+const SpecArtifact = v.object({
     created: v.date(),
     modified: v.date(),
-    objects: v.pipe(v.array(Object), v.minLength(1))
+    objects: v.pipe(v.array(SpecObject), v.minLength(1))
 });
-export const Specification = v.object({
-    artifacts: v.pipe(v.array(Artifact), v.minLength(1))
+export const Spec = v.object({
+    artifacts: v.pipe(v.array(SpecArtifact), v.minLength(1))
 });