@descent-vtt/spec-brief 0.1.0 → 0.2.0

package/dist/frontmatter.d.ts

@@ -1,68 +1,25 @@
 /**
- * A front-matter reader and editor for the flat subset of YAML briefs use.
+ * A brief's front matter: spec-core's reader and editor, copied into
+ * `src/vendor/spec-core/`, over a brief's lines.
  *
- * Supported: `key: value` at the top level; plain, single-quoted and
- * double-quoted scalars; inline `[a, b]` sequences; block `- item` sequences;
- * `#` comments. Plain scalars follow the YAML 1.2 core schema, so `yes` is a
- * word and `035` keeps its leading zero for whoever reads it as text.
- *
- * Anything richer - nested mappings, block scalars, anchors, tags, a value
- * continued onto the next line - is recognised and reported as unsupported
- * rather than guessed at. A YAML library would parse more, and would be the
- * largest dependency of a package that has none; it would also not give back
- * the line of every value, and an edit that must leave every other line of a
- * file untouched needs exactly that.
+ * The flat subset of YAML briefs use: `key: value` lines, plain and quoted
+ * scalars, inline and block lists, comments. Anything richer is reported as
+ * unsupported rather than guessed at, TOML between `+++` lines included, and
+ * every value keeps its line, so an edit leaves every other line of the file
+ * as it was (ADR-0001). Offsets in what it reads count in the lines joined by
+ * `\n`, which for a brief are its `lines`, not its `text`.
  */
-export interface YamlScalar {
-    readonly text: string;
-    readonly quoted: boolean;
-}
-export type YamlValue = {
-    readonly kind: 'scalar';
-    readonly scalar: YamlScalar;
-} | {
-    readonly kind: 'list';
-    readonly items: readonly YamlScalar[];
-} | {
-    readonly kind: 'unsupported';
-    readonly reason: string;
-};
-export interface FrontMatterEntry {
-    /** The key as written. */
-    readonly key: string;
-    /** The key compared: lower case, without `-` or `_`, so `depends-on` is `dependsOn`. */
-    readonly name: string;
-    /** 0-based line of the key. */
-    readonly line: number;
-    /** 0-based line after the entry's last line. */
-    readonly end: number;
-    readonly value: YamlValue;
-}
-export interface FrontMatterProblem {
-    readonly line: number;
-    readonly message: string;
-}
-export interface FrontMatter {
-    /** 0-based line of the closing delimiter, or -1 when the block is never closed. */
-    readonly close: number;
-    readonly entries: readonly FrontMatterEntry[];
-    readonly problems: readonly FrontMatterProblem[];
-}
-export declare function keyName(key: string): string;
+import { type FrontMatter } from './vendor/spec-core/markdown/index.js';
+export { findEntry, isNull, keyName, parseInline, removeEntry, renderScalar, setEntry, type FrontMatter, type FrontMatterEntry, type FrontMatterProblem, type YamlScalar, type YamlValue, } from './vendor/spec-core/markdown/index.js';
 /** Reads the front matter at the top of `lines`, or `null` when there is none. */
 export declare function readFrontMatter(lines: readonly string[]): FrontMatter | null;
-/** Parses a value written on the key's own line. `text` is trimmed and non-empty. */
-export declare function parseInline(text: string): YamlValue;
-/** Null in the YAML 1.2 core schema: empty, `~` or `null` in any of its three spellings. */
-export declare function isNull(scalar: YamlScalar): boolean;
-/** Renders a string as a scalar that reads back as the same string. */
-export declare function renderScalar(value: string): string;
-export declare function findEntry(frontMatter: FrontMatter | null, key: string): FrontMatterEntry | undefined;
 /**
- * Sets one key, leaving every other line as it was. An existing entry keeps the
- * spelling of its key; a new one goes last. A file with no front matter gains
- * a block.
+ * Sets one key as `setEntry` does, and keeps a comment that followed the old
+ * value on its line: `wave: 2  # after the review` becomes `wave: 3  # after
+ * the review`. spec-core's editor writes the key and the value alone, and a
+ * comment beside a value is often the only record of why it was chosen. A
+ * value over several lines is rewritten as `setEntry` rewrites it.
  */
-export declare function setEntry(lines: readonly string[], frontMatter: FrontMatter | null, key: string, rendered: string): string[];
-/** Removes one key and its value lines; a key that is absent changes nothing. */
-export declare function removeEntry(lines: readonly string[], frontMatter: FrontMatter | null, key: string): string[];
+export declare function setEntryKeepingComment(lines: readonly string[], frontMatter: FrontMatter | null, key: string, rendered: string): string[];
+/** Front matter an edit can be written into: YAML, and closed. */
+export declare function editable(frontMatter: FrontMatter): boolean;

