@oh-my-pi/pi-utils 17.2.8 → 17.2.10

package/dist/types/turndown/gfm.d.ts

@@ -0,0 +1,11 @@
+import type { TurndownPlugin } from "./types.js";
+/** Install GitHub fenced code blocks selected by `highlight-source-*` wrappers. */
+export declare const highlightedCodeBlock: TurndownPlugin;
+/** Install GFM strikethrough conversion. */
+export declare const strikethrough: TurndownPlugin;
+/** Install GFM task-list checkbox conversion. */
+export declare const taskListItems: TurndownPlugin;
+/** Install GFM table conversion for tables with a heading row. */
+export declare const tables: TurndownPlugin;
+/** Install every GFM rule used by the coding agent. */
+export declare const gfm: TurndownPlugin;

package/dist/types/turndown/html.d.ts

@@ -0,0 +1,5 @@
+import type { TurndownNode } from "./types.js";
+/** Parse an HTML fragment into the small DOM subset needed by Turndown. */
+export declare function parseHtmlFragment(html: string): TurndownNode;
+/** Serialize a standards-shaped or internal HTML node. */
+export declare function serializeNode(node: TurndownNode): string;

package/dist/types/turndown/service.d.ts

@@ -0,0 +1,21 @@
+import type { ResolvedTurndownOptions, RuleFilter, TurndownNode, TurndownOptions, TurndownPlugin, TurndownRule } from "./types.js";
+/** Convert HTML fragments to Markdown with extensible Turndown-compatible rules. */
+export default class TurndownService {
+    #private;
+    readonly options: ResolvedTurndownOptions;
+    constructor(options?: TurndownOptions);
+    /** Install a highest-priority named conversion rule. */
+    addRule(key: string, rule: TurndownRule): this;
+    /** Preserve matching elements as HTML when no custom rule handles them. */
+    keep(filter: RuleFilter): this;
+    /** Drop matching elements and all of their converted content. */
+    remove(filter: RuleFilter): this;
+    /** Install one plugin or an ordered list of plugins. */
+    use(plugin: TurndownPlugin | readonly TurndownPlugin[]): this;
+    /** Escape Markdown punctuation using Turndown's public escaping rules. */
+    escape(text: string): string;
+    /** Convert an HTML string or standards-shaped DOM node to Markdown. */
+    turndown(input: string | TurndownNode): string;
+    /** Convert only a node's children within the active conversion. */
+    convertChildren(node: TurndownNode): string;
+}

package/dist/types/turndown/types.d.ts

@@ -0,0 +1,70 @@
+/** Behavior-compatible reimplementation of turndown's used surface. */
+/** A DOM-shaped node accepted by conversion rules. */
+export interface TurndownNode {
+    readonly nodeType: number;
+    readonly nodeName: string;
+    readonly parentNode: TurndownNode | null;
+    readonly childNodes: ArrayLike<TurndownNode>;
+    readonly children: ArrayLike<TurndownNode>;
+    readonly firstChild: TurndownNode | null;
+    readonly lastChild: TurndownNode | null;
+    readonly nextSibling: TurndownNode | null;
+    readonly previousSibling: TurndownNode | null;
+    readonly textContent: string | null;
+    readonly outerHTML?: string;
+    getAttribute(name: string): string | null;
+    hasAttribute(name: string): boolean;
+}
+/** Options supported by the HTML-to-Markdown converter. */
+export interface TurndownOptions {
+    headingStyle?: "setext" | "atx";
+    hr?: string;
+    bulletListMarker?: "*" | "-" | "+";
+    codeBlockStyle?: "indented" | "fenced";
+    fence?: string;
+    emDelimiter?: "_" | "*";
+    strongDelimiter?: "**" | "__";
+    linkStyle?: "inlined" | "referenced";
+    linkReferenceStyle?: "full" | "collapsed" | "shortcut";
+    preformattedCode?: boolean;
+    blankReplacement?: ReplacementFunction;
+    keepReplacement?: ReplacementFunction;
+    defaultReplacement?: ReplacementFunction;
+}
+/** Fully resolved options passed to replacement callbacks. */
+export interface ResolvedTurndownOptions {
+    headingStyle: "setext" | "atx";
+    hr: string;
+    bulletListMarker: "*" | "-" | "+";
+    codeBlockStyle: "indented" | "fenced";
+    fence: string;
+    emDelimiter: "_" | "*";
+    strongDelimiter: "**" | "__";
+    linkStyle: "inlined" | "referenced";
+    linkReferenceStyle: "full" | "collapsed" | "shortcut";
+    preformattedCode: boolean;
+    blankReplacement?: ReplacementFunction;
+    keepReplacement?: ReplacementFunction;
+    defaultReplacement?: ReplacementFunction;
+}
+/** A tag name, list of tag names, or predicate selecting nodes for a rule. */
+export type RuleFilter = string | readonly string[] | ((node: TurndownNode, options: ResolvedTurndownOptions) => boolean);
+/** Produces Markdown for a matched node and its already-converted children. */
+export type ReplacementFunction = (content: string, node: TurndownNode, options: ResolvedTurndownOptions) => string;
+/** A named conversion rule accepted by `addRule`. */
+export interface TurndownRule {
+    filter: RuleFilter;
+    replacement: ReplacementFunction;
+}
+/** A plugin that installs one or more conversion rules. */
+export type TurndownPlugin = (service: TurndownServiceLike) => void;
+/** Structural service surface available to plugins. */
+export interface TurndownServiceLike {
+    readonly options: ResolvedTurndownOptions;
+    addRule(key: string, rule: TurndownRule): this;
+    convertChildren(node: TurndownNode): string;
+    keep(filter: RuleFilter): this;
+    remove(filter: RuleFilter): this;
+    turndown(input: string | TurndownNode): string;
+    escape(text: string): string;
+}

