atdoc-core 0.1.0

package/dist/registry.js

@@ -0,0 +1,265 @@
+// Node registry — the single source of truth the Lexer and Parser both consult
+// to know what `@word` means and what shape its slots take.
+//
+// Mirrors `configs/atdoc-setting.json`'s tokenGroups / specialRules groupings
+// (structuralKeywords, containerKeywords, calloutKeywords, widgetKeywords,
+// formatKeywords, semanticKeywords, footnoteKeywords, specialKeywords,
+// metaKeywords, contextNodes, voidNodes, rawNodes, rawEscapeNodes,
+// escapeSymbols, rawEscapeSymbols, strongQuote). JSON carries no comments, so
+// what those last few mean lives here: `rawNodes` is every node whose content
+// the Lexer scans opaquely (the four raw-family ContentModes below), which is
+// also exactly the set that accepts the `strongQuote` delimiters;
+// `rawEscapeNodes` is the subset that additionally honours
+// `rawEscapeSymbols` (only @raw — @code/@mermaid/@svg define no escapes at
+// all). tests/config-sync.test.ts enforces all of this rather than trusting
+// the hand-sync. Content-mode/paren/styles details below come from
+// Block-Syntax-Specification.md §3 and Inline-Syntax-Specification.md §4.
+/**
+ * How a "(...)" slot's raw text becomes the convenience field its `parenRole`
+ * implies. Lives here rather than in the Parser because `parenRole` does —
+ * the Serializer needs the same mapping to check that a hand-built node's
+ * `level`/`imgOptions`/... actually agree with its `paren`, and a second copy
+ * of the rules is exactly how the two would drift apart.
+ */
+export function parseImgOptions(raw) {
+    const options = {};
+    const parts = raw.split(',').map(s => s.trim()).filter(Boolean);
+    parts.forEach((part, idx) => {
+        const eq = part.indexOf('=');
+        if (eq === -1) {
+            if (idx === 0)
+                options.src = part; // first bare option defaults to src — Block Syntax Spec §5 Image
+            return;
+        }
+        const key = part.slice(0, eq).trim();
+        const value = part.slice(eq + 1).trim();
+        if (key)
+            options[key] = value;
+    });
+    return options;
+}
+/** @heading's level, defaulting a missing or out-of-range "(...)" to 1. */
+export function clampLevel(raw) {
+    const lvl = parseInt(raw ?? '1', 10);
+    return Number.isFinite(lvl) && lvl >= 1 && lvl <= 6 ? lvl : 1;
+}
+/** @list's "(ordered)" flag. */
+export function isOrderedParen(raw) {
+    return /^\s*ordered\s*$/i.test(raw ?? '');
+}
+/**
+ * What a "(...)" slot implies, in exactly the shape the Parser records it.
+ *
+ * Note which keys are *present with an undefined value*: the Parser assigns
+ * `title`/`language`/`uri`/`id` unconditionally, so `@card[x]` really does
+ * carry `title: undefined` rather than no key at all. Reproducing that
+ * faithfully is what lets a canonicalized node compare deep-equal to a parsed
+ * one — `{ title: undefined }` and `{}` are different objects to
+ * assert.deepStrictEqual.
+ *
+ * `ordered` is the exception the Parser sets only when true, per DocASTNode's
+ * own documentation ("unset/false renders as a bullet list"), so a non-ordered
+ * @list has no key at all.
+ */
+export function deriveParenFields(role, paren) {
+    switch (role) {
+        case 'level': return { level: clampLevel(paren) };
+        case 'title': return { title: paren };
+        case 'language': return { language: paren };
+        case 'uri': return { uri: paren };
+        case 'id': return { id: paren };
+        case 'options': return { imgOptions: parseImgOptions(paren ?? '') };
+        case 'ordered': return isOrderedParen(paren) ? { ordered: true } : {};
+        default: return {};
+    }
+}
+function def(partial) {
+    return partial;
+}
+const REGISTRY = [
+    // Metadata — Block Syntax Specification §9
+    def({ name: 'meta', kind: 'meta', content: 'meta', paren: 'none' }),
+    // Structural Blocks — §5
+    def({ name: 'heading', kind: 'block', content: 'generic', paren: 'optional', parenRole: 'level' }),
+    def({ name: 'paragraph', kind: 'block', content: 'generic', paren: 'none' }),
+    def({ name: 'quote', kind: 'block', content: 'generic', paren: 'none' }),
+    def({ name: 'list', kind: 'block', content: 'generic', paren: 'optional', parenRole: 'ordered' }),
+    def({ name: 'code', kind: 'block', content: 'raw', paren: 'optional', parenRole: 'language' }),
+    def({ name: 'img', kind: 'block', content: 'generic', paren: 'required', parenRole: 'options', styles: 'image' }),
+    def({ name: 'table', kind: 'block', content: 'table', paren: 'none' }),
+    def({ name: 'cols', kind: 'block', content: 'comma-list', paren: 'none', restrictedTo: 'table' }),
+    def({ name: 'data', kind: 'block', content: 'rows', paren: 'none', restrictedTo: 'table' }),
+    def({ name: 'hr', kind: 'block', content: 'none', paren: 'none' }),
+    def({ name: 'svg', kind: 'block', content: 'raw', paren: 'none' }),
+    // Container Blocks — §6
+    def({ name: 'details', kind: 'block', content: 'generic', paren: 'optional', parenRole: 'title', styles: 'color' }),
+    def({ name: 'card', kind: 'block', content: 'generic', paren: 'optional', parenRole: 'title', styles: 'card' }),
+    // Callout Blocks — §7
+    def({ name: 'note', kind: 'block', content: 'generic', paren: 'optional', parenRole: 'title', styles: 'color' }),
+    def({ name: 'tip', kind: 'block', content: 'generic', paren: 'optional', parenRole: 'title', styles: 'color' }),
+    def({ name: 'important', kind: 'block', content: 'generic', paren: 'optional', parenRole: 'title', styles: 'color' }),
+    def({ name: 'warning', kind: 'block', content: 'generic', paren: 'optional', parenRole: 'title', styles: 'color' }),
+    def({ name: 'caution', kind: 'block', content: 'generic', paren: 'optional', parenRole: 'title', styles: 'color' }),
+    // Widget Blocks — §8
+    def({ name: 'tabs', kind: 'block', content: 'tabs', paren: 'none' }),
+    def({ name: 'tab', kind: 'block', content: 'generic', paren: 'required', parenRole: 'title', restrictedTo: 'tabs' }),
+    def({ name: 'mermaid', kind: 'block', content: 'raw', paren: 'none' }),
+    // Text Formatting — Inline §4, §7, §9
+    def({ name: 'bold', kind: 'inline', content: 'generic', paren: 'none' }),
+    def({ name: 'italic', kind: 'inline', content: 'generic', paren: 'none' }),
+    def({ name: 'underline', kind: 'inline', content: 'generic', paren: 'none' }),
+    def({ name: 'del', kind: 'inline', content: 'generic', paren: 'none' }),
+    def({ name: 'mark', kind: 'inline', content: 'generic', paren: 'none', styles: 'color' }),
+    def({ name: 'color', kind: 'inline', content: 'generic', paren: 'none', styles: 'color' }),
+    // Text outline/border — shares @color's exact {styles} slot (named color
+    // token or literal hex) and swatch table, just painted onto a border
+    // instead of a foreground color.
+    def({ name: 'bordered', kind: 'inline', content: 'generic', paren: 'none', styles: 'color' }),
+    def({ name: 'raw', kind: 'inline', content: 'raw-escaped', paren: 'none' }),
+    // Semantic Inline — Inline §4, §8
+    def({ name: 'sup', kind: 'inline', content: 'generic', paren: 'none' }),
+    def({ name: 'sub', kind: 'inline', content: 'generic', paren: 'none' }),
+    def({ name: 'kbd', kind: 'inline', content: 'key', paren: 'none' }),
+    def({ name: 'link', kind: 'inline', content: 'generic', paren: 'required', parenRole: 'uri' }),
+    // Footnotes — Inline §4
+    def({ name: 'defn', kind: 'inline', content: 'generic', paren: 'required', parenRole: 'id' }),
+    def({ name: 'fn', kind: 'inline', content: 'integer', paren: 'none' }),
+    // Special Nodes — Inline §4
+    // Note: "@@" (escape) is deliberately NOT registered here. Per Inline Spec §2,
+    // it is resolved at Lexer step 1 by character pattern, before any Command
+    // Registry lookup — see Special-Nodes.md §5. Registering it as a normal
+    // NodeDef would misrepresent it as a registry-driven command like the rest.
+    def({ name: 'n', kind: 'inline', content: 'none', paren: 'none' }),
+];
+const BY_NAME = new Map(REGISTRY.map(d => [d.name, d]));
+const ALIASES = [
+    { alias: 'h', canonical: 'heading', label: 'Heading' },
+    { alias: 'p', canonical: 'paragraph', label: 'Paragraph' },
+    { alias: 'b', canonical: 'bold', label: 'Bold' },
+    { alias: 'i', canonical: 'italic', label: 'Italic' },
+    { alias: 'u', canonical: 'underline', label: 'Underline' },
+];
+const ALIAS_BY_NAME = new Map(ALIASES.map(a => [a.alias, a]));
+export function getNodeDef(name) {
+    const direct = BY_NAME.get(name);
+    if (direct)
+        return direct;
+    const alias = ALIAS_BY_NAME.get(name);
+    return alias ? BY_NAME.get(alias.canonical) : undefined;
+}
+export function isKnownCommand(name) {
+    return BY_NAME.has(name) || ALIAS_BY_NAME.has(name);
+}
+/** Alias metadata for `name`, or undefined if `name` isn't a short alias (including if it's already canonical). */
+export function getAliasInfo(name) {
+    return ALIAS_BY_NAME.get(name);
+}
+/** The full alias table, for consumers that need to derive keyword lists including short aliases (e.g. src/editor/monarch.ts). */
+export function getAllAliasDefs() {
+    return ALIASES;
+}
+/**
+ * The full node table, for consumers that need to derive keyword lists
+ * (e.g. the editor's Monarch tokenizer, src/editor/monarch.ts) instead of
+ * hand-copying names. Keeping this as the single export point means new
+ * REGISTRY entries automatically flow into anything built from it.
+ */
+export function getAllNodeDefs() {
+    return REGISTRY;
+}
+/**
+ * Nodes let through inside @cols/@data cells (Structural-Blocks.md §5 Table
+ * only promises plain text there, but most of these just restyle text —
+ * bold/color/etc — without affecting the table's own structure, so authors
+ * can still use them for cell formatting). New nodes must opt in here
+ * explicitly; anything not listed (e.g. @card, @details) is Strict Mode's
+ * concern — Parser.ts's parseInlineCellList() throws for it rather than
+ * silently dropping it.
+ *
+ * @defn is deliberately excluded: it's collected document-wide and rendered
+ * once as a real `<li>` inside the footnotes `<ol>` (see Adapters.ts's
+ * renderFootnotes()), not loose inside a `<td>`.
+ * @fn (the footnote *reference*, a self-contained `<sup><a>` back-link) is
+ * fine and included — Parser.ts checks this set before its raw-family
+ * carve-out so @fn gets parsed as a real node instead of dumped as bare digits.
+ */
+const CELL_ALLOWED_INLINE = new Set([
+    'bold', 'italic', 'underline', 'del', 'mark', 'color', 'bordered', 'sup', 'sub', 'link', 'fn',
+    // @raw was left out while it was purely an escape mechanism with no visual
+    // identity of its own. Now that it renders as inline code (Inline Syntax
+    // Specification §9), excluding it means an API table — the single most
+    // common kind — silently loses the monospace on every identifier in it, the
+    // node being dropped and its text dumped in as a bare string.
+    'raw',
+]);
+export function isCellAllowedNode(name) {
+    return CELL_ALLOWED_INLINE.has(name);
+}
+/** Named color tokens shared by @mark/@color/@bordered and the Container/Callout Blocks (Inline Spec §7). */
+const NAMED_COLOR_TOKENS = [
+    'yellow', 'red', 'green', 'blue', 'orange', 'purple', 'gray',
+];
+/** Languages offered for @code's "(language)" — a convenience list, not a closed set; any string is valid. */
+const CODE_LANGUAGES = [
+    'ts', 'tsx', 'js', 'jsx', 'json', 'html', 'css', 'scss', 'python',
+    'bash', 'sql', 'go', 'rust', 'java', 'c', 'cpp', 'yaml', 'markdown', 'text',
+];
+/** @img's "(image-option-list)" keys — Block Spec §5's option table. */
+const IMAGE_OPTIONS = [
+    { label: 'src=', insert: 'src=${1}', detail: 'Image source URL (the key is optional for the first option)' },
+    { label: 'width=', insert: 'width=${1:200}', detail: 'Display width' },
+    { label: 'height=', insert: 'height=${1:150}', detail: 'Display height' },
+    { label: 'align=', insert: 'align=${1|left,center,right|}', detail: 'Alignment' },
+    { label: 'radius=', insert: 'radius=${1:8px}', detail: 'Corner radius (any CSS value; overridden by {radius-N})' },
+    { label: 'border=', insert: 'border=${1:1px solid #ccc}', detail: 'Border (any CSS value; overridden by {#RRGGBB})' },
+];
+/**
+ * What to offer inside `name`'s "(...)" slot. Empty for free-text roles
+ * (title/uri/id) — there's nothing meaningful to enumerate, so the editor
+ * should stay quiet rather than guess.
+ */
+export function getParenSuggestions(name) {
+    const nodeDef = getNodeDef(name);
+    if (!nodeDef || nodeDef.paren === 'none')
+        return [];
+    switch (nodeDef.parenRole) {
+        case 'level':
+            return [1, 2, 3, 4, 5, 6].map(n => ({ label: String(n), detail: `Level ${n} heading` }));
+        case 'ordered':
+            return [{ label: 'ordered', detail: 'Ordered list (unordered when omitted)' }];
+        case 'language':
+            return CODE_LANGUAGES.map(lang => ({ label: lang, detail: 'Syntax highlighting language' }));
+        case 'options':
+            return IMAGE_OPTIONS.map(o => ({ ...o }));
+        default: // 'title' | 'uri' | 'id' — free text
+            return [];
+    }
+}
+/**
+ * What to offer inside `name`'s "{styles}" slot, per its StyleSet. Empty when
+ * the node has no {styles} slot at all — the editor shows nothing and
+ * Parser.ts separately flags the slot itself as a grammar error.
+ */
+export function getStyleSuggestions(name) {
+    const nodeDef = getNodeDef(name);
+    switch (nodeDef?.styles) {
+        case 'color':
+            return [
+                ...NAMED_COLOR_TOKENS.map(token => ({ label: token, detail: 'Named color token' })),
+                { label: '#RRGGBB', insert: '#${1:3366ff}', detail: 'Hex color value (used directly without remapping)' },
+            ];
+        case 'card':
+            return [
+                { label: '#RRGGBB', insert: '#${1:3366ff}', detail: 'Background color (Card Style v1)' },
+                { label: 'radius-N', insert: 'radius-${1:12}', detail: 'Corner radius in pixels (Card Style v1)' },
+            ];
+        case 'image':
+            return [
+                { label: '#RRGGBB', insert: '#${1:3366ff}', detail: 'Border color, applied as a 1px solid line (Image Style v1)' },
+                { label: 'radius-N', insert: 'radius-${1:12}', detail: 'Corner radius in pixels (Image Style v1)' },
+            ];
+        default:
+            return [];
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+export interface DocASTNode {
+    type: string;
+    /** Top-level document nodes only — source character offset of the node's opening "@", used to map it back to an editor line for scroll sync (see pipeline.ts). */
+    start?: number;
+    /** Raw text of the "(...)" slot, if present — meaning depends on the node (see `parenRole` in registry.ts). */
+    paren?: string;
+    /** Parsed "{styles}" comma-list tokens — @mark only (Inline Syntax Specification §7). */
+    styles?: string[];
+    /** Generic nestable content — used by every node whose registry `content` mode is 'generic'. */
+    content: (DocASTNode | string)[];
+    /** Resolved raw text — used by raw-family nodes (@code, @mermaid, @raw, @kbd, @fn). */
+    raw?: string;
+    level?: number;
+    title?: string;
+    language?: string;
+    uri?: string;
+    id?: string;
+    imgOptions?: Record<string, string>;
+    color?: string;
+    /** @list only — true when `@list(ordered)`; unset/false renders as a bullet list. */
+    ordered?: boolean;
+    /** @fn only — parsed integer form of `raw`. */
+    number?: number;
+    /** Synthetic `type: 'list-item'` nodes only (built by Parser.buildListItems, never a real @command) — set when the item's line had an explicit "N. "/"N)" prefix, so @list(ordered) can restart/resume numbering via `<li value>`. */
+    marker?: number;
+    /** @table (from its @cols child) — each column is inline content (text + a curated set of formatting nodes, see registry.ts's isCellAllowedNode). */
+    columns?: (DocASTNode | string)[][];
+    /** @table (from its @data child) — each row is a list of cells, each cell inline content like `columns`. */
+    rows?: (DocASTNode | string)[][][];
+    tabs?: DocASTNode[];
+    meta?: Record<string, string>;
+}
+/** Non-fatal parse issue — surfaced to the editor as a marker instead of aborting the parse. */
+export interface DocDiagnostic {
+    start: number;
+    end: number;
+    message: string;
+    /**
+     * Marker tier. Absent means 'error' (the historical behavior, and what every
+     * pre-existing diagnosis site still emits). 'warning' flags constructs that
+     * parse but almost certainly not the way the author meant (e.g. an @raw
+     * escape that swallowed the intended closing bracket); 'info' is a
+     * non-judgmental heads-up (e.g. "this @] is an escape, it won't end the
+     * node"). Neither blocks parsing or rendering.
+     */
+    severity?: 'error' | 'warning' | 'info';
+}
+export declare class DocSyntaxError extends Error {
+    constructor(message: string);
+}
+/**
+ * The supported preview style: index, the neutral default presentation.
+ */
+export type PreviewStyle = 'index';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IAEb,kKAAkK;IAClK,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,+GAA+G;IAC/G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,gGAAgG;IAChG,OAAO,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC;IAEjC,uFAAuF;IACvF,GAAG,CAAC,EAAE,MAAM,CAAC;IAGb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sOAAsO;IACtO,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,qJAAqJ;IACrJ,OAAO,CAAC,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,CAAC;IACpC,4GAA4G;IAC5G,IAAI,CAAC,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,gGAAgG;AAChG,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;CACzC;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC"}

package/dist/types.js

@@ -0,0 +1,7 @@
+export class DocSyntaxError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DocSyntaxError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA0DA,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}