@rezi-ui/core 0.1.0-beta.1 → 0.1.0-beta.2

package/dist/widgets/markdown/ast.d.ts

@@ -0,0 +1,71 @@
+/**
+ * packages/core/src/widgets/markdown/ast.ts — Markdown AST node types.
+ *
+ * Why: ui.markdown() parses a GitHub-Flavored-Markdown subset into this small
+ * block/inline tree before rendering it onto existing widgets. The AST is
+ * public so applications can pre-parse, cache, or transform documents
+ * (for example block-cached streaming transcripts).
+ */
+/** Inline markdown content node. */
+export type MarkdownInline = Readonly<{
+    kind: "text";
+    text: string;
+}> | Readonly<{
+    kind: "code";
+    text: string;
+}> | Readonly<{
+    kind: "strong";
+    children: readonly MarkdownInline[];
+}> | Readonly<{
+    kind: "em";
+    children: readonly MarkdownInline[];
+}> | Readonly<{
+    kind: "del";
+    children: readonly MarkdownInline[];
+}> | Readonly<{
+    kind: "link";
+    href: string;
+    children: readonly MarkdownInline[];
+}> | Readonly<{
+    kind: "break";
+}>;
+/** Column alignment parsed from a table delimiter row. */
+export type MarkdownTableAlign = "left" | "center" | "right";
+/** One list item; `checked` is null for plain items and boolean for task items. */
+export type MarkdownListItem = Readonly<{
+    checked: boolean | null;
+    blocks: readonly MarkdownBlock[];
+}>;
+/** Block-level markdown node. */
+export type MarkdownBlock = Readonly<{
+    kind: "heading";
+    level: 1 | 2 | 3 | 4 | 5 | 6;
+    children: readonly MarkdownInline[];
+}> | Readonly<{
+    kind: "paragraph";
+    children: readonly MarkdownInline[];
+}> | Readonly<{
+    kind: "codeBlock";
+    language: string;
+    text: string;
+}> | Readonly<{
+    kind: "blockquote";
+    children: readonly MarkdownBlock[];
+}> | Readonly<{
+    kind: "list";
+    ordered: boolean;
+    start: number;
+    items: readonly MarkdownListItem[];
+}> | Readonly<{
+    kind: "hr";
+}> | Readonly<{
+    kind: "table";
+    align: readonly MarkdownTableAlign[];
+    head: readonly (readonly MarkdownInline[])[];
+    rows: readonly (readonly (readonly MarkdownInline[])[])[];
+}>;
+/** Parsed markdown document. */
+export type MarkdownDocument = Readonly<{
+    blocks: readonly MarkdownBlock[];
+}>;
+//# sourceMappingURL=ast.d.ts.map

package/dist/widgets/markdown/ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../../src/widgets/markdown/ast.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oCAAoC;AACpC,MAAM,MAAM,cAAc,GACtB,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACxC,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACxC,QAAQ,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,CAAC,GACjE,QAAQ,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,CAAC,GAC7D,QAAQ,CAAC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,CAAC,GAC9D,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,CAAC,GAC7E,QAAQ,CAAC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEhC,0DAA0D;AAC1D,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7D,mFAAmF;AACnF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAClC,CAAC,CAAC;AAEH,iCAAiC;AACjC,MAAM,MAAM,aAAa,GACrB,QAAQ,CAAC;IACP,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CACrC,CAAC,GACF,QAAQ,CAAC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,CAAC,GACpE,QAAQ,CAAC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/D,QAAQ,CAAC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,CAAC,GACpE,QAAQ,CAAC;IACP,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACpC,CAAC,GACF,QAAQ,CAAC;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,GACxB,QAAQ,CAAC;IACP,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,IAAI,EAAE,SAAS,CAAC,SAAS,cAAc,EAAE,CAAC,EAAE,CAAC;IAC7C,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,SAAS,cAAc,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;CAC3D,CAAC,CAAC;AAEP,gCAAgC;AAChC,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IAAE,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;CAAE,CAAC,CAAC"}

package/dist/widgets/markdown/ast.js

@@ -0,0 +1,10 @@
+/**
+ * packages/core/src/widgets/markdown/ast.ts — Markdown AST node types.
+ *
+ * Why: ui.markdown() parses a GitHub-Flavored-Markdown subset into this small
+ * block/inline tree before rendering it onto existing widgets. The AST is
+ * public so applications can pre-parse, cache, or transform documents
+ * (for example block-cached streaming transcripts).
+ */
+export {};
+//# sourceMappingURL=ast.js.map

