@fuzdev/fuz_ui 0.204.0 → 0.205.0

package/dist/mdz_components.d.ts

@@ -1,63 +0,0 @@
-import type { Component } from 'svelte';
-/**
- * Component registry for custom Svelte components that can be used in mdz content.
- *
- * For example, registering 'Alert' allows using `<Alert>...</Alert>` in mdz content.
- *
- * The Map values are the Svelte component constructors.
- */
-export type MdzComponents = Map<string, Component<any, any>>;
-/**
- * Element registry for HTML elements that can be used in mdz content.
- *
- * For example, registering 'div' allows using `<div>...</div>` in mdz content.
- *
- * The Map values are boolean placeholders for future configuration options.
- */
-export type MdzElements = Map<string, boolean>;
-/**
- * Context for providing custom mdz components via a getter function.
- * Set to a getter (e.g., `() => components`) so changes are reflected reactively.
- */
-export declare const mdz_components_context: {
-    get: (error_message?: string) => () => MdzComponents | undefined;
-    get_maybe: () => (() => MdzComponents | undefined) | undefined;
-    set: (value: () => MdzComponents | undefined) => () => MdzComponents | undefined;
-};
-/**
- * Context for providing allowed HTML elements via a getter function.
- * Set to a getter (e.g., `() => elements`) so changes are reflected reactively.
- * By default, no HTML elements are allowed.
- */
-export declare const mdz_elements_context: {
-    get: (error_message?: string) => () => MdzElements | undefined;
-    get_maybe: () => (() => MdzElements | undefined) | undefined;
-    set: (value: () => MdzElements | undefined) => () => MdzElements | undefined;
-};
-/**
- * Context for providing a base path getter for resolving relative links in mdz content.
- * Set to a getter (e.g., `() => base`) so changes to the base prop are reflected
- * without needing an effect. When the getter returns a path like `'/docs/mdz/'`,
- * relative paths like `./grammar` resolve to `/docs/mdz/grammar` before rendering.
- * When not set, relative paths use raw hrefs (browser resolves them).
- */
-export declare const mdz_base_context: {
-    get: (error_message?: string) => () => string | undefined;
-    get_maybe: () => (() => string | undefined) | undefined;
-    set: (value: () => string | undefined) => () => string | undefined;
-};
-interface MdzGetterContext<T> {
-    get_maybe(): (() => T | undefined) | undefined;
-    set(value: () => T | undefined): unknown;
-}
-/**
- * Set an mdz context to a getter that prefers the local `value_fn` and falls
- * back to the ancestor's value when `value_fn()` returns `undefined`.
- *
- * Pass `value_fn` as a getter (not a snapshot) so prop changes remain reactive.
- * The ancestor lookup happens once at component init — that's intentional, it
- * captures the surrounding scope's context at mount time.
- */
-export declare const set_mdz_context_with_fallback: <T>(context: MdzGetterContext<T>, value_fn: () => T | undefined) => void;
-export {};
-//# sourceMappingURL=mdz_components.d.ts.map

package/dist/mdz_components.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mdz_components.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/mdz_components.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,QAAQ,CAAC;AAItC;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,sBAAsB;2CAAwB,aAAa,GAAG,SAAS;4BAAzB,aAAa,GAAG,SAAS;uBAAzB,aAAa,GAAG,SAAS,WAAzB,aAAa,GAAG,SAAS;CAAG,CAAC;AAExF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;2CAAwB,WAAW,GAAG,SAAS;4BAAvB,WAAW,GAAG,SAAS;uBAAvB,WAAW,GAAG,SAAS,WAAvB,WAAW,GAAG,SAAS;CAAG,CAAC;AAEpF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;2CAAwB,MAAM,GAAG,SAAS;4BAAlB,MAAM,GAAG,SAAS;uBAAlB,MAAM,GAAG,SAAS,WAAlB,MAAM,GAAG,SAAS;CAAG,CAAC;AAE3E,UAAU,gBAAgB,CAAC,CAAC;IAC3B,SAAS,IAAI,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC/C,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,GAAI,CAAC,EAC9C,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAC5B,UAAU,MAAM,CAAC,GAAG,SAAS,KAC3B,IAGF,CAAC"}

package/dist/mdz_components.js