package/dist/types/turndown.d.ts

@@ -0,0 +1,4 @@
+/** Behavior-compatible reimplementation of turndown's used surface. */
+export * from "./turndown/gfm.js";
+export { default, default as TurndownService } from "./turndown/service.js";
+export * from "./turndown/types.js";

package/dist/types/version.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Compare two version strings.
+ *
+ * Canonical comparator that supersedes the historical in-repo copies
+ * (update-cli, hackage scraper, release scripts):
+ * - inputs are trimmed and at most one leading `v`/`V` is stripped
+ * - dot-separated segments are compared numerically, missing trailing
+ *   segments count as 0, so `1.2` === `1.2.0` and any segment count works
+ * - a SemVer-2.0 prerelease suffix sorts before the plain release
+ *   (`1.0.0-beta` < `1.0.0`); prerelease identifiers follow SemVer order
+ *   (numeric < alphanumeric, numeric compared by value, alphanumeric
+ *   compared lexically, longer sets of equal fields win)
+ * - SemVer build metadata begins at the first `+` and does not participate
+ *   in precedence; it is stripped before core/prerelease parsing
+ * - malformed numeric segments compare as 0 (`1.2.x` === `1.2.0`)
+ * - never throws; returns only -1 | 0 | 1
+ */
+export declare function compareVersions(a: string, b: string): number;

package/dist/types/vterm/buffer.d.ts

@@ -0,0 +1,99 @@
+/** Cell rendition tracked by the virtual terminal. */
+export interface CellAttributes {
+    bold: boolean;
+    dim: boolean;
+    italic: boolean;
+    underline: boolean;
+    inverse: boolean;
+    strikethrough: boolean;
+    overline: boolean;
+    fgMode: 0 | 1 | 2;
+    fg: number;
+    bgMode: 0 | 1 | 2;
+    bg: number;
+}
+/** A mutable terminal grid cell. */
+export interface CellData {
+    chars: string;
+    width: number;
+    attrs: CellAttributes;
+}
+/** Creates the default rendition. */
+export declare function defaultAttributes(): CellAttributes;
+/** Creates an empty cell with the supplied rendition. */
+export declare function blankCell(attrs?: CellAttributes): CellData;
+/** Proposed xterm-compatible cell readback object. */
+export declare class BufferCell {
+    #private;
+    /** Reuses this object for another grid cell. */
+    setFrom(cell: CellData): this;
+    /** Returns the grapheme stored in this cell. */
+    getChars(): string;
+    /** Returns the cell width, with zero denoting a wide-cell continuation. */
+    getWidth(): number;
+    /** Returns the packed foreground palette index or RGB value. */
+    getFgColor(): number;
+    /** Returns the packed background palette index or RGB value. */
+    getBgColor(): number;
+    /** Reports bold rendition. */
+    isBold(): number;
+    /** Reports dim rendition. */
+    isDim(): number;
+    /** Reports italic rendition. */
+    isItalic(): number;
+    /** Reports underline rendition. */
+    isUnderline(): number;
+    /** Reports inverse rendition. */
+    isInverse(): number;
+    /** Reports strikethrough rendition. */
+    isStrikethrough(): number;
+    /** Reports overline rendition. */
+    isOverline(): number;
+    /** Reports a true-color foreground. */
+    isFgRGB(): boolean;
+    /** Reports a true-color background. */
+    isBgRGB(): boolean;
+    /** Reports a palette foreground. */
+    isFgPalette(): boolean;
+    /** Reports a palette background. */
+    isBgPalette(): boolean;
+}
+/** One physical row in a terminal buffer. */
+export declare class BufferLine {
+    cells: CellData[];
+    isWrapped: boolean;
+    constructor(columns: number, attrs?: CellAttributes);
+    /** Number of grid columns in the line. */
+    get length(): number;
+    /** Reads a cell, optionally reusing the caller's object. */
+    getCell(column: number, cell?: BufferCell): BufferCell | undefined;
+    /** Converts a column range to text. */
+    translateToString(trimRight?: boolean, startColumn?: number, endColumn?: number): string;
+}
+/** Storage backing one terminal screen and its history. */
+export interface BufferState {
+    lines: BufferLine[];
+    baseY: number;
+    viewportY: number;
+    cursorX: number;
+    cursorY: number;
+}
+/** Public xterm-compatible view over a buffer state. */
+export declare class BufferView {
+    private readonly state;
+    constructor(state: () => BufferState);
+    /** Number of physical lines, including scrollback. */
+    get length(): number;
+    /** First row of the live screen in the full buffer. */
+    get baseY(): number;
+    /** First row currently exposed by the viewport. */
+    get viewportY(): number;
+    /** Cursor column in the live screen. */
+    get cursorX(): number;
+    /** Cursor row in the live screen. */
+    get cursorY(): number;
+    /** Reads a physical buffer line. */
+    getLine(row: number): BufferLine | undefined;
+    /** Creates a reusable empty cell readback object. */
+    getNullCell(): BufferCell;
+}

