@bendyline/squisq 1.5.1 → 2.0.0

package/dist/jsonForm/index.d.ts

@@ -1,5 +1,5 @@
-import { az as Theme, ap as SurfaceScheme } from '../Doc-BBVGq1_9.js';
-import '../types-DlAZ7MW4.js';
+import { aC as Theme, as as SurfaceScheme } from '../Doc-ylqWKDc_.js';
+import '../types-BwMPl2CB.js';
 
 /**
  * JSON Form types — Squisq's hint vocabulary layered on JSON Schema.
@@ -159,8 +159,12 @@ declare function resolveFlag(flag: boolean | SquisqWhen | undefined, rootData: u
  * `/user/role`. `$ref` resolution is local-only (`#/$defs/Foo`).
  */
 
+/** Escape one object-member name for use as an RFC 6901 pointer segment. */
+declare function escapePointerSegment(segment: string): string;
 /** Normalize a path to a JSON Pointer string. Accepts both forms. */
 declare function toPointer(path: string): string;
+/** Append one member name to a dotted path or validated JSON Pointer. */
+declare function appendPointer(base: string, segment: string): string;
 /** Split a JSON Pointer into decoded segments. Empty string → []. */
 declare function pointerSegments(pointer: string): string[];
 /** Read a value from data by path (dotted or pointer). Returns undefined if missing. */
