@sayknow-cli/utils 0.3.16 → 0.4.0

package/dist/types/ring.d.ts

@@ -1,93 +0,0 @@
-/**
- * A fixed-capacity circular buffer that supports efficient push/pop/shift/unshift operations.
- * When the buffer is full, adding new items overwrites the oldest items (FIFO behavior).
- *
- * @template T The type of elements stored in the buffer.
- */
-export declare class RingBuffer<T> {
-    #private;
-    readonly capacity: number;
-    /**
-     * Creates a new ring buffer with the specified capacity.
-     *
-     * @param capacity - The maximum number of elements the buffer can hold. Must be positive.
-     */
-    constructor(capacity: number);
-    /**
-     * The number of elements currently in the buffer.
-     */
-    get length(): number;
-    /**
-     * Whether the buffer is at full capacity.
-     */
-    get isFull(): boolean;
-    /**
-     * Whether the buffer is empty (contains no elements).
-     */
-    get isEmpty(): boolean;
-    /**
-     * Adds an item to the end of the buffer.
-     * If the buffer is full, the oldest item is overwritten and returned.
-     *
-     * @param item - The item to add.
-     * @returns The overwritten item if the buffer was full, otherwise `undefined`.
-     */
-    push(item: T): T | undefined;
-    /**
-     * Removes and returns the first (oldest) item from the buffer.
-     *
-     * @returns The removed item, or `undefined` if the buffer is empty.
-     */
-    shift(): T | undefined;
-    /**
-     * Removes and returns the last (newest) item from the buffer.
-     *
-     * @returns The removed item, or `undefined` if the buffer is empty.
-     */
-    pop(): T | undefined;
-    /**
-     * Adds an item to the beginning of the buffer.
-     * If the buffer is full, the newest item is overwritten and returned.
-     *
-     * @param item - The item to add.
-     * @returns The overwritten item if the buffer was full, otherwise `undefined`.
-     */
-    unshift(item: T): T | undefined;
-    /**
-     * Returns the element at the specified index without removing it.
-     * Supports negative indices (e.g., `-1` for the last element).
-     *
-     * @param index - The zero-based index, or negative index from the end.
-     * @returns The element at the index, or `undefined` if the index is out of bounds.
-     */
-    at(index: number): T | undefined;
-    /**
-     * Returns the first (oldest) element without removing it.
-     *
-     * @returns The first element, or `undefined` if the buffer is empty.
-     */
-    peek(): T | undefined;
-    /**
-     * Returns the last (newest) element without removing it.
-     *
-     * @returns The last element, or `undefined` if the buffer is empty.
-     */
-    peekBack(): T | undefined;
-    /**
-     * Removes all elements from the buffer, resetting it to an empty state.
-     */
-    clear(): void;
-    /**
-     * Returns an iterator that yields elements in logical order (oldest to newest).
-     * Allows the buffer to be used with `for...of` loops and spread syntax.
-     *
-     * @yields Elements in FIFO order.
-     */
-    [Symbol.iterator](): Iterator<T>;
-    /**
-     * Creates a new array containing all elements in logical order (oldest to newest).
-     *
-     * @returns A new array with all buffer elements.
-     */
-    toArray(): T[];
-}

package/dist/types/safe-stderr.d.ts

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

package/dist/types/sanitize-text.d.ts

@@ -1,14 +0,0 @@
-/**
- * Strip ANSI escape sequences, remove control characters / lone surrogates,
- * and normalize line endings.
- *
- * Bun-native implementation of the former native `sanitizeText` (see
- * `crates/pi-natives/src/text.rs::sanitize_text`). JavaScript strings are
- * already UTF-16 code-unit arrays. `toWellFormed()` handles the uncommon
- * malformed path; when it changes the input, replacement characters are
- * dropped and the normalized result goes through the well-formed sanitizer.
- *
- * Fast path: well-formed input with no controls or ANSI returns the original
- * string after the control probe.
- */
-export declare function sanitizeText(text: string): string;

package/dist/types/snowflake.d.ts

@@ -1,25 +0,0 @@
-type Snowflake = string & {
-    readonly __brand: unique symbol;
-};
-declare namespace Snowflake {
-    const PATTERN: RegExp;
-    const EPOCH_TIMESTAMP = 1420070400000;
-    const MAX_SEQUENCE = 4194303;
-    function formatParts(dt: number, seq: number): Snowflake;
-    class Source {
-        #private;
-        constructor(sequence?: number);
-        get sequence(): number;
-        set sequence(v: number);
-        reset(): void;
-        generate(timestamp: number): Snowflake;
-    }
-    function next(timestamp?: number): Snowflake;
-    function valid(value: string): value is Snowflake;
-    function lowerbound(timelike: Date | number | Snowflake): Snowflake;
-    function upperbound(timelike: Date | number | Snowflake): Snowflake;
-    function getSequence(value: Snowflake): number;
-    function getTimestamp(value: Snowflake): number;
-    function getDate(value: Snowflake): Date;
-}
-export { Snowflake };

package/dist/types/spawn-env.d.ts

@@ -1,4 +0,0 @@
-export declare function isSafeEnvName(name: string): boolean;
-export declare function isSafeEnvValue(value: string): boolean;
-export declare function shouldForwardSpawnEnvName(name: string): boolean;
-export declare function filterProcessEnv(env: Record<string, string | undefined>): Record<string, string>;

package/dist/types/stream.d.ts