package/dist/widgets/markdown/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../../src/widgets/markdown/ast.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/widgets/markdown/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * packages/core/src/widgets/markdown/index.ts — Markdown module surface.
+ */
+import type { MarkdownProps, VNode } from "../types.js";
+export type { MarkdownBlock, MarkdownDocument, MarkdownInline, MarkdownListItem, MarkdownTableAlign, } from "./ast.js";
+export { parseMarkdown } from "./parse.js";
+export { type MarkdownRenderOptions, renderMarkdown, renderMarkdownBlock } from "./render.js";
+export { createMarkdownStream, type MarkdownStream, type MarkdownStreamOptions, } from "./stream.js";
+/**
+ * Renders a GitHub-Flavored-Markdown subset onto existing widgets.
+ *
+ * Supported blocks: headings, paragraphs, fenced/indented code, blockquotes,
+ * nested ordered/unordered lists, task items, thematic breaks, and pipe
+ * tables. Inline: bold, italic, strikethrough, code, links, autolinks, hard
+ * breaks, escapes, and basic entities. Raw HTML renders as literal text.
+ * Parsing never throws; malformed input degrades to plain text.
+ *
+ * For streamed or frequently re-rendered documents, pre-parse with
+ * parseMarkdown() and render cached blocks with renderMarkdown().
+ *
+ * @example
+ * ui.markdown("# Release\n\nShips `ui.markdown` with **GFM subset** support.")
+ */
+export declare function markdown(source: string, props?: Omit<MarkdownProps, "source">): VNode;
+//# sourceMappingURL=index.d.ts.map

package/dist/widgets/markdown/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/widgets/markdown/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIxD,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,KAAK,qBAAqB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAM,GAAG,KAAK,CAOzF"}

package/dist/widgets/markdown/index.js

@@ -0,0 +1,32 @@
+/**
+ * packages/core/src/widgets/markdown/index.ts — Markdown module surface.
+ */
+import { parseMarkdown } from "./parse.js";
+import { renderMarkdown } from "./render.js";
+export { parseMarkdown } from "./parse.js";
+export { renderMarkdown, renderMarkdownBlock } from "./render.js";
+export { createMarkdownStream, } from "./stream.js";
+/**
+ * Renders a GitHub-Flavored-Markdown subset onto existing widgets.
+ *
+ * Supported blocks: headings, paragraphs, fenced/indented code, blockquotes,
+ * nested ordered/unordered lists, task items, thematic breaks, and pipe
+ * tables. Inline: bold, italic, strikethrough, code, links, autolinks, hard
+ * breaks, escapes, and basic entities. Raw HTML renders as literal text.
+ * Parsing never throws; malformed input degrades to plain text.
+ *
+ * For streamed or frequently re-rendered documents, pre-parse with
+ * parseMarkdown() and render cached blocks with renderMarkdown().
+ *
+ * @example
+ * ui.markdown("# Release\n\nShips `ui.markdown` with **GFM subset** support.")
+ */
+export function markdown(source, props = {}) {
+    const { blockGap, key } = props;
+    const options = {
+        ...(blockGap === undefined ? {} : { blockGap }),
+        ...(key === undefined ? {} : { key }),
+    };
+    return renderMarkdown(parseMarkdown(source), options);
+}
+//# sourceMappingURL=index.js.map

package/dist/widgets/markdown/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/widgets/markdown/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAA8B,cAAc,EAAE,MAAM,aAAa,CAAC;AASzE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAA8B,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EACL,oBAAoB,GAGrB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,QAAuC,EAAE;IAChF,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IAChC,MAAM,OAAO,GAA0B;QACrC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC/C,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;KACtC,CAAC;IACF,OAAO,cAAc,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC"}

package/dist/widgets/markdown/parse.d.ts

@@ -0,0 +1,39 @@
+/**
+ * packages/core/src/widgets/markdown/parse.ts — GFM-subset markdown parser.
+ *
+ * Why: ui.markdown() needs a dependency-free, deterministic parser that is
+ * safe on untrusted input (PR bodies, agent output). The grammar is a
+ * pragmatic GitHub-Flavored-Markdown subset:
+ *
+ *   blocks:  ATX headings, paragraphs, fenced code, indented code,
+ *            blockquotes, ordered/unordered lists (nested), task items,
+ *            thematic breaks, pipe tables
+ *   inlines: **strong**, *em*, ~~del~~, `code`, [text](url), <autolinks>,
+ *            bare http(s) URLs, hard breaks, backslash escapes, and basic
+ *            HTML entities
+ *
+ * Intentional divergences from full GFM, kept simple on purpose:
+ *   - no setext headings, reference links, images, footnotes, or raw HTML
+ *     (HTML tags render as literal text)
+ *   - no lazy paragraph continuation inside blockquotes or list items
+ *   - the CommonMark emphasis algorithm is approximated with flanking checks
+ *   - table delimiter rows must contain at least one `|`
+ *
+ * The parser never throws. Malformed constructs degrade to literal text,
+ * nesting depth is bounded, and inline scanning runs on a work budget so
+ * adversarial input (for example long runs of `*` or `[`) cannot trigger
+ * quadratic blowups.
+ */
+import type { MarkdownBlock, MarkdownDocument } from "./ast.js";
+/**
+ * Parses pre-normalized lines into deeply frozen top-level blocks. Internal
+ * surface shared by parseMarkdown() and the streaming parser; when `starts`
+ * is provided it receives the source line index of every top-level block.
+ */
+export declare function parseMarkdownLines(lines: readonly string[], starts?: number[]): MarkdownBlock[];
+/**
+ * Parses a GFM-subset markdown document. Never throws: malformed constructs
+ * degrade to literal text and the result is deeply frozen.
+ */
+export declare function parseMarkdown(source: string): MarkdownDocument;
+//# sourceMappingURL=parse.d.ts.map

package/dist/widgets/markdown/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/widgets/markdown/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAIjB,MAAM,UAAU,CAAC;AAiwBlB;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAI/F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAK9D"}