@@ -229,4 +233,4 @@ declare function buildJsonFormTokens(theme: Theme | undefined, surface: SurfaceS
  */
 declare function resolveJsonFormTheme(theme: Theme | undefined, surface: SurfaceScheme | undefined): Theme;
 
-export { type BuildJsonFormTokensOptions, type ControlKind, type InferSchemaOptions, type JsonFormValidationError, type JsonFormValidator, type SquisqAnnotatedSchema, type SquisqHints, type SquisqWhen, arrayItemKind, buildJsonFormTokens, chooseControl, evaluateWhen, getByPointer, inferSchema, pointerSegments, primaryType, resolveFlag, resolveJsonFormTheme, resolveRef, setByPointer, toPointer };
+export { type BuildJsonFormTokensOptions, type ControlKind, type InferSchemaOptions, type JsonFormValidationError, type JsonFormValidator, type SquisqAnnotatedSchema, type SquisqHints, type SquisqWhen, appendPointer, arrayItemKind, buildJsonFormTokens, chooseControl, escapePointerSegment, evaluateWhen, getByPointer, inferSchema, pointerSegments, primaryType, resolveFlag, resolveJsonFormTheme, resolveRef, setByPointer, toPointer };

package/dist/jsonForm/index.js

@@ -1,7 +1,9 @@
 import {
+  appendPointer,
   arrayItemKind,
   buildJsonFormTokens,
   chooseControl,
+  escapePointerSegment,
   evaluateWhen,
   getByPointer,
   inferSchema,
@@ -12,15 +14,18 @@ import {
   resolveRef,
   setByPointer,
   toPointer
-} from "../chunk-T5UK6YOB.js";
-import "../chunk-A4O7GIWE.js";
-import "../chunk-KKNUBQ6Y.js";
-import "../chunk-DLXZMS5K.js";
+} from "../chunk-QTSJOY54.js";
+import "../chunk-LYNJEOAC.js";
+import "../chunk-FVJUUTEM.js";
+import "../chunk-6PJRB2CF.js";
+import "../chunk-5J4HKRJF.js";
 import "../chunk-QE7TWGVT.js";
 export {
+  appendPointer,
   arrayItemKind,
   buildJsonFormTokens,
   chooseControl,
+  escapePointerSegment,
   evaluateWhen,
   getByPointer,
   inferSchema,

package/dist/markdown/index.d.ts

@@ -1,5 +1,6 @@
-import { V as ParseOptions, m as MarkdownDocument, W as StringifyOptions, H as HeadingAttributes, d as HtmlNode, I as MarkdownNode } from '../types-DlAZ7MW4.js';
-export { a as HeadingTemplateAnnotation, b as HtmlComment, c as HtmlElement, e as HtmlText, M as MarkdownBlockNode, f as MarkdownBlockquote, g as MarkdownBreak, h as MarkdownCodeBlock, i as MarkdownContainerDirective, j as MarkdownDefinitionDescription, k as MarkdownDefinitionList, l as MarkdownDefinitionTerm, n as MarkdownEmphasis, o as MarkdownFootnoteDefinition, p as MarkdownFootnoteReference, q as MarkdownHeading, r as MarkdownHtmlBlock, s as MarkdownImage, t as MarkdownImageReference, u as MarkdownInlineCode, v as MarkdownInlineHtml, w as MarkdownInlineMath, x as MarkdownInlineNode, y as MarkdownLeafDirective, z as MarkdownLink, A as MarkdownLinkDefinition, B as MarkdownLinkReference, C as MarkdownList, E as MarkdownListItem, F as MarkdownMathBlock, G as MarkdownMention, J as MarkdownParagraph, K as MarkdownPoint, L as MarkdownSourcePosition, N as MarkdownStrikethrough, O as MarkdownStrong, P as MarkdownTable, Q as MarkdownTableCell, R as MarkdownTableRow, S as MarkdownText, T as MarkdownTextDirective, U as MarkdownThematicBreak } from '../types-DlAZ7MW4.js';
+import { V as ParseOptions, m as MarkdownDocument, W as StringifyOptions, H as HeadingAttributes, d as HtmlNode, I as MarkdownNode } from '../types-BwMPl2CB.js';
+export { a as HeadingTemplateAnnotation, b as HtmlComment, c as HtmlElement, e as HtmlText, M as MarkdownBlockNode, f as MarkdownBlockquote, g as MarkdownBreak, h as MarkdownCodeBlock, i as MarkdownContainerDirective, j as MarkdownDefinitionDescription, k as MarkdownDefinitionList, l as MarkdownDefinitionTerm, n as MarkdownEmphasis, o as MarkdownFootnoteDefinition, p as MarkdownFootnoteReference, q as MarkdownHeading, r as MarkdownHtmlBlock, s as MarkdownImage, t as MarkdownImageReference, u as MarkdownInlineCode, v as MarkdownInlineHtml, w as MarkdownInlineMath, x as MarkdownInlineNode, y as MarkdownLeafDirective, z as MarkdownLink, A as MarkdownLinkDefinition, B as MarkdownLinkReference, C as MarkdownList, E as MarkdownListItem, F as MarkdownMathBlock, G as MarkdownMention, J as MarkdownParagraph, K as MarkdownPoint, L as MarkdownSourcePosition, N as MarkdownStrikethrough, O as MarkdownStrong, P as MarkdownTable, Q as MarkdownTableCell, R as MarkdownTableRow, S as MarkdownText, T as MarkdownTextDirective, U as MarkdownThematicBreak } from '../types-BwMPl2CB.js';
+export { B as BLOCK_META_KEY_DESCRIPTORS, a as BlockMetaKeyDescriptor, K as KNOWN_BLOCK_META_KEYS, b as KnownBlockMetaKey, p as parseTimeSeconds } from '../annotationCoercion-Dr_DY9Hx.js';
 
 /**
  * Markdown → JSON Parser
@@ -244,73 +245,6 @@ declare function needsQuoting(value: string): boolean;
  */
 declare function quoteAttrValue(value: string): string;
 
-/**
- * Heading-attribute value coercion.
- *
- * The Pandoc-style heading attribute block `{#id .class key=value}` parses
- * to a flat `Record<string, string>` of `key → raw value`. This module
- * coerces a known subset of keys to typed values (numbers, time-in-seconds,
- * `BlockConnection[]`) so downstream consumers don't have to re-parse them.
- *
- * Unknown keys are returned in `metadata` as raw strings. Malformed known-key
- * values are dropped from the typed result and reported via `warnings` (the
- * raw string is preserved in `params` upstream for lossless round-tripping —
- * coercion failures do not corrupt the source).
- */
-
-/**
- * Registry of known block-meta keys and their coercion strategies.
- *
- * Adding a new typed key: add an entry here, add the typed field to
- * `HeadingAttributes.blockMeta` in `types.ts`, and apply the coerced value
- * in `markdownToDoc.ts`.
- */
-declare const KNOWN_BLOCK_META_KEYS: {
-    readonly x: "number";
-    readonly y: "number";
-    readonly startTime: "time";
-    readonly duration: "time";
-    readonly connectsTo: "connectionList";
-    readonly transition: "transition";
-    readonly transitionDuration: "time";
-    readonly transitionDirection: "transitionDirection";
-};
-type KnownBlockMetaKey = keyof typeof KNOWN_BLOCK_META_KEYS;
-/**
- * Editor-facing description of a known block-meta key: what it does, and
- * either its closed set of valid values or a free-form format hint. This is
- * the single source the markdown editor's `{[name key=value]}` attribute
- * autocomplete reads from, so the suggestion list stays in lockstep with
- * `KNOWN_BLOCK_META_KEYS` and the transition vocabulary rather than drifting
- * in a hand-maintained copy. `values`/`valueHint` are mutually exclusive: a
- * key has a closed enum (`values`) or a format hint (`valueHint`), not both.
- */
-interface BlockMetaKeyDescriptor {
-    key: KnownBlockMetaKey;
-    /** One-line description, shown as the completion item's detail. */
-    description: string;
-    /** Closed set of valid values, for keys backed by an enum. */
-    values?: readonly string[];
-    /** Format hint shown when the value is free-form (no closed set). */
-    valueHint?: string;
-}
-/**
- * Ordered descriptors for every key in `KNOWN_BLOCK_META_KEYS`. Order is the
- * suggestion display order: the transition family first (the most common
- * authoring case), then timeline timing, then diagram geometry/links.
- */
-declare const BLOCK_META_KEY_DESCRIPTORS: readonly BlockMetaKeyDescriptor[];
-/**
- * Parse a time value to seconds. Accepts:
- * - bare number: `5` → 5, `5.5` → 5.5
- * - `mm:ss`: `01:30` → 90
- * - `mm:ss.ms`: `01:30.500` → 90.5
- * - `1500ms` → 1.5
- *
- * Returns null on malformed input.
- */
-declare function parseTimeSeconds(raw: string): number | null;
-
 /**
  * HTML ↔ HtmlNode Conversion
  *
@@ -442,6 +376,8 @@ declare function parseFrontmatter(yaml: string): Record<string, unknown> | null;
  * blank (no trailing whitespace) so the output diffs cleanly.
  */
 declare function formatBlockScalar(value: string): string;
+/** Quote a frontmatter scalar so it round-trips cleanly through `parseFrontmatter`. */
+declare function formatFrontmatterValue(value: string | number | boolean): string;
 /**
  * Update a markdown source string's YAML frontmatter block, applying the
  * given key/value updates. A `null` or `undefined` value removes the key.
@@ -499,4 +435,4 @@ declare function readFrontmatterThemeId(frontmatter: Record<string, unknown> | u
  */
 declare function plainTextFromInlineHtml(html: string): string;
 
-export { BLOCK_META_KEY_DESCRIPTORS, type BlockMetaKeyDescriptor, HeadingAttributes, HtmlNode, type HtmlPolicy, KNOWN_BLOCK_META_KEYS, type KnownBlockMetaKey, MarkdownDocument, MarkdownNode, ParseOptions, type SanitizeUrlOptions, StringifyOptions, type TrailingAnnotationMatch, type UrlKind, countNodes, createDocument, extractPlainText, findNodesByType, formatBlockScalar, fromMdast, getChildren, inferDocumentTitle, matchTrailingPandocAttr, matchTrailingTemplateAnnotation, needsQuoting, parseFrontmatter, parseHtmlToNodes, parseMarkdown, parsePandocAttrTokens, parseTimeSeconds, plainTextFromInlineHtml, quoteAttrValue, readFrontmatterThemeId, sanitizeHtmlNodes, sanitizeUrl, serializePandocAttributes, setFrontmatterValues, splitKeyValueToken, stringifyHtmlNodes, stringifyMarkdown, toMdast, tokenizeAttrTokens, unquoteAttrValue, walkMarkdownTree };
+export { HeadingAttributes, HtmlNode, type HtmlPolicy, MarkdownDocument, MarkdownNode, ParseOptions, type SanitizeUrlOptions, StringifyOptions, type TrailingAnnotationMatch, type UrlKind, countNodes, createDocument, extractPlainText, findNodesByType, formatBlockScalar, formatFrontmatterValue, fromMdast, getChildren, inferDocumentTitle, matchTrailingPandocAttr, matchTrailingTemplateAnnotation, needsQuoting, parseFrontmatter, parseHtmlToNodes, parseMarkdown, parsePandocAttrTokens, plainTextFromInlineHtml, quoteAttrValue, readFrontmatterThemeId, sanitizeHtmlNodes, sanitizeUrl, serializePandocAttributes, setFrontmatterValues, splitKeyValueToken, stringifyHtmlNodes, stringifyMarkdown, toMdast, tokenizeAttrTokens, unquoteAttrValue, walkMarkdownTree };

package/dist/markdown/index.js

@@ -2,30 +2,34 @@ import {
   sanitizeHtmlNodes,
   sanitizeUrl,
   stringifyMarkdown
-} from "../chunk-6ATE2PSM.js";
+} from "../chunk-R2GC6RLD.js";
+import {
+  fromMdast,
+  parseMarkdown,
+  parsePandocAttrTokens,
+  serializePandocAttributes,
+  toMdast
+} from "../chunk-66QO7XFB.js";
 import {
   BLOCK_META_KEY_DESCRIPTORS,
   KNOWN_BLOCK_META_KEYS,
-  fromMdast,
   matchTrailingPandocAttr,
   matchTrailingTemplateAnnotation,
   needsQuoting,
-  parseMarkdown,
-  parsePandocAttrTokens,
   parseTimeSeconds,
   quoteAttrValue,
-  serializePandocAttributes,
   splitKeyValueToken,
-  toMdast,
   tokenizeAttrTokens,
   unquoteAttrValue
-} from "../chunk-TEEEILMP.js";
+} from "../chunk-R2YZTCLO.js";
+import "../chunk-DBS6RIFL.js";
 import {
   countNodes,
   createDocument,
   extractPlainText,
   findNodesByType,
   formatBlockScalar,
+  formatFrontmatterValue,
   getChildren,
   inferDocumentTitle,
   parseFrontmatter,
@@ -35,8 +39,7 @@ import {
   setFrontmatterValues,
   stringifyHtmlNodes,
   walkMarkdownTree
-} from "../chunk-HWVFJAAH.js";
-import "../chunk-DBS6RIFL.js";
+} from "../chunk-AMIR72JP.js";
 import "../chunk-QE7TWGVT.js";
 export {
   BLOCK_META_KEY_DESCRIPTORS,
@@ -46,6 +49,7 @@ export {
   extractPlainText,
   findNodesByType,
   formatBlockScalar,
+  formatFrontmatterValue,
   fromMdast,
   getChildren,
   inferDocumentTitle,