@@ -1,68 +0,0 @@
-export declare function readLines(stream: ReadableStream<Uint8Array>, signal?: AbortSignal): AsyncGenerator<Uint8Array>;
-export declare function readJsonl<T>(stream: ReadableStream<Uint8Array>, signal?: AbortSignal): AsyncGenerator<T>;
-/**
- * Stream parsed JSON objects from SSE `data:` lines.
- *
- * Thin wrapper over {@link readSseEvents}: yields one parsed JSON value per
- * dispatched SSE event, skipping events with empty `data` and stopping at the
- * OpenAI-style `[DONE]` sentinel. If your consumer doesn't care about `event:`
- * names or doesn't need a custom parse step, use this; otherwise call
- * `readSseEvents` directly.
- *
- * @example
- * ```ts
- * for await (const obj of readSseJson(response.body!)) {
- *   console.log(obj);
- * }
- * ```
- */
-export type SseEventObserver = (event: ServerSentEvent) => void;
-export declare function readSseJson<T>(stream: ReadableStream<Uint8Array>, signal?: AbortSignal, onEvent?: SseEventObserver): AsyncGenerator<T>;
-/**
- * A single Server-Sent Event dispatched on a blank-line boundary.
- *
- * - `event` is the value of the most recent `event:` field, or `null` if none.
- * - `data` is the concatenation (joined by `\n`) of every `data:` field in the
- *   event, exactly as required by the SSE spec.
- * - `raw` is the list of decoded non-empty lines that made up the event,
- *   preserved for diagnostic context (error reporting, debugging). The
- *   dispatching blank line is not included.
- */
-export interface ServerSentEvent {
-    event: string | null;
-    data: string;
-    raw: string[];
-}
-/**
- * Stream raw Server-Sent Events from an HTTP response body.
- *
- * Yields one `ServerSentEvent` per blank-line dispatch. The consumer is
- * responsible for parsing `data` (e.g. JSON, plain text, error envelope).
- * Use `readSseJson` instead when every event is a single `data:` JSON object
- * and you don't need access to the `event:` field.
- *
- * Internally backed by a Buffer-based line reader (`ConcatSink`) so chunk
- * concatenation is O(n) and never triggers per-line string slicing of the
- * accumulated buffer.
- *
- * @example
- * ```ts
- * for await (const sse of readSseEvents(response.body!)) {
- *   if (sse.event === "ping") continue;
- *   const obj = JSON.parse(sse.data);
- * }
- * ```
- */
-export declare function readSseEvents(stream: ReadableStream<Uint8Array>, signal?: AbortSignal): AsyncGenerator<ServerSentEvent>;
-/**
- * Parse a complete JSONL string, skipping malformed lines instead of throwing.
- *
- * Uses `Bun.JSONL.parseChunk` internally. On parse errors, the malformed
- * region is skipped up to the next newline and parsing continues.
- *
- * @example
- * ```ts
- * const entries = parseJsonlLenient<MyType>(fileContents);
- * ```
- */
-export declare function parseJsonlLenient<T>(buffer: string): T[];

package/dist/types/tab-spacing.d.ts

@@ -1,12 +0,0 @@
-export declare const MIN_TAB_WIDTH = 1;
-export declare const MAX_TAB_WIDTH = 16;
-export declare const DEFAULT_TAB_WIDTH = 3;
-type TabWidthChangeListener = (width: number) => void;
-export declare function onDefaultTabWidthChange(listener: TabWidthChangeListener): () => void;
-export declare function getDefaultTabWidth(): number;
-export declare function setDefaultTabWidth(width: number): void;
-/**
- * Visible tab width in columns for `file` (from `.editorconfig` + default), or the default when `file` is omitted.
- */
-export declare function getIndentation(file?: string | null, projectDir?: string | null): number;
-export {};

package/dist/types/temp.d.ts

@@ -1,14 +0,0 @@
-export declare class TempDir {
-    #private;
-    private constructor();
-    static createSync(prefix?: string): TempDir;
-    static create(prefix?: string): Promise<TempDir>;
-    path(): string;
-    absolute(): string;
-    remove(): Promise<void>;
-    removeSync(): void;
-    toString(): string;
-    join(...paths: string[]): string;
-    [Symbol.asyncDispose](): Promise<void>;
-    [Symbol.dispose](): void;
-}

package/dist/types/type-guards.d.ts

@@ -1,3 +0,0 @@
-export declare function isRecord(value: unknown): value is Record<string, unknown>;
-export declare function asRecord(value: unknown): Record<string, unknown> | null;
-export declare function toError(value: unknown): Error;

package/dist/types/which.d.ts

@@ -1,39 +0,0 @@
-/**
- * Cache policy for which lookups.
- */
-export declare const enum WhichCachePolicy {
-    /**
-     * Use cached result if available.
-     */
-    Cached = 0,
-    /**
-     * Bypass cache and perform a new lookup.
-     */
-    Bypass = 1,
-    /**
-     * Always update cache.
-     */
-    Fresh = 2,
-    /**
-     * Read-only, serves from cache if present, but doesn't write.
-     */
-    ReadOnly = 3
-}
-export interface WhichOptions extends Bun.WhichOptions {
-    /**
-     * Cache policy for the lookup.
-     * Defaults to `WhichCachePolicy.Fresh`.
-     */
-    cache?: WhichCachePolicy;
-}
-declare function darwinWhich(command: string, _options?: Bun.WhichOptions): string | null;
-export declare const whichFresh: typeof darwinWhich;
-/**
- * Locate binary on PATH (with flexible caching).
- *
- * @param command - Binary name to resolve
- * @param options - Bun.WhichOptions plus `cache` control
- * @returns Filesystem path if found, else null
- */
-export declare function $which(command: string, options?: WhichOptions): string | null;
-export {};