@poe-platform/safe-js 0.1.0

package/dist/toolcraft-design/internal/theme-state.d.ts

@@ -0,0 +1,12 @@
+export interface ThemeConfig {
+    brand: string;
+    label: string;
+}
+export declare function configureTheme(patch: {
+    brand?: string;
+    label?: string;
+}): void;
+export declare function getThemeConfig(): ThemeConfig;
+export declare function getThemeRevision(): number;
+export declare function isThemeBrandConfigured(): boolean;
+export declare function resetTheme(): void;

package/dist/toolcraft-design/prompts/index.d.ts

@@ -0,0 +1,91 @@
+import type { CANCEL } from "./interactive/cancel-symbol.js";
+import { type SelectOption } from "./interactive/select.js";
+import { cancel, isCancel } from "./primitives/cancel.js";
+import { intro } from "./primitives/intro.js";
+import { log } from "./primitives/log.js";
+import { note } from "./primitives/note.js";
+import { outro } from "./primitives/outro.js";
+import { spinner } from "./primitives/spinner.js";
+export { isCancel, cancel, log };
+export { intro, outro, note, spinner };
+export declare function introPlain(title: string): void;
+export interface SelectOptions<Value> {
+    message: string;
+    options: Array<SelectOption<Value>>;
+    initialValue?: Value;
+    maxItems?: number;
+    signal?: AbortSignal;
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}
+export declare function select<Value>(opts: SelectOptions<Value>): Promise<Value | typeof CANCEL>;
+export interface MultiselectOptions<Value> {
+    message: string;
+    options: Array<SelectOption<Value>>;
+    initialValues?: Value[];
+    required?: boolean;
+    maxItems?: number;
+    signal?: AbortSignal;
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}
+/**
+ * Prompts the user to select one or more values from a list.
+ *
+ * Returns the selected values as an array, or a cancellation symbol if the
+ * user cancels. Use `isCancel` to check for cancellation.
+ *
+ * @example
+ * const result = await multiselect({
+ *   message: "Pick workflows to run",
+ *   options: [{ label: "Fix Vulnerabilities", value: "fix-vulnerabilities" }],
+ *   required: true
+ * });
+ * if (!isCancel(result)) {
+ *   // result is Value[]
+ * }
+ */
+export declare function multiselect<Value>(opts: MultiselectOptions<Value>): Promise<Value[] | typeof CANCEL>;
+export interface TextOptions {
+    message: string;
+    placeholder?: string;
+    defaultValue?: string;
+    initialValue?: string;
+    validate?: (value: string) => string | Error | undefined;
+    signal?: AbortSignal;
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}
+export declare function text(opts: TextOptions): Promise<string | typeof CANCEL>;
+export interface ConfirmOptions {
+    message: string;
+    initialValue?: boolean;
+    signal?: AbortSignal;
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}
+export declare function confirm(opts: ConfirmOptions): Promise<boolean | typeof CANCEL>;
+export declare class PromptCancelledError extends Error {
+    constructor(message?: string);
+}
+export declare function confirmOrCancel(opts: ConfirmOptions): Promise<boolean>;
+export interface PasswordOptions {
+    message: string;
+    validate?: (value: string) => string | Error | undefined;
+    signal?: AbortSignal;
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}
+export declare function password(opts: PasswordOptions): Promise<string | typeof CANCEL>;
+export type SpinnerOptions = {
+    start: (message?: string) => void;
+    stop: (message?: string, code?: number) => void;
+    message: (message?: string) => void;
+};
+export interface WithSpinnerOptions<T> {
+    message: string | (() => string);
+    fn: () => Promise<T>;
+    stopMessage?: (result: T) => string;
+    subtext?: (result: T) => string | undefined;
+}
+export declare function withSpinner<T>(options: WithSpinnerOptions<T>): Promise<T>;

package/dist/toolcraft-design/prompts/interactive/cancel-symbol.d.ts

@@ -0,0 +1,2 @@
+export declare const CANCEL: unique symbol;
+export declare function isCancel(value: unknown): value is typeof CANCEL;

package/dist/toolcraft-design/prompts/interactive/select.d.ts