@@ -1,32 +0,0 @@
-import { create_context } from './context_helpers.js';
-/**
- * Context for providing custom mdz components via a getter function.
- * Set to a getter (e.g., `() => components`) so changes are reflected reactively.
- */
-export const mdz_components_context = create_context();
-/**
- * Context for providing allowed HTML elements via a getter function.
- * Set to a getter (e.g., `() => elements`) so changes are reflected reactively.
- * By default, no HTML elements are allowed.
- */
-export const mdz_elements_context = create_context();
-/**
- * Context for providing a base path getter for resolving relative links in mdz content.
- * Set to a getter (e.g., `() => base`) so changes to the base prop are reflected
- * without needing an effect. When the getter returns a path like `'/docs/mdz/'`,
- * relative paths like `./grammar` resolve to `/docs/mdz/grammar` before rendering.
- * When not set, relative paths use raw hrefs (browser resolves them).
- */
-export const mdz_base_context = create_context();
-/**
- * Set an mdz context to a getter that prefers the local `value_fn` and falls
- * back to the ancestor's value when `value_fn()` returns `undefined`.
- *
- * Pass `value_fn` as a getter (not a snapshot) so prop changes remain reactive.
- * The ancestor lookup happens once at component init — that's intentional, it
- * captures the surrounding scope's context at mount time.
- */
-export const set_mdz_context_with_fallback = (context, value_fn) => {
-    const ancestor = context.get_maybe();
-    context.set(() => value_fn() ?? ancestor?.());
-};

package/dist/mdz_helpers.d.ts

