@simon_he/vue-tui 1.0.1 → 1.1.0

package/dist/vue/layout/flex.d.ts

@@ -0,0 +1,67 @@
+import type { Rect } from "../../events/manager/types.js";
+export type TFlexDirection = "row" | "column";
+export type TFlexAlign = "start" | "center" | "end" | "stretch";
+export type TFlexJustify = "start" | "center" | "end" | "space-between";
+export type TFlexAlignContent = "start" | "center" | "end" | "space-between" | "stretch";
+export type TFlexSize = number | string;
+export type TFlexMeasureConstraints = Readonly<{
+    maxWidth: number;
+    maxHeight: number;
+    direction: TFlexDirection;
+}>;
+export type TFlexMeasureResult = Readonly<{
+    width?: number;
+    height?: number;
+    w?: number;
+    h?: number;
+}>;
+export type TFlexMeasure = (constraints: TFlexMeasureConstraints) => TFlexMeasureResult;
+export type TFlexItemSlotProps = Readonly<{
+    rect: Rect;
+}>;
+export type BoxEdges = Readonly<{
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}>;
+export type FlexLayoutInputItem = Readonly<{
+    grow: number;
+    shrink: number;
+    basis: TFlexSize | undefined;
+    width: TFlexSize | undefined;
+    height: TFlexSize | undefined;
+    minWidth: TFlexSize | undefined;
+    minHeight: TFlexSize | undefined;
+    maxWidth: TFlexSize | undefined;
+    maxHeight: TFlexSize | undefined;
+    measure: TFlexMeasure | undefined;
+    measureCache: Map<string, {
+        main: number | undefined;
+        cross: number | undefined;
+    }> | undefined;
+    marginTop: number;
+    marginRight: number;
+    marginBottom: number;
+    marginLeft: number;
+    alignSelf: TFlexAlign | undefined;
+}>;
+export type FlexLayoutItem<TItem extends FlexLayoutInputItem = FlexLayoutInputItem> = Readonly<{
+    item: TItem;
+    rect: Rect;
+}>;
+export declare function normalizeCellCount(value: unknown, fallback?: number): number;
+export declare function normalizeOptionalCellCount(value: unknown): number | undefined;
+export declare function normalizeRatio(value: unknown, fallback: number): number;
+export declare function layoutFlexItems<TItem extends FlexLayoutInputItem>(items: readonly TItem[], options: Readonly<{
+    w: number;
+    h: number;
+    direction: TFlexDirection;
+    mainGap: number;
+    crossGap: number;
+    padding: BoxEdges;
+    alignItems: TFlexAlign;
+    justifyContent: TFlexJustify;
+    alignContent: TFlexAlignContent;
+    wrap: boolean;
+}>): FlexLayoutItem<TItem>[];

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

@@ -1,3 +1,6 @@
 import { type TuiMarkdownTheme } from "./theme.js";
-import type { TuiMarkdownBlock, TuiMarkdownNode } from "./types.js";
-export declare function markdownAstToBlocks(nodes: readonly TuiMarkdownNode[], theme: TuiMarkdownTheme): readonly TuiMarkdownBlock[];
+import type { TuiMarkdownBlock, TuiMarkdownImageResolver, TuiMarkdownImageSize, TuiMarkdownNode } from "./types.js";
+export declare function markdownAstToBlocks(nodes: readonly TuiMarkdownNode[], theme: TuiMarkdownTheme, options?: Readonly<{
+    imageResolver?: TuiMarkdownImageResolver;
+    imageSize?: TuiMarkdownImageSize;
+}>): readonly TuiMarkdownBlock[];

package/dist/vue/markdown/document.d.ts

@@ -1,3 +1,4 @@
+import type { TuiMarkdownImageResolver, TuiMarkdownImageSize } from "./types.js";
 import { type TuiMarkdownParser } from "./parser.js";
 import { type TuiMarkdownThemeOverrides } from "./theme.js";
 import type { TuiMarkdownBlock, TuiMarkdownNode, TuiMarkdownVisualRow } from "./types.js";