package/dist/frontmatter.js

@@ -1,311 +1,42 @@
 /**
- * A front-matter reader and editor for the flat subset of YAML briefs use.
+ * A brief's front matter: spec-core's reader and editor, copied into
+ * `src/vendor/spec-core/`, over a brief's lines.
  *
- * Supported: `key: value` at the top level; plain, single-quoted and
- * double-quoted scalars; inline `[a, b]` sequences; block `- item` sequences;
- * `#` comments. Plain scalars follow the YAML 1.2 core schema, so `yes` is a
- * word and `035` keeps its leading zero for whoever reads it as text.
- *
- * Anything richer - nested mappings, block scalars, anchors, tags, a value
- * continued onto the next line - is recognised and reported as unsupported
- * rather than guessed at. A YAML library would parse more, and would be the
- * largest dependency of a package that has none; it would also not give back
- * the line of every value, and an edit that must leave every other line of a
- * file untouched needs exactly that.
+ * The flat subset of YAML briefs use: `key: value` lines, plain and quoted
+ * scalars, inline and block lists, comments. Anything richer is reported as
+ * unsupported rather than guessed at, TOML between `+++` lines included, and
+ * every value keeps its line, so an edit leaves every other line of the file
+ * as it was (ADR-0001). Offsets in what it reads count in the lines joined by
+ * `\n`, which for a brief are its `lines`, not its `text`.
  */