package/dist/types/vterm/terminal.d.ts

@@ -0,0 +1,44 @@
+import { BufferView } from "./buffer.js";
+/** Construction options supported by the headless virtual terminal. */
+export interface TerminalOptions {
+    cols?: number;
+    rows?: number;
+    scrollback?: number;
+    allowProposedApi?: boolean;
+    disableStdin?: boolean;
+}
+/** Disposable event subscription. */
+export interface Disposable {
+    dispose(): void;
+}
+/** Observable terminal modes used by interactive input normalization. */
+export interface TerminalModes {
+    applicationCursorKeysMode: boolean;
+}
+/** Buffer collection exposed by the virtual terminal. */
+export interface TerminalBuffers {
+    readonly active: BufferView;
+    readonly normal: BufferView;
+    readonly alternate: BufferView;
+}
+/** Behavior-compatible reimplementation of @xterm/headless's used surface. */
+export declare class Terminal {
+    #private;
+    /** Current terminal column count. */
+    cols: number;
+    /** Current terminal row count. */
+    rows: number;
+    /** Normal, alternate, and active buffer views. */
+    readonly buffer: TerminalBuffers;
+    /** Currently active input modes. */
+    readonly modes: TerminalModes;
+    constructor(options?: TerminalOptions);
+    /** Parses terminal output and invokes the callback after the write is committed. */
+    write(data: string | Uint8Array, callback?: () => void): void;
+    /** Changes the terminal grid and reflows wrapped normal-buffer lines. */
+    resize(columns: number, rows: number): void;
+    /** Subscribes to terminal-generated input replies. */
+    onData(listener: (data: string) => void): Disposable;
+    /** Releases parser state and event listeners. */
+    dispose(): void;
+}

package/dist/types/vterm.d.ts

@@ -0,0 +1,8 @@
+/** Behavior-compatible reimplementation of @xterm/headless's used surface. */
+export * from "./vterm/buffer.js";
+export * from "./vterm/terminal.js";
+import { Terminal } from "./vterm/terminal.js";
+declare const vterm: {
+    Terminal: typeof Terminal;
+};
+export default vterm;

package/dist/types/xml.d.ts

@@ -0,0 +1,31 @@
+/** Behavior-compatible reimplementation of fast-xml-parser's used surface. */
+/** Context supplied to an array-selection callback. */
+export type XMLArraySelector = (tagName: string, jPath: string, isLeafNode: boolean, isAttribute: boolean | null) => boolean;
+/** Options supported by {@link XMLParser}. */
+export interface XMLParserOptions {
+    /** Omits attributes when true (default). */
+    ignoreAttributes?: boolean;
+    /** Prefix applied to attribute property names. */
+    attributeNamePrefix?: string;
+    /** Property used for text alongside children or attributes. */
+    textNodeName?: string;
+    /** Trims ordinary text and attribute values. */
+    trimValues?: boolean;
+    /** Coerces numeric and boolean element text. */
+    parseTagValue?: boolean;
+    /** Coerces numeric and boolean attribute values. */
+    parseAttributeValue?: boolean;
+    /** Controls entity processing and its expansion ceiling. */
+    processEntities?: boolean | {
+        maxTotalExpansions?: number;
+    };
+    /** Selects element or attribute properties that must always be arrays. */
+    isArray?: XMLArraySelector;
+}
+/** Parses XML into the object shape used by the document converters. */
+export declare class XMLParser {
+    #private;
+    constructor(options?: XMLParserOptions);
+    /** Parses one XML document. */
+    parse(xml: string): unknown;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-utils",
-	"version": "17.2.8",
+	"version": "17.2.10",
 	"description": "Shared utilities for pi packages",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -31,10 +31,7 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "17.2.8",
-		"handlebars": "^4.7.9",
-		"winston": "^3.19.0",
-		"winston-daily-rotate-file": "5.0.0"
+		"@oh-my-pi/pi-natives": "17.2.10"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.14"