@@ -0,0 +1,18 @@
+import { CANCEL } from "./cancel-symbol.js";
+export interface SelectOption<Value> {
+    value: Value;
+    label: string;
+    hint?: string;
+    disabled?: boolean;
+}
+export interface SelectOptions<Value> {
+    message: string;
+    options: Array<SelectOption<Value>>;
+    initialValue?: Value;
+    maxItems?: number;
+    signal?: AbortSignal;
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}
+export declare function findNonDisabled<Value>(start: number, direction: 1 | -1, options: Array<SelectOption<Value>>): number;
+export declare function selectPrompt<Value>(opts: SelectOptions<Value>): Promise<Value | typeof CANCEL>;

package/dist/toolcraft-design/prompts/primitives/cancel.d.ts

@@ -0,0 +1,2 @@
+export { isCancel } from "../interactive/cancel-symbol.js";
+export declare function cancel(msg?: string): void;

package/dist/toolcraft-design/prompts/primitives/intro.d.ts

@@ -0,0 +1 @@
+export declare function intro(title: string): void;

package/dist/toolcraft-design/prompts/primitives/log.d.ts

@@ -0,0 +1,18 @@
+export interface LogMessageOptions {
+    symbol?: string;
+    secondarySymbol?: string;
+    spacing?: number;
+    withGuide?: boolean;
+}
+export declare function message(msg: string, options?: LogMessageOptions): void;
+export declare function info(msg: string): void;
+export declare function success(msg: string): void;
+export declare function warn(msg: string): void;
+export declare function error(msg: string): void;
+export declare const log: {
+    info: typeof info;
+    success: typeof success;
+    message: typeof message;
+    warn: typeof warn;
+    error: typeof error;
+};

package/dist/toolcraft-design/prompts/primitives/note.d.ts

@@ -0,0 +1 @@
+export declare function note(message: string, title?: string): void;

package/dist/toolcraft-design/prompts/primitives/outro.d.ts

@@ -0,0 +1 @@
+export declare function outro(message: string): void;

package/dist/toolcraft-design/prompts/primitives/spinner.d.ts

@@ -0,0 +1,6 @@
+export interface SpinnerOptions {
+    start: (message?: string) => void;
+    stop: (message?: string, code?: number) => void;
+    message: (message?: string) => void;
+}
+export declare function spinner(): SpinnerOptions;

package/dist/toolcraft-design/prompts/theme.d.ts

@@ -0,0 +1,11 @@
+export declare const promptTheme: {
+    readonly symbols: {
+        readonly initial: "◆";
+        readonly active: "◆";
+        readonly inactive: "○";
+        readonly success: "◇";
+    };
+    readonly style: {
+        readonly accentColor: string;
+    };
+};

package/dist/toolcraft-design/screen/screen.d.ts

@@ -0,0 +1,40 @@
+import type { CellStyle, Rect } from "../dashboard/types.js";
+import { type PackedStyle } from "./style.js";
+export interface Cell {
+    ch: string;
+    width: 1 | 2;
+    style: PackedStyle;
+    fg: number;
+    bg: number;
+}
+export interface ScreenSize {
+    cols: number;
+    rows: number;
+}
+export interface ScreenSurface {
+    readonly width: number;
+    readonly height: number;
+    put(x: number, y: number, text: string, style?: CellStyle | PackedStyle): void;
+    clearRect(rect: Rect, style?: CellStyle | PackedStyle): void;
+}
+export declare class Screen {
+    private cols;
+    private rows;
+    private front;
+    private back;
+    private outputStyle;
+    private readonly colors;
+    constructor(size?: ScreenSize, options?: {
+        colors?: boolean;
+    });
+    get width(): number;
+    get height(): number;
+    resize(size: ScreenSize): void;
+    cell(x: number, y: number, ch: string, style?: PackedStyle): void;
+    text(x: number, y: number, text: string, style?: PackedStyle): void;
+    put(x: number, y: number, text: string, style?: CellStyle | PackedStyle): void;
+    clearRect(rect: Rect, style?: CellStyle | PackedStyle): void;
+    flush(): string;
+    private index;
+    private inBounds;
+}