-const OPEN = /^---[ \t]*$/;
-const CLOSE = /^(?:---|\.\.\.)[ \t]*$/;
-const KEY = /^([A-Za-z_][\w.-]*)[ \t]*:(?:[ \t]+(.*))?$/;
-const SEQUENCE_ITEM = /^([ \t]*)-(?:[ \t]+(.*))?$/;
-const BLANK_OR_COMMENT = /^[ \t]*(?:#.*)?$/;
-export function keyName(key) {
-    return key.toLowerCase().replace(/[-_]/g, '');
-}
+import { findEntry, readFrontMatter as readText, setEntry } from './vendor/spec-core/markdown/index.js';
+import { textOfLines } from './text.js';
+export { findEntry, isNull, keyName, parseInline, removeEntry, renderScalar, setEntry, } from './vendor/spec-core/markdown/index.js';
 /** Reads the front matter at the top of `lines`, or `null` when there is none. */
 export function readFrontMatter(lines) {
-    if (lines.length === 0 || !OPEN.test(lines[0]))
-        return null;
-    let close = -1;
-    for (let i = 1; i < lines.length; i += 1) {
-        if (CLOSE.test(lines[i])) {
-            close = i;
-            break;
-        }
-    }
-    if (close < 0) {
-        return {
-            close: -1,
-            entries: [],
-            problems: [{ line: 0, message: 'the front matter opened on line 1 is never closed' }],
-        };
-    }
-    const entries = [];
-    const problems = [];
-    const seen = new Map();
-    let i = 1;
-    while (i < close) {
-        const line = lines[i];
-        if (BLANK_OR_COMMENT.test(line)) {
-            i += 1;
-            continue;
-        }
-        const match = KEY.exec(line);
-        if (!match) {
-            problems.push({
-                line: i,
-                message: /^\s/.test(line) ? 'an indented line belongs to no key' : 'not a "key: value" line',
-            });
-            i += 1;
-            continue;
-        }
-        const key = match[1];
-        const inline = stripLeadingComment((match[2] ?? '').trim());
-        let end = i + 1;
-        while (end < close && belongsToBlock(lines[end]))
-            end += 1;
-        while (end > i + 1 && BLANK_OR_COMMENT.test(lines[end - 1]))
-            end -= 1;
-        const block = lines.slice(i + 1, end);
-        let value;
-        if (inline.length > 0) {
-            value = block.some((l) => !BLANK_OR_COMMENT.test(l))
-                ? unsupported('the value continues on the next line; keep it on one line, or quote it')
-                : parseInline(inline);
-        }
-        else {
-            value = parseBlock(block);
-        }
-        const name = keyName(key);
-        const previous = seen.get(name);
-        if (previous !== undefined) {
-            problems.push({ line: i, message: `"${key}" is declared twice (first on line ${previous + 1})` });
-        }
-        else {
-            seen.set(name, i);
-        }
-        entries.push({ key, name, line: i, end, value });
-        i = end;
-    }
-    return { close, entries, problems };
-}
-/** A line under a key is part of its value when it is indented or starts a sequence item. */
-function belongsToBlock(line) {
-    return /^[ \t]/.test(line) || /^-(?:[ \t]|$)/.test(line) || line.trim() === '';
-}
-function stripLeadingComment(text) {
-    return text.startsWith('#') ? '' : text;
-}
-function unsupported(reason) {
-    return { kind: 'unsupported', reason };
-}
-function parseBlock(block) {
-    const content = block.filter((l) => !BLANK_OR_COMMENT.test(l));
-    if (content.length === 0)
-        return { kind: 'scalar', scalar: { text: '', quoted: false } };
-    const first = SEQUENCE_ITEM.exec(content[0]);
-    if (!first) {
-        return KEY.test(content[0].trim())
-            ? unsupported('nested mappings are not supported; flatten the key')
-            : unsupported('the value continues on the next line; keep it on one line, or quote it');
-    }
-    const indent = first[1].length;
-    const items = [];
-    for (const line of content) {
-        const item = SEQUENCE_ITEM.exec(line);
-        if (!item || item[1].length !== indent) {
-            return unsupported('a list item is continued or nested; keep each item on one line');
-        }
-        const text = stripLeadingComment((item[2] ?? '').trim());
-        if (text.length === 0)
-            return unsupported('a list item is empty');
-        const parsed = parseInline(text);
-        if (parsed.kind !== 'scalar') {
-            return parsed.kind === 'list' ? unsupported('nested lists are not supported') : parsed;
-        }
-        items.push(parsed.scalar);
-    }
-    return { kind: 'list', items };
-}
-/** Parses a value written on the key's own line. `text` is trimmed and non-empty. */
-export function parseInline(text) {
-    const head = text.charAt(0);
-    if (head === '"' || head === "'") {
-        const quoted = head === '"' ? readDoubleQuoted(text) : readSingleQuoted(text);
-        if (typeof quoted === 'string')
-            return unsupported(quoted);
-        return trailingIsComment(text.slice(quoted.next))
-            ? { kind: 'scalar', scalar: { text: quoted.text, quoted: true } }
-            : unsupported('text follows a closing quote');
-    }
-    if (head === '[')
-        return parseFlowSequence(text);
-    if (head === '{')
-        return unsupported('inline mappings are not supported');
-    if (head === '|' || head === '>')
-        return unsupported('block scalars are not supported; keep the value on one line');
-    if (head === '&' || head === '*' || head === '!')
-        return unsupported('anchors, aliases and tags are not supported');
-    if (head === '@' || head === '`')
-        return unsupported(`a plain value cannot start with "${head}"; quote it`);
-    const plain = stripTrailingComment(text);
-    if (/:(?:\s|$)/.test(plain))
-        return unsupported('a plain value cannot contain ": "; quote it');
-    if (/^-(?:\s|$)/.test(plain))
-        return unsupported('a list must start on the line after its key');
-    return { kind: 'scalar', scalar: { text: plain, quoted: false } };
-}
-function stripTrailingComment(text) {
-    const hash = text.search(/\s#/);
-    return (hash < 0 ? text : text.slice(0, hash)).trim();
-}
-function trailingIsComment(rest) {
-    return /^\s*(?:#.*)?$/.test(rest) && (rest.trim() === '' || /^\s/.test(rest));
-}
-const ESCAPES = {
-    '"': '"',
-    '\\': '\\',
-    '/': '/',
-    '0': '\0',
-    b: '\b',
-    f: '\f',
-    n: '\n',
-    r: '\r',
-    t: '\t',
-};
-const HEX_ESCAPE_LENGTH = { x: 2, u: 4, U: 8 };
-/** Reads a double-quoted scalar starting at index 0, or returns why it cannot. */
-function readDoubleQuoted(text) {
-    let out = '';
-    for (let i = 1; i < text.length; i += 1) {
-        const ch = text.charAt(i);
-        if (ch === '"')
-            return { text: out, next: i + 1 };
-        if (ch !== '\\') {
-            out += ch;
-            continue;
-        }
-        const code = text.charAt(i + 1);
-        const simple = ESCAPES[code];
-        if (simple !== undefined) {
-            out += simple;
-            i += 1;
-            continue;
-        }
-        const width = HEX_ESCAPE_LENGTH[code];
-        const hex = width === undefined ? '' : text.slice(i + 2, i + 2 + width);
-        if (width === undefined || hex.length !== width || !/^[0-9A-Fa-f]+$/.test(hex)) {
-            return `"\\${code}" is not an escape this reader knows`;
-        }
-        const point = Number.parseInt(hex, 16);
-        if (point > 0x10ffff)
-            return `"\\${code}${hex}" is not a character`;
-        out += String.fromCodePoint(point);
-        i += 1 + width;
-    }
-    return 'a double-quoted value is never closed';
-}
-function readSingleQuoted(text) {
-    let out = '';
-    for (let i = 1; i < text.length; i += 1) {
-        const ch = text.charAt(i);
-        if (ch !== "'") {
-            out += ch;
-            continue;
-        }
-        if (text.charAt(i + 1) === "'") {
-            out += "'";
-            i += 1;
-            continue;
-        }
-        return { text: out, next: i + 1 };
-    }
-    return 'a single-quoted value is never closed';
-}
-function parseFlowSequence(text) {
-    const items = [];
-    let i = 1;
-    for (;;) {
-        while (i < text.length && /\s/.test(text.charAt(i)))
-            i += 1;
-        if (i >= text.length)
-            return unsupported('an inline list is never closed; keep it on one line');
-        const ch = text.charAt(i);
-        if (ch === ']') {
-            return trailingIsComment(text.slice(i + 1))
-                ? { kind: 'list', items }
-                : unsupported('text follows the end of an inline list');
-        }
-        if (ch === '[' || ch === '{')
-            return unsupported('nested lists and mappings are not supported');
-        if (ch === ',')
-            return unsupported('an inline list has an empty item');
-        let item;
-        if (ch === '"' || ch === "'") {
-            const rest = text.slice(i);
-            const quoted = ch === '"' ? readDoubleQuoted(rest) : readSingleQuoted(rest);
-            if (typeof quoted === 'string')
-                return unsupported(quoted);
-            item = { text: quoted.text, quoted: true };
-            i += quoted.next;
-        }
-        else {
-            let j = i;
-            while (j < text.length && !',]'.includes(text.charAt(j)))
-                j += 1;
-            const plain = text.slice(i, j).trim();
-            if (/[[{]/.test(plain) || /:(?:\s|$)/.test(plain) || plain.includes(' #')) {
-                return unsupported(`"${plain}" needs quoting inside an inline list`);
-            }
-            item = { text: plain, quoted: false };
-            i = j;
-        }
-        items.push(item);
-        while (i < text.length && /\s/.test(text.charAt(i)))
-            i += 1;
-        if (i >= text.length)
-            return unsupported('an inline list is never closed; keep it on one line');
-        // After a comma the next pass reads an item or, legally in YAML, the bracket.
-        if (text.charAt(i) === ',')
-            i += 1;
-        else if (text.charAt(i) !== ']')
-            return unsupported('inline list items must be separated by commas');
-    }
-}
-/** Null in the YAML 1.2 core schema: empty, `~` or `null` in any of its three spellings. */
-export function isNull(scalar) {
-    return !scalar.quoted && ['', '~', 'null', 'Null', 'NULL'].includes(scalar.text);
-}
-/** Renders a string as a scalar that reads back as the same string. */
-export function renderScalar(value) {
-    const reserved = /^(?:true|false|null|yes|no|on|off|~)$/i.test(value);
-    const plain = /^[A-Za-z][A-Za-z0-9 ._/+-]*$/.test(value) && !value.endsWith(' ');
-    return plain && !reserved ? value : JSON.stringify(value);
-}
-export function findEntry(frontMatter, key) {
-    const name = keyName(key);
-    return frontMatter?.entries.find((entry) => entry.name === name);
+    return readText(textOfLines(lines));
 }
 /**
- * Sets one key, leaving every other line as it was. An existing entry keeps the
- * spelling of its key; a new one goes last. A file with no front matter gains
- * a block.
+ * Sets one key as `setEntry` does, and keeps a comment that followed the old
+ * value on its line: `wave: 2  # after the review` becomes `wave: 3  # after
+ * the review`. spec-core's editor writes the key and the value alone, and a
+ * comment beside a value is often the only record of why it was chosen. A
+ * value over several lines is rewritten as `setEntry` rewrites it.
  */
-export function setEntry(lines, frontMatter, key, rendered) {
-    if (frontMatter === null)
-        return ['---', `${key}: ${rendered}`, '---', ...lines];
-    if (frontMatter.close < 0)
-        throw new Error('cannot edit front matter that is never closed');
-    const entry = findEntry(frontMatter, key);
-    if (entry === undefined) {
-        return [...lines.slice(0, frontMatter.close), `${key}: ${rendered}`, ...lines.slice(frontMatter.close)];
-    }
-    return [...lines.slice(0, entry.line), `${entry.key}: ${rendered}`, ...lines.slice(entry.end)];
-}
-/** Removes one key and its value lines; a key that is absent changes nothing. */
-export function removeEntry(lines, frontMatter, key) {
+export function setEntryKeepingComment(lines, frontMatter, key, rendered) {
+    const edited = setEntry(lines, frontMatter, key, rendered);
     const entry = findEntry(frontMatter, key);
-    if (entry === undefined)
-        return [...lines];
-    return [...lines.slice(0, entry.line), ...lines.slice(entry.end)];
+    if (entry === undefined || entry.end !== entry.line + 1)
+        return edited;
+    // Offsets count in the lines joined by one character each.
+    const lineStart = lines.slice(0, entry.line).reduce((sum, line) => sum + line.length + 1, 0);
+    const rest = lines[entry.line].slice(entry.valueEnd - lineStart);
+    if (!/^[ \t]+#/.test(rest))
+        return edited;
+    return edited.map((line, i) => (i === entry.line ? `${line}${rest}` : line));
+}
+/** Front matter an edit can be written into: YAML, and closed. */
+export function editable(frontMatter) {
+    return frontMatter.kind === 'yaml' && frontMatter.close >= 0;
 }
 //# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A front-matter reader and editor for the flat subset of YAML briefs use.\n *\n * Supported: `key: value` at the top level; plain, single-quoted and\n * double-quoted scalars; inline `[a, b]` sequences; block `- item` sequences;\n * `#` comments. Plain scalars follow the YAML 1.2 core schema, so `yes` is a\n * word and `035` keeps its leading zero for whoever reads it as text.\n *\n * Anything richer - nested mappings, block scalars, anchors, tags, a value\n * continued onto the next line - is recognised and reported as unsupported\n * rather than guessed at. A YAML library would parse more, and would be the\n * largest dependency of a package that has none; it would also not give back\n * the line of every value, and an edit that must leave every other line of a\n * file untouched needs exactly that.\n */\n\nexport interface YamlScalar {\n  readonly text: string;\n  readonly quoted: boolean;\n}\n\nexport type YamlValue =\n  | { readonly kind: 'scalar'; readonly scalar: YamlScalar }\n  | { readonly kind: 'list'; readonly items: readonly YamlScalar[] }\n  | { readonly kind: 'unsupported'; readonly reason: string };\n\nexport interface FrontMatterEntry {\n  /** The key as written. */\n  readonly key: string;\n  /** The key compared: lower case, without `-` or `_`, so `depends-on` is `dependsOn`. */\n  readonly name: string;\n  /** 0-based line of the key. */\n  readonly line: number;\n  /** 0-based line after the entry's last line. */\n  readonly end: number;\n  readonly value: YamlValue;\n}\n\nexport interface FrontMatterProblem {\n  readonly line: number;\n  readonly message: string;\n}\n\nexport interface FrontMatter {\n  /** 0-based line of the closing delimiter, or -1 when the block is never closed. */\n  readonly close: number;\n  readonly entries: readonly FrontMatterEntry[];\n  readonly problems: readonly FrontMatterProblem[];\n}\n\nconst OPEN = /^---[ \\t]*$/;\nconst CLOSE = /^(?:---|\\.\\.\\.)[ \\t]*$/;\nconst KEY = /^([A-Za-z_][\\w.-]*)[ \\t]*:(?:[ \\t]+(.*))?$/;\nconst SEQUENCE_ITEM = /^([ \\t]*)-(?:[ \\t]+(.*))?$/;\nconst BLANK_OR_COMMENT = /^[ \\t]*(?:#.*)?$/;\n\nexport function keyName(key: string): string {\n  return key.toLowerCase().replace(/[-_]/g, '');\n}\n\n/** Reads the front matter at the top of `lines`, or `null` when there is none. */\nexport function readFrontMatter(lines: readonly string[]): FrontMatter | null {\n  if (lines.length === 0 || !OPEN.test(lines[0] as string)) return null;\n  let close = -1;\n  for (let i = 1; i < lines.length; i += 1) {\n    if (CLOSE.test(lines[i] as string)) {\n      close = i;\n      break;\n    }\n  }\n  if (close < 0) {\n    return {\n      close: -1,\n      entries: [],\n      problems: [{ line: 0, message: 'the front matter opened on line 1 is never closed' }],\n    };\n  }\n\n  const entries: FrontMatterEntry[] = [];\n  const problems: FrontMatterProblem[] = [];\n  const seen = new Map<string, number>();\n  let i = 1;\n  while (i < close) {\n    const line = lines[i] as string;\n    if (BLANK_OR_COMMENT.test(line)) {\n      i += 1;\n      continue;\n    }\n    const match = KEY.exec(line);\n    if (!match) {\n      problems.push({\n        line: i,\n        message: /^\\s/.test(line) ? 'an indented line belongs to no key' : 'not a \"key: value\" line',\n      });\n      i += 1;\n      continue;\n    }\n    const key = match[1] as string;\n    const inline = stripLeadingComment((match[2] ?? '').trim());\n    let end = i + 1;\n    while (end < close && belongsToBlock(lines[end] as string)) end += 1;\n    while (end > i + 1 && BLANK_OR_COMMENT.test(lines[end - 1] as string)) end -= 1;\n    const block = lines.slice(i + 1, end);\n\n    let value: YamlValue;\n    if (inline.length > 0) {\n      value = block.some((l) => !BLANK_OR_COMMENT.test(l))\n        ? unsupported('the value continues on the next line; keep it on one line, or quote it')\n        : parseInline(inline);\n    } else {\n      value = parseBlock(block);\n    }\n\n    const name = keyName(key);\n    const previous = seen.get(name);\n    if (previous !== undefined) {\n      problems.push({ line: i, message: `\"${key}\" is declared twice (first on line ${previous + 1})` });\n    } else {\n      seen.set(name, i);\n    }\n    entries.push({ key, name, line: i, end, value });\n    i = end;\n  }\n  return { close, entries, problems };\n}\n\n/** A line under a key is part of its value when it is indented or starts a sequence item. */\nfunction belongsToBlock(line: string): boolean {\n  return /^[ \\t]/.test(line) || /^-(?:[ \\t]|$)/.test(line) || line.trim() === '';\n}\n\nfunction stripLeadingComment(text: string): string {\n  return text.startsWith('#') ? '' : text;\n}\n\nfunction unsupported(reason: string): YamlValue {\n  return { kind: 'unsupported', reason };\n}\n\nfunction parseBlock(block: readonly string[]): YamlValue {\n  const content = block.filter((l) => !BLANK_OR_COMMENT.test(l));\n  if (content.length === 0) return { kind: 'scalar', scalar: { text: '', quoted: false } };\n  const first = SEQUENCE_ITEM.exec(content[0] as string);\n  if (!first) {\n    return KEY.test((content[0] as string).trim())\n      ? unsupported('nested mappings are not supported; flatten the key')\n      : unsupported('the value continues on the next line; keep it on one line, or quote it');\n  }\n  const indent = (first[1] as string).length;\n  const items: YamlScalar[] = [];\n  for (const line of content) {\n    const item = SEQUENCE_ITEM.exec(line);\n    if (!item || (item[1] as string).length !== indent) {\n      return unsupported('a list item is continued or nested; keep each item on one line');\n    }\n    const text = stripLeadingComment((item[2] ?? '').trim());\n    if (text.length === 0) return unsupported('a list item is empty');\n    const parsed = parseInline(text);\n    if (parsed.kind !== 'scalar') {\n      return parsed.kind === 'list' ? unsupported('nested lists are not supported') : parsed;\n    }\n    items.push(parsed.scalar);\n  }\n  return { kind: 'list', items };\n}\n\n/** Parses a value written on the key's own line. `text` is trimmed and non-empty. */\nexport function parseInline(text: string): YamlValue {\n  const head = text.charAt(0);\n  if (head === '\"' || head === \"'\") {\n    const quoted = head === '\"' ? readDoubleQuoted(text) : readSingleQuoted(text);\n    if (typeof quoted === 'string') return unsupported(quoted);\n    return trailingIsComment(text.slice(quoted.next))\n      ? { kind: 'scalar', scalar: { text: quoted.text, quoted: true } }\n      : unsupported('text follows a closing quote');\n  }\n  if (head === '[') return parseFlowSequence(text);\n  if (head === '{') return unsupported('inline mappings are not supported');\n  if (head === '|' || head === '>') return unsupported('block scalars are not supported; keep the value on one line');\n  if (head === '&' || head === '*' || head === '!') return unsupported('anchors, aliases and tags are not supported');\n  if (head === '@' || head === '`') return unsupported(`a plain value cannot start with \"${head}\"; quote it`);\n  const plain = stripTrailingComment(text);\n  if (/:(?:\\s|$)/.test(plain)) return unsupported('a plain value cannot contain \": \"; quote it');\n  if (/^-(?:\\s|$)/.test(plain)) return unsupported('a list must start on the line after its key');\n  return { kind: 'scalar', scalar: { text: plain, quoted: false } };\n}\n\nfunction stripTrailingComment(text: string): string {\n  const hash = text.search(/\\s#/);\n  return (hash < 0 ? text : text.slice(0, hash)).trim();\n}\n\nfunction trailingIsComment(rest: string): boolean {\n  return /^\\s*(?:#.*)?$/.test(rest) && (rest.trim() === '' || /^\\s/.test(rest));\n}\n\ninterface Quoted {\n  readonly text: string;\n  /** Index just past the closing quote. */\n  readonly next: number;\n}\n\nconst ESCAPES: Readonly<Record<string, string>> = {\n  '\"': '\"',\n  '\\\\': '\\\\',\n  '/': '/',\n  '0': '\\0',\n  b: '\\b',\n  f: '\\f',\n  n: '\\n',\n  r: '\\r',\n  t: '\\t',\n};\n\nconst HEX_ESCAPE_LENGTH: Readonly<Record<string, number>> = { x: 2, u: 4, U: 8 };\n\n/** Reads a double-quoted scalar starting at index 0, or returns why it cannot. */\nfunction readDoubleQuoted(text: string): Quoted | string {\n  let out = '';\n  for (let i = 1; i < text.length; i += 1) {\n    const ch = text.charAt(i);\n    if (ch === '\"') return { text: out, next: i + 1 };\n    if (ch !== '\\\\') {\n      out += ch;\n      continue;\n    }\n    const code = text.charAt(i + 1);\n    const simple = ESCAPES[code];\n    if (simple !== undefined) {\n      out += simple;\n      i += 1;\n      continue;\n    }\n    const width = HEX_ESCAPE_LENGTH[code];\n    const hex = width === undefined ? '' : text.slice(i + 2, i + 2 + width);\n    if (width === undefined || hex.length !== width || !/^[0-9A-Fa-f]+$/.test(hex)) {\n      return `\"\\\\${code}\" is not an escape this reader knows`;\n    }\n    const point = Number.parseInt(hex, 16);\n    if (point > 0x10ffff) return `\"\\\\${code}${hex}\" is not a character`;\n    out += String.fromCodePoint(point);\n    i += 1 + width;\n  }\n  return 'a double-quoted value is never closed';\n}\n\nfunction readSingleQuoted(text: string): Quoted | string {\n  let out = '';\n  for (let i = 1; i < text.length; i += 1) {\n    const ch = text.charAt(i);\n    if (ch !== \"'\") {\n      out += ch;\n      continue;\n    }\n    if (text.charAt(i + 1) === \"'\") {\n      out += \"'\";\n      i += 1;\n      continue;\n    }\n    return { text: out, next: i + 1 };\n  }\n  return 'a single-quoted value is never closed';\n}\n\nfunction parseFlowSequence(text: string): YamlValue {\n  const items: YamlScalar[] = [];\n  let i = 1;\n  for (;;) {\n    while (i < text.length && /\\s/.test(text.charAt(i))) i += 1;\n    if (i >= text.length) return unsupported('an inline list is never closed; keep it on one line');\n    const ch = text.charAt(i);\n    if (ch === ']') {\n      return trailingIsComment(text.slice(i + 1))\n        ? { kind: 'list', items }\n        : unsupported('text follows the end of an inline list');\n    }\n    if (ch === '[' || ch === '{') return unsupported('nested lists and mappings are not supported');\n    if (ch === ',') return unsupported('an inline list has an empty item');\n    let item: YamlScalar;\n    if (ch === '\"' || ch === \"'\") {\n      const rest = text.slice(i);\n      const quoted = ch === '\"' ? readDoubleQuoted(rest) : readSingleQuoted(rest);\n      if (typeof quoted === 'string') return unsupported(quoted);\n      item = { text: quoted.text, quoted: true };\n      i += quoted.next;\n    } else {\n      let j = i;\n      while (j < text.length && !',]'.includes(text.charAt(j))) j += 1;\n      const plain = text.slice(i, j).trim();\n      if (/[[{]/.test(plain) || /:(?:\\s|$)/.test(plain) || plain.includes(' #')) {\n        return unsupported(`\"${plain}\" needs quoting inside an inline list`);\n      }\n      item = { text: plain, quoted: false };\n      i = j;\n    }\n    items.push(item);\n    while (i < text.length && /\\s/.test(text.charAt(i))) i += 1;\n    if (i >= text.length) return unsupported('an inline list is never closed; keep it on one line');\n    // After a comma the next pass reads an item or, legally in YAML, the bracket.\n    if (text.charAt(i) === ',') i += 1;\n    else if (text.charAt(i) !== ']') return unsupported('inline list items must be separated by commas');\n  }\n}\n\n/** Null in the YAML 1.2 core schema: empty, `~` or `null` in any of its three spellings. */\nexport function isNull(scalar: YamlScalar): boolean {\n  return !scalar.quoted && ['', '~', 'null', 'Null', 'NULL'].includes(scalar.text);\n}\n\n/** Renders a string as a scalar that reads back as the same string. */\nexport function renderScalar(value: string): string {\n  const reserved = /^(?:true|false|null|yes|no|on|off|~)$/i.test(value);\n  const plain = /^[A-Za-z][A-Za-z0-9 ._/+-]*$/.test(value) && !value.endsWith(' ');\n  return plain && !reserved ? value : JSON.stringify(value);\n}\n\nexport function findEntry(frontMatter: FrontMatter | null, key: string): FrontMatterEntry | undefined {\n  const name = keyName(key);\n  return frontMatter?.entries.find((entry) => entry.name === name);\n}\n\n/**\n * Sets one key, leaving every other line as it was. An existing entry keeps the\n * spelling of its key; a new one goes last. A file with no front matter gains\n * a block.\n */\nexport function setEntry(\n  lines: readonly string[],\n  frontMatter: FrontMatter | null,\n  key: string,\n  rendered: string,\n): string[] {\n  if (frontMatter === null) return ['---', `${key}: ${rendered}`, '---', ...lines];\n  if (frontMatter.close < 0) throw new Error('cannot edit front matter that is never closed');\n  const entry = findEntry(frontMatter, key);\n  if (entry === undefined) {\n    return [...lines.slice(0, frontMatter.close), `${key}: ${rendered}`, ...lines.slice(frontMatter.close)];\n  }\n  return [...lines.slice(0, entry.line), `${entry.key}: ${rendered}`, ...lines.slice(entry.end)];\n}\n\n/** Removes one key and its value lines; a key that is absent changes nothing. */\nexport function removeEntry(lines: readonly string[], frontMatter: FrontMatter | null, key: string): string[] {\n  const entry = findEntry(frontMatter, key);\n  if (entry === undefined) return [...lines];\n  return [...lines.slice(0, entry.line), ...lines.slice(entry.end)];\n}\n"]}
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,eAAe,IAAI,QAAQ,EAAE,QAAQ,EAAoB,MAAM,sCAAsC,CAAC;AAC1H,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EACL,SAAS,EACT,MAAM,EACN,OAAO,EACP,WAAW,EACX,WAAW,EACX,YAAY,EACZ,QAAQ,GAMT,MAAM,sCAAsC,CAAC;AAE9C,kFAAkF;AAClF,MAAM,UAAU,eAAe,CAAC,KAAwB;IACtD,OAAO,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAwB,EAAE,WAA+B,EAAE,GAAW,EAAE,QAAgB;IAC7H,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACvE,2DAA2D;IAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7F,MAAM,IAAI,GAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IAC7E,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,QAAQ,CAAC,WAAwB;IAC/C,OAAO,WAAW,CAAC,IAAI,KAAK,MAAM,IAAI,WAAW,CAAC,KAAK,IAAI,CAAC,CAAC;AAC/D,CAAC","sourcesContent":["/**\n * A brief's front matter: spec-core's reader and editor, copied into\n * `src/vendor/spec-core/`, over a brief's lines.\n *\n * The flat subset of YAML briefs use: `key: value` lines, plain and quoted\n * scalars, inline and block lists, comments. Anything richer is reported as\n * unsupported rather than guessed at, TOML between `+++` lines included, and\n * every value keeps its line, so an edit leaves every other line of the file\n * as it was (ADR-0001). Offsets in what it reads count in the lines joined by\n * `\\n`, which for a brief are its `lines`, not its `text`.\n */\n\nimport { findEntry, readFrontMatter as readText, setEntry, type FrontMatter } from './vendor/spec-core/markdown/index.js';\nimport { textOfLines } from './text.js';\n\nexport {\n  findEntry,\n  isNull,\n  keyName,\n  parseInline,\n  removeEntry,\n  renderScalar,\n  setEntry,\n  type FrontMatter,\n  type FrontMatterEntry,\n  type FrontMatterProblem,\n  type YamlScalar,\n  type YamlValue,\n} from './vendor/spec-core/markdown/index.js';\n\n/** Reads the front matter at the top of `lines`, or `null` when there is none. */\nexport function readFrontMatter(lines: readonly string[]): FrontMatter | null {\n  return readText(textOfLines(lines));\n}\n\n/**\n * Sets one key as `setEntry` does, and keeps a comment that followed the old\n * value on its line: `wave: 2  # after the review` becomes `wave: 3  # after\n * the review`. spec-core's editor writes the key and the value alone, and a\n * comment beside a value is often the only record of why it was chosen. A\n * value over several lines is rewritten as `setEntry` rewrites it.\n */\nexport function setEntryKeepingComment(lines: readonly string[], frontMatter: FrontMatter | null, key: string, rendered: string): string[] {\n  const edited = setEntry(lines, frontMatter, key, rendered);\n  const entry = findEntry(frontMatter, key);\n  if (entry === undefined || entry.end !== entry.line + 1) return edited;\n  // Offsets count in the lines joined by one character each.\n  const lineStart = lines.slice(0, entry.line).reduce((sum, line) => sum + line.length + 1, 0);\n  const rest = (lines[entry.line] as string).slice(entry.valueEnd - lineStart);\n  if (!/^[ \\t]+#/.test(rest)) return edited;\n  return edited.map((line, i) => (i === entry.line ? `${line}${rest}` : line));\n}\n\n/** Front matter an edit can be written into: YAML, and closed. */\nexport function editable(frontMatter: FrontMatter): boolean {\n  return frontMatter.kind === 'yaml' && frontMatter.close >= 0;\n}\n"]}