@@ -9,6 +10,8 @@ import type { WidthProvider } from "../../core/buffer/width.js";
 export declare function buildMarkdownBlocks(content: string, parser: TuiMarkdownParser, options?: Readonly<{
     final?: boolean;
     theme?: TuiMarkdownThemeOverrides;
+    imageResolver?: TuiMarkdownImageResolver;
+    imageSize?: TuiMarkdownImageSize;
 }>): Readonly<{
     nodes: readonly TuiMarkdownNode[];
     blocks: readonly TuiMarkdownBlock[];
@@ -17,4 +20,6 @@ export declare function buildMarkdownVisualRows(content: string, width: number,
     final?: boolean;
     theme?: TuiMarkdownThemeOverrides;
     widthProvider?: WidthProvider;
+    imageResolver?: TuiMarkdownImageResolver;
+    imageSize?: TuiMarkdownImageSize;
 }>): readonly TuiMarkdownVisualRow[];

package/dist/vue/markdown/image-actions.d.ts

@@ -0,0 +1,14 @@
+import type { TuiMarkdownImageActionPayload, TuiMarkdownVisualRow } from "./types.js";
+export declare function findMarkdownImageActionAt(rows: readonly TuiMarkdownVisualRow[], point: Readonly<{
+    cellX: number;
+    cellY: number;
+}>, options: Readonly<{
+    screenRect: Readonly<{
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+    rowOffset: number;
+    clipStart: number;
+}>): TuiMarkdownImageActionPayload | null;

package/dist/vue/markdown/image.d.ts

@@ -0,0 +1,11 @@
+export type TuiMarkdownImageSource = Readonly<{
+    src: string;
+    mime?: string;
+    base64?: string;
+}>;
+export type TuiMarkdownImageDimensions = Readonly<{
+    width: number;
+    height: number;
+}>;
+export declare function sanitizeMarkdownImageSource(src: unknown): TuiMarkdownImageSource | null;
+export declare function readMarkdownImageDimensions(base64: string | undefined): TuiMarkdownImageDimensions | null;

package/dist/vue/markdown/link-actions.d.ts

@@ -0,0 +1,14 @@
+import type { TuiMarkdownLinkActionPayload, TuiMarkdownVisualRow } from "./types.js";
+export declare function findMarkdownLinkActionAt(rows: readonly TuiMarkdownVisualRow[], point: Readonly<{
+    cellX: number;
+    cellY: number;
+}>, options: Readonly<{
+    screenRect: Readonly<{
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+    rowOffset: number;
+    clipStart: number;
+}>): TuiMarkdownLinkActionPayload | null;

package/dist/vue/markdown/math-actions.d.ts

@@ -0,0 +1,14 @@
+import type { TuiMarkdownMathActionPayload, TuiMarkdownVisualRow } from "./types.js";
+export declare function findMarkdownMathActionAt(rows: readonly TuiMarkdownVisualRow[], point: Readonly<{
+    cellX: number;
+    cellY: number;
+}>, options: Readonly<{
+    screenRect: Readonly<{
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+    rowOffset: number;
+    clipStart: number;
+}>): TuiMarkdownMathActionPayload | null;

package/dist/vue/markdown/math.d.ts

@@ -0,0 +1,6 @@
+export type TuiMarkdownInlineMathRender = Readonly<{
+    text: string;
+    supported: boolean;
+}>;
+export declare function renderMarkdownInlineMathSegment(tex: string): TuiMarkdownInlineMathRender;
+export declare function renderMarkdownInlineMath(tex: string): string;

package/dist/vue/markdown/render.d.ts

@@ -1,5 +1,26 @@
 import type { Style, Terminal } from "../../core/types.js";
 import type { TuiMarkdownVisualRow } from "./types.js";
+export declare function markdownImageGraphicId(segment: NonNullable<TuiMarkdownVisualRow["segments"][number]["graphic"]>, identity: string): string;
+export declare function clearMarkdownImageGraphics(terminal: Terminal, rect?: Readonly<{
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}>): void;
+export declare function collectVisibleMarkdownImageGraphicIds(rows: readonly TuiMarkdownVisualRow[], options: Readonly<{
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    rowOffset: number;
+    clipStart: number;
+    isGraphicCovered?: (rect: Readonly<{
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>) => boolean;
+}>): ReadonlySet<string>;
 export declare function paintMarkdownVisualRow(terminal: Terminal, row: TuiMarkdownVisualRow | undefined, options: Readonly<{
     x: number;
     y: number;
@@ -7,4 +28,11 @@ export declare function paintMarkdownVisualRow(terminal: Terminal, row: TuiMarkd
     clipStart?: number;
     baseStyle: Style;
     clear?: boolean;
+    keepGraphicIds?: ReadonlySet<string>;
+    isGraphicCovered?: (rect: Readonly<{
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>) => boolean;
 }>): void;

package/dist/vue/markdown/types.d.ts

@@ -5,10 +5,84 @@ export type TuiMarkdownNode = Readonly<{
     children?: readonly TuiMarkdownNode[];
     [key: string]: unknown;
 }>;
+export type TuiMarkdownImageSize = Readonly<{
+    minWidth?: number;
+    maxWidth?: number;
+    minHeight?: number;
+    maxHeight?: number;
+    preserveAspectRatio?: boolean;
+}>;
+export type TuiMarkdownGraphicSegment = Readonly<{
+    kind: "image";
+    src: string;
+    alt?: string;
+    mime?: string;
+    base64?: string;
+    originalBase64?: string;
+    originalMime?: string;
+    naturalWidth?: number;
+    naturalHeight?: number;
+    displayWidth?: number;
+    displayHeight?: number;
+}>;
+export type TuiMarkdownImageResolverResult = string | null | undefined | Readonly<{
+    base64: string;
+    originalBase64?: string;
+    mime?: string;
+    originalMime?: string;
+}>;
+export type TuiMarkdownImageResolver = (image: TuiMarkdownGraphicSegment) => TuiMarkdownImageResolverResult;
+export type TuiMarkdownImageActionPayload = Readonly<{
+    image: TuiMarkdownGraphicSegment;
+    rect: Readonly<{
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+    cellX: number;
+    cellY: number;
+    rowIndex: number;
+    segmentIndex: number;
+}>;
+export type TuiMarkdownLinkActionPayload = Readonly<{
+    href: string;
+    text: string;
+    rect: Readonly<{
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+    cellX: number;
+    cellY: number;
+    rowIndex: number;
+    segmentIndex: number;
+}>;
+export type TuiMarkdownMathSegment = Readonly<{
+    source: string;
+    raw: string;
+    rendered: boolean;
+}>;
+export type TuiMarkdownMathActionPayload = Readonly<{
+    math: TuiMarkdownMathSegment;
+    rect: Readonly<{
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>;
+    cellX: number;
+    cellY: number;
+    rowIndex: number;
+    segmentIndex: number;
+}>;
 export type TuiMarkdownInlineSegment = Readonly<{
     text: string;
     style?: Style;
     hardBreak?: boolean;
+    graphic?: TuiMarkdownGraphicSegment;
+    mathAction?: TuiMarkdownMathSegment;
 }>;
 export type TuiMarkdownTableCellAlign = "left" | "center" | "right";
 export type TuiMarkdownTableCell = Readonly<{
@@ -25,6 +99,7 @@ export type TuiMarkdownBlock = Readonly<{
     type: "code_block";
     key: string;
     lines: readonly string[];
+    language?: string;
     style?: Style;
     prefixSegments?: readonly TuiMarkdownInlineSegment[];
     continuationPrefixSegments?: readonly TuiMarkdownInlineSegment[];
@@ -49,6 +124,9 @@ export type TuiMarkdownVisualSegment = Readonly<{
     text: string;
     style?: Style;
     cells: number;
+    graphic?: TuiMarkdownGraphicSegment;
+    mathAction?: TuiMarkdownMathSegment;
+    fallbackText?: string;
 }>;
 export type TuiMarkdownVisualRow = Readonly<{
     key: string;