package/dist/toolcraft-design/screen/style.d.ts

@@ -0,0 +1,16 @@
+export declare const STYLE_BOLD: number;
+export declare const STYLE_DIM: number;
+export declare const STYLE_UNDERLINE: number;
+export declare const STYLE_INVERSE: number;
+export type PackedStyle = number;
+export declare function packStyle(style: {
+    bold?: boolean;
+    dim?: boolean;
+    underline?: boolean;
+    inverse?: boolean;
+    fg?: number;
+    bg?: number;
+}): PackedStyle;
+export declare function foreground(style: PackedStyle): number;
+export declare function background(style: PackedStyle): number;
+export declare function styleToSgrDelta(previous: PackedStyle, next: PackedStyle, colors?: boolean): string;

package/dist/toolcraft-design/static/index.d.ts

@@ -0,0 +1,4 @@
+export { SPINNER_FRAMES, renderSpinnerFrame, renderSpinnerStopped } from "./spinner.js";
+export type { SpinnerFrameOptions, SpinnerStoppedOptions } from "./spinner.js";
+export { renderMenu } from "./menu.js";
+export type { MenuOption, RenderMenuOptions } from "./menu.js";

package/dist/toolcraft-design/static/menu.d.ts

@@ -0,0 +1,11 @@
+export interface MenuOption {
+    label: string;
+    value: string;
+    hint?: string;
+}
+export interface RenderMenuOptions {
+    message: string;
+    options: MenuOption[];
+    selectedIndex?: number;
+}
+export declare function renderMenu(opts: RenderMenuOptions): string;

package/dist/toolcraft-design/static/spinner.d.ts

@@ -0,0 +1,14 @@
+export declare const SPINNER_FRAMES: readonly ["◒", "◐", "◓", "◑"];
+export interface SpinnerFrameOptions {
+    frame?: number;
+    message: string;
+    timer?: string;
+}
+export declare function renderSpinnerFrame(options: SpinnerFrameOptions): string;
+export interface SpinnerStoppedOptions {
+    message: string;
+    code?: number;
+    timer?: string;
+    subtext?: string;
+}
+export declare function renderSpinnerStopped(options: SpinnerStoppedOptions): string;

package/dist/toolcraft-design/terminal/driver.d.ts

@@ -0,0 +1,34 @@
+import { type TerminalInputEvent } from "./input.js";
+export interface Size {
+    cols: number;
+    rows: number;
+}
+export interface TerminalDriver {
+    start(): void;
+    stop(): void;
+    onEvent(fn: (event: TerminalInputEvent) => void): () => void;
+    onResize(fn: (size: Size) => void): () => void;
+    getSize(): Size;
+    writeFrame(ansi: string): void;
+}
+interface InputStream {
+    setRawMode?: (enabled: boolean) => void;
+    resume(): void;
+    pause(): void;
+    on(event: "data", listener: (chunk: Buffer | string) => void): unknown;
+    off(event: "data", listener: (chunk: Buffer | string) => void): unknown;
+}
+interface OutputStream {
+    columns?: number;
+    rows?: number;
+    write(value: string): boolean;
+    on(event: "resize", listener: () => void): unknown;
+    off(event: "resize", listener: () => void): unknown;
+}
+export declare function createTerminalDriver(options?: {
+    input?: InputStream;
+    output?: OutputStream;
+    escTimeoutMs?: number;
+    mouse?: boolean;
+}): TerminalDriver;
+export type { TerminalInputEvent } from "./input.js";

package/dist/toolcraft-design/terminal/input.d.ts

@@ -0,0 +1,25 @@
+export type TerminalInputEvent = {
+    type: "key";
+    name: string;
+    ch?: string;
+    ctrl: boolean;
+    alt: boolean;
+    shift: boolean;
+} | {
+    type: "paste";
+    text: string;
+} | {
+    type: "wheel";
+    direction: "up" | "down";
+    x: number;
+    y: number;
+};
+export interface InputParser {
+    feed(chunk: Buffer): TerminalInputEvent[];
+    flush(): TerminalInputEvent[];
+    destroy(): void;
+}
+export declare function createInputParser(options?: {
+    escTimeoutMs?: number;
+    onEvent?: (event: TerminalInputEvent) => void;
+}): InputParser;