@@ -1,164 +0,0 @@
-/**
- * Shared constants and pure helper functions for mdz parsers.
- *
- * Used by both the single-pass parser (`mdz.ts`) and the two-phase
- * lexer+parser (`mdz_lexer.ts` + `mdz_token_parser.ts`).
- *
- * @module
- */
-import type { MdzNode, MdzComponentNode, MdzElementNode } from './mdz.js';
-export declare const BACKTICK = 96;
-export declare const ASTERISK = 42;
-export declare const UNDERSCORE = 95;
-export declare const TILDE = 126;
-export declare const NEWLINE = 10;
-export declare const HYPHEN = 45;
-export declare const HASH = 35;
-export declare const SPACE = 32;
-export declare const TAB = 9;
-export declare const LEFT_ANGLE = 60;
-export declare const RIGHT_ANGLE = 62;
-export declare const SLASH = 47;
-export declare const LEFT_BRACKET = 91;
-export declare const RIGHT_BRACKET = 93;
-export declare const LEFT_PAREN = 40;
-export declare const RIGHT_PAREN = 41;
-export declare const COLON = 58;
-export declare const PERIOD = 46;
-export declare const COMMA = 44;
-export declare const SEMICOLON = 59;
-export declare const EXCLAMATION = 33;
-export declare const QUESTION = 63;
-export declare const DOLLAR = 36;
-export declare const PERCENT = 37;
-export declare const AMPERSAND = 38;
-export declare const APOSTROPHE = 39;
-export declare const PLUS = 43;
-export declare const EQUALS = 61;
-export declare const AT = 64;
-export declare const A_UPPER = 65;
-export declare const Z_UPPER = 90;
-export declare const A_LOWER = 97;
-export declare const Z_LOWER = 122;
-export declare const ZERO = 48;
-export declare const NINE = 57;
-export declare const HR_HYPHEN_COUNT = 3;
-export declare const MIN_CODEBLOCK_BACKTICKS = 3;
-export declare const MAX_HEADING_LEVEL = 6;
-export declare const HTTPS_PREFIX_LENGTH = 8;
-export declare const HTTP_PREFIX_LENGTH = 7;
-export declare const H_LOWER = 104;
-export declare const H_UPPER = 72;
-/**
- * Lowercase an ASCII letter code; passes other chars through.
- * Mirrors the `[A-Z] → [a-z]` shift without touching non-ASCII.
- */
-export declare const ascii_to_lower: (char_code: number) => number;
-/**
- * Case-insensitive URL scheme prefix check. Returns the prefix length
- * (8 for `https://`, 7 for `http://`) or 0 if neither matches at `pos`.
- *
- * URI schemes are case-insensitive per RFC 3986 §3.1, and mobile keyboards
- * routinely auto-capitalize the first letter of a sentence, producing
- * `Https://` etc. The original case is preserved in the emitted reference —
- * browsers normalize schemes themselves.
- */
-export declare const match_url_prefix_case_insensitive: (s: string, pos: number) => 0 | 7 | 8;
-/**
- * Check if character code is a letter (A-Z, a-z).
- */
-export declare const is_letter: (char_code: number) => boolean;
-/**
- * Check if character code is valid for tag name (letter, number, hyphen, underscore).
- */
-export declare const is_tag_name_char: (char_code: number) => boolean;
-/**
- * Check if character is part of a word for word boundary detection.
- * Used to prevent intraword emphasis with `_` and `~` delimiters.
- *
- * Only alphanumeric characters (A-Z, a-z, 0-9) are word characters.
- * Formatting delimiters (`*`, `_`, `~`) fall outside all three ranges,
- * so they're naturally excluded without explicit checks.
- *
- * This prevents false positives with snake_case identifiers while allowing
- * adjacent formatting like `**bold**_italic_`.
- */
-export declare const is_word_char: (char_code: number) => boolean;
-export declare const is_valid_path_char: (char_code: number) => boolean;
-/**
- * Trim trailing punctuation from URL/path per RFC 3986 and GFM rules.
- * - Trims simple trailing: .,;:!?]
- * - Balanced logic for () only (valid in path components)
- *
- * Note on `]`: the mdz parsers (`mdz.ts`, `mdz_stream_parser_url.ts`,
- * `mdz_lexer.ts`) scan URL/path chars through `is_valid_path_char`, which
- * already rejects `]` — so it can never reach this function via parser flow.
- * The `]` branch here is for external callers using this helper directly on
- * arbitrary URL-ish input (it is part of the published `@fuzdev/fuz_ui`
- * surface, see `mdz_helpers.test.ts` for direct coverage).
- *
- * Optimized to avoid O(n²) string slicing - tracks end index and slices once at the end.
- */
-export declare const trim_trailing_punctuation: (url: string) => string;
-/**
- * Extract a single tag (component or element) if it's the only non-whitespace content.
- * Returns the tag node if paragraph wrapping should be skipped (MDX convention),
- * or null if the content should be wrapped in a paragraph.
- */
-/**
- * Check if position in text is the start of an absolute path (starts with `/`).
- * Must be preceded by whitespace or be at the start of the string.
- * Rejects `//` (comments/protocol-relative) and slash followed by whitespace.
- */
-export declare const is_at_absolute_path: (text: string, index: number) => boolean;
-/**
- * Check if position in text is the start of a relative path (`./` or `../`).
- * Must be preceded by whitespace or be at the start of the string.
- * Rejects prefix followed by whitespace, slash, or end of string.
- */
-export declare const is_at_relative_path: (text: string, index: number) => boolean;
-/**
- * Extracts plain text content from an array of mdz nodes, recursing into children.
- */
-export declare const mdz_text_content: (nodes: Array<MdzNode>) => string;
-/**
- * Generates a lowercase slug id for a heading from its child nodes.
- * Follows standard markdown conventions (GitHub, etc.) where heading IDs are lowercased.
- * For case-preserving IDs (e.g. API declarations), see `docs_slugify` in `docs_helpers.svelte.ts`.
- */
-export declare const mdz_heading_id: (nodes: Array<MdzNode>) => string;
-/**
- * Generates a lowercase slug id for a heading from plain text content.
- * Used by the streaming parser which tracks text content directly
- * rather than building `MdzNode[]` trees.
- */
-export declare const mdz_heading_id_from_text: (text: string) => string;
-export declare const mdz_is_url: (s: string) => boolean;
-export declare const mdz_is_safe_reference: (reference: string) => boolean;
-/**
- * Resolves a relative path (`./` or `../`) against a base path.
- * The base is treated as a directory regardless of trailing slash
- * (`'/docs/mdz'` and `'/docs/mdz/'` behave identically).
- * Handles embedded `.` and `..` segments within the reference
- * (e.g., `'./a/../b'` → navigates up then down).
- * Clamps at root — excess `..` segments stop at `/` rather than escaping.
- *
- * @param reference - a relative path starting with `./` or `../`
- * @param base - An absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
- * @returns an absolute resolved path (e.g., `'/docs/mdz/grammar'`)
- */
-export declare const resolve_relative_path: (reference: string, base: string) => string;
-/**
- * Push a node into a children array, coalescing with the previous Text node.
- * Mutates `prev.content` and `prev.end` when both are Text, avoiding array growth
- * and an extra allocation. Callers must own `dest` and not retain references to
- * the prior last element across the call.
- */
-export declare const mdz_push_merging_text: (dest: Array<MdzNode>, node: MdzNode) => void;
-/**
- * Return a new array with adjacent Text nodes merged into single nodes.
- * Fast path: returns the original array when no merging is needed.
- */
-export declare const mdz_merge_adjacent_text: (nodes: Array<MdzNode>) => Array<MdzNode>;
-export declare const extract_single_tag: (nodes: Array<MdzNode>) => MdzComponentNode | MdzElementNode | null;
-//# sourceMappingURL=mdz_helpers.d.ts.map

package/dist/mdz_helpers.d.ts.map

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