package/dist/toolcraft-design/terminal-markdown/ast.d.ts

@@ -0,0 +1,98 @@
+export type MdRange = {
+    start: number;
+    end: number;
+};
+export type CodeTokenKind = "anchor" | "at-rule" | "attribute" | "boolean" | "color" | "command" | "comment" | "decorator" | "directive" | "flag" | "function" | "identifier" | "important" | "invalid" | "key" | "keyword" | "label" | "null" | "number" | "operator" | "parameter" | "plain" | "property" | "punctuation" | "regex" | "selector" | "string" | "tag" | "template" | "type" | "variable";
+export type CodeToken = {
+    kind: CodeTokenKind;
+    value: string;
+};
+type MdNodeWithRange = {
+    range?: MdRange;
+};
+export type MdNode = MdNodeWithRange & ({
+    type: "root";
+    children: MdNode[];
+} | {
+    type: "heading";
+    depth: 1 | 2 | 3 | 4 | 5 | 6;
+    children: MdNode[];
+} | {
+    type: "paragraph";
+    children: MdNode[];
+} | {
+    type: "blockquote";
+    children: MdNode[];
+} | {
+    type: "code";
+    lang?: string;
+    meta?: string;
+    value: string;
+    tokens?: CodeToken[];
+} | {
+    type: "list";
+    ordered: boolean;
+    start?: number;
+    children: MdNode[];
+} | {
+    type: "listItem";
+    checked?: boolean;
+    children: MdNode[];
+} | {
+    type: "thematicBreak";
+} | {
+    type: "table";
+    align: Array<"left" | "center" | "right" | null>;
+    children: MdNode[];
+} | {
+    type: "tableRow";
+    children: MdNode[];
+} | {
+    type: "tableCell";
+    children: MdNode[];
+} | {
+    type: "html";
+    value: string;
+} | {
+    type: "text";
+    value: string;
+} | {
+    type: "emphasis";
+    children: MdNode[];
+} | {
+    type: "strong";
+    children: MdNode[];
+} | {
+    type: "strikethrough";
+    children: MdNode[];
+} | {
+    type: "inlineCode";
+    value: string;
+} | {
+    type: "link";
+    url: string;
+    title?: string;
+    children: MdNode[];
+} | {
+    type: "image";
+    url: string;
+    alt: string;
+    title?: string;
+} | {
+    type: "break";
+} | {
+    type: "frontmatter";
+    data: Record<string, unknown>;
+} | {
+    type: "alert";
+    kind: "NOTE" | "TIP" | "IMPORTANT" | "WARNING" | "CAUTION";
+    children: MdNode[];
+} | {
+    type: "footnoteDefinition";
+    label: string;
+    children: MdNode[];
+} | {
+    type: "footnoteReference";
+    label: string;
+});
+export {};

package/dist/toolcraft-design/terminal-markdown/html-renderer.d.ts

@@ -0,0 +1,7 @@
+import type { MdNode } from "./ast.js";
+export interface HtmlRenderOptions {
+    showFrontmatter?: boolean;
+    allowRawHtml?: boolean;
+    syntaxHighlight?: boolean;
+}
+export declare function renderHtml(ast: MdNode, options?: HtmlRenderOptions): string;

package/dist/toolcraft-design/terminal-markdown/index.d.ts

@@ -0,0 +1,12 @@
+import { type HtmlRenderOptions } from "./html-renderer.js";
+import { type RenderOptions } from "./renderer.js";
+export type { CodeToken, CodeTokenKind, MdNode } from "./ast.js";
+export { renderHtml } from "./html-renderer.js";
+export type { HtmlRenderOptions } from "./html-renderer.js";
+export { renderPlaintext, renderMarkdownPlaintext } from "./plaintext-renderer.js";
+export type { PlaintextRenderOptions } from "./plaintext-renderer.js";
+export { parse } from "./parser.js";
+export { render } from "./renderer.js";
+export type { RenderOptions } from "./renderer.js";
+export declare function renderMarkdown(markdown: string, options?: RenderOptions): string;
+export declare function renderMarkdownHtml(markdown: string, options?: HtmlRenderOptions): string;

package/dist/toolcraft-design/terminal-markdown/parser.d.ts

@@ -0,0 +1,5 @@
+import type { MdNode } from "./ast.js";
+export declare function parse(markdown: string): {
+    frontmatter?: Record<string, unknown>;
+    ast: MdNode;
+};

package/dist/toolcraft-design/terminal-markdown/plaintext-renderer.d.ts

@@ -0,0 +1,11 @@
+import type { MdNode } from "./ast.js";
+export interface PlaintextRenderOptions {
+    announceHeadings?: boolean;
+    announceCode?: boolean;
+    announceAlerts?: boolean;
+    showLinks?: boolean;
+    expandLinks?: boolean;
+    includeFrontmatter?: boolean;
+}
+export declare function renderPlaintext(ast: MdNode, options?: PlaintextRenderOptions): string;
+export declare function renderMarkdownPlaintext(markdown: string, options?: PlaintextRenderOptions): string;

package/dist/toolcraft-design/terminal-markdown/renderer.d.ts

@@ -0,0 +1,7 @@
+import type { MdNode } from "./ast.js";
+export interface RenderOptions {
+    width?: number;
+    showFrontmatter?: boolean;
+    syntaxHighlight?: boolean;
+}
+export declare function render(ast: MdNode, options?: RenderOptions): string;

package/dist/toolcraft-design/tokens/brand.d.ts

@@ -0,0 +1,5 @@
+export interface Brand {
+    name: string;
+    primary: string;
+}
+export declare const brands: Record<string, Brand>;

package/dist/toolcraft-design/tokens/colors.d.ts

@@ -0,0 +1,37 @@
+import { type Brand } from "./brand.js";
+export declare const brand: string;
+export type ThemeName = "dark" | "light";
+export interface ThemeCellStyle {
+    fg?: string;
+    bold?: boolean;
+    dim?: boolean;
+    underline?: boolean;
+}
+export interface ThemeCellStyles {
+    accent: ThemeCellStyle;
+    muted: ThemeCellStyle;
+    success: ThemeCellStyle;
+    warning: ThemeCellStyle;
+    error: ThemeCellStyle;
+    info: ThemeCellStyle;
+}
+export interface ThemePalette {
+    header: (text: string) => string;
+    divider: (text: string) => string;
+    prompt: (text: string) => string;
+    number: (text: string) => string;
+    intro: (text: string) => string;
+    resolvedSymbol: string;
+    errorSymbol: string;
+    accent: (text: string) => string;
+    muted: (text: string) => string;
+    success: (text: string) => string;
+    warning: (text: string) => string;
+    error: (text: string) => string;
+    info: (text: string) => string;
+    badge: (text: string) => string;
+    styles: ThemeCellStyles;
+}
+export declare function createPalette(activeBrand: Brand, mode: ThemeName): ThemePalette;
+export declare const dark: ThemePalette;
+export declare const light: ThemePalette;

package/dist/toolcraft-design/tokens/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./colors.js";
+export { brands } from "./brand.js";
+export type { Brand } from "./brand.js";
+export { spacing } from "./spacing.js";
+export { typography } from "./typography.js";
+export { widths } from "./widths.js";

package/dist/toolcraft-design/tokens/spacing.d.ts

@@ -0,0 +1,6 @@
+export declare const spacing: {
+    readonly sm: 1;
+    readonly md: 2;
+    readonly lg: 4;
+    readonly xl: 8;
+};

package/dist/toolcraft-design/tokens/typography.d.ts

@@ -0,0 +1,7 @@
+export declare const typography: {
+    readonly bold: (text: string) => string;
+    readonly dim: (text: string) => string;
+    readonly italic: (text: string) => string;
+    readonly underline: (text: string) => string;
+    readonly strikethrough: (text: string) => string;
+};

package/dist/toolcraft-design/tokens/widths.d.ts

@@ -0,0 +1,5 @@
+export declare const widths: {
+    readonly header: 60;
+    readonly helpColumn: 24;
+    readonly maxLine: 80;
+};