@reliverse/relinka 1.2.0 → 1.2.1

package/dist-npm/components/core/hook-engine.js

@@ -1,109 +0,0 @@
-import { AsyncLocalStorage, AsyncResource } from "node:async_hooks";
-import { HookError, ValidationError } from "./errors.js";
-const hookStorage = new AsyncLocalStorage();
-function createStore(rl) {
-  const store = {
-    rl,
-    hooks: [],
-    hooksCleanup: [],
-    hooksEffect: [],
-    index: 0,
-    handleChange() {
-    }
-  };
-  return store;
-}
-export function withHooks(rl, cb) {
-  const store = createStore(rl);
-  return hookStorage.run(store, () => {
-    function cycle(render) {
-      store.handleChange = () => {
-        store.index = 0;
-        render();
-      };
-      store.handleChange();
-    }
-    return cb(cycle);
-  });
-}
-function getStore() {
-  const store = hookStorage.getStore();
-  if (!store) {
-    throw new HookError(
-      "[Relinka] Hook functions can only be called from within a prompt"
-    );
-  }
-  return store;
-}
-export function readline() {
-  return getStore().rl;
-}
-export function withUpdates(fn) {
-  const wrapped = (...args) => {
-    const store = getStore();
-    let shouldUpdate = false;
-    const oldHandleChange = store.handleChange;
-    store.handleChange = () => {
-      shouldUpdate = true;
-    };
-    const returnValue = fn(...args);
-    if (shouldUpdate) {
-      oldHandleChange();
-    }
-    store.handleChange = oldHandleChange;
-    return returnValue;
-  };
-  return AsyncResource.bind(wrapped);
-}
-export function withPointer(cb) {
-  const store = getStore();
-  const { index } = store;
-  const pointer = {
-    get() {
-      return store.hooks[index];
-    },
-    set(value) {
-      store.hooks[index] = value;
-    },
-    initialized: index in store.hooks
-  };
-  const returnValue = cb(pointer);
-  store.index++;
-  return returnValue;
-}
-export function handleChange() {
-  getStore().handleChange();
-}
-export const effectScheduler = {
-  queue(cb) {
-    const store = getStore();
-    const { index } = store;
-    store.hooksEffect.push(() => {
-      store.hooksCleanup[index]?.();
-      const cleanFn = cb(readline());
-      if (cleanFn != null && typeof cleanFn !== "function") {
-        throw new ValidationError(
-          "useEffect return value must be a cleanup function or nothing."
-        );
-      }
-      store.hooksCleanup[index] = cleanFn;
-    });
-  },
-  run() {
-    const store = getStore();
-    withUpdates(() => {
-      store.hooksEffect.forEach((effect) => {
-        effect();
-      });
-      store.hooksEffect.length = 0;
-    })();
-  },
-  clearAll() {
-    const store = getStore();
-    store.hooksCleanup.forEach((cleanFn) => {
-      cleanFn?.();
-    });
-    store.hooksEffect.length = 0;
-    store.hooksCleanup.length = 0;
-  }
-};

package/dist-npm/components/core/index.d.ts

@@ -1,13 +0,0 @@
-export * from "./key.js";
-export * from "./errors.js";
-export { usePrefix } from "./use-prefix.js";
-export { useState } from "./use-state.js";
-export { useEffect } from "./use-effect.js";
-export { useMemo } from "./use-memo.js";
-export { useRef } from "./use-ref.js";
-export { useKeypress } from "./use-keypress.js";
-export { makeTheme } from "./make-theme.js";
-export type { Theme, Status } from "./theme.js";
-export { usePagination } from "./use-pagination.js";
-export { createPrompt } from "./create-prompt.js";
-export { Separator } from "./Separator.js";

package/dist-npm/components/core/index.js

@@ -1,12 +0,0 @@
-export * from "./key.js";
-export * from "./errors.js";
-export { usePrefix } from "./use-prefix.js";
-export { useState } from "./use-state.js";
-export { useEffect } from "./use-effect.js";
-export { useMemo } from "./use-memo.js";
-export { useRef } from "./use-ref.js";
-export { useKeypress } from "./use-keypress.js";
-export { makeTheme } from "./make-theme.js";
-export { usePagination } from "./use-pagination.js";
-export { createPrompt } from "./create-prompt.js";
-export { Separator } from "./Separator.js";

package/dist-npm/components/core/key.d.ts

@@ -1,10 +0,0 @@
-export type KeypressEvent = {
-    name: string;
-    ctrl: boolean;
-};
-export declare const isUpKey: (key: KeypressEvent) => boolean;
-export declare const isDownKey: (key: KeypressEvent) => boolean;
-export declare const isSpaceKey: (key: KeypressEvent) => boolean;
-export declare const isBackspaceKey: (key: KeypressEvent) => boolean;
-export declare const isNumberKey: (key: KeypressEvent) => boolean;
-export declare const isEnterKey: (key: KeypressEvent) => boolean;

package/dist-npm/components/core/key.js

@@ -1,16 +0,0 @@
-export const isUpKey = (key) => (
-  
-  key.name === "up" || 
-  key.name === "k" || 
-  key.ctrl && key.name === "p"
-);
-export const isDownKey = (key) => (
-  
-  key.name === "down" || 
-  key.name === "j" || 
-  key.ctrl && key.name === "n"
-);
-export const isSpaceKey = (key) => key.name === "space";
-export const isBackspaceKey = (key) => key.name === "backspace";
-export const isNumberKey = (key) => "123456789".includes(key.name);
-export const isEnterKey = (key) => key.name === "enter" || key.name === "return";

package/dist-npm/components/core/lines.d.ts

@@ -1,14 +0,0 @@
-import { type Prettify } from "../../types/index.js";
-export type Layout<T> = {
-    item: T;
-    index: number;
-    isActive: boolean;
-};
-export declare function lines<T>({ items, width, renderItem, active, position: requested, pageSize, }: {
-    items: readonly T[];
-        width: number;
-        renderItem: (layout: Prettify<Layout<T>>) => string;
-        active: number;
-        position: number;
-        pageSize: number;
-}): string[];

package/dist-npm/components/core/lines.js

@@ -1,52 +0,0 @@
-import { breakLines } from "./utils.js";
-function split(content, width) {
-  return breakLines(content, width).split("\n");
-}
-function rotate(count, items) {
-  const max = items.length;
-  const offset = (count % max + max) % max;
-  return [...items.slice(offset), ...items.slice(0, offset)];
-}
-export function lines({
-  items,
-  width,
-  renderItem,
-  active,
-  position: requested,
-  pageSize
-}) {
-  const layouts = items.map((item, index) => ({
-    item,
-    index,
-    isActive: index === active
-  }));
-  const layoutsInPage = rotate(active - requested, layouts).slice(0, pageSize);
-  const renderItemAt = (index) => layoutsInPage[index] == null ? [] : split(renderItem(layoutsInPage[index]), width);
-  const pageBuffer = Array.from({ length: pageSize });
-  const activeItem = renderItemAt(requested).slice(0, pageSize);
-  const position = requested + activeItem.length <= pageSize ? requested : pageSize - activeItem.length;
-  pageBuffer.splice(position, activeItem.length, ...activeItem);
-  let bufferPointer = position + activeItem.length;
-  let layoutPointer = requested + 1;
-  while (bufferPointer < pageSize && layoutPointer < layoutsInPage.length) {
-    for (const line of renderItemAt(layoutPointer)) {
-      pageBuffer[bufferPointer++] = line;
-      if (bufferPointer >= pageSize) {
-        break;
-      }
-    }
-    layoutPointer++;
-  }
-  bufferPointer = position - 1;
-  layoutPointer = requested - 1;
-  while (bufferPointer >= 0 && layoutPointer >= 0) {
-    for (const line of renderItemAt(layoutPointer).reverse()) {
-      pageBuffer[bufferPointer--] = line;
-      if (bufferPointer < 0) {
-        break;
-      }
-    }
-    layoutPointer--;
-  }
-  return pageBuffer.filter((line) => typeof line === "string");
-}

package/dist-npm/components/core/make-theme.d.ts

@@ -1,3 +0,0 @@
-import type { Prettify, PartialDeep } from "../../types/index.js";
-import { type Theme } from "./theme.js";
-export declare function makeTheme<SpecificTheme extends object>(...themes: readonly (undefined | PartialDeep<Theme<SpecificTheme>>)[]): Prettify<Theme<SpecificTheme>>;

package/dist-npm/components/core/make-theme.js

@@ -1,28 +0,0 @@
-import { defaultTheme } from "./theme.js";
-function isPlainObject(value) {
-  if (typeof value !== "object" || value === null) {
-    return false;
-  }
-  let proto = value;
-  while (Object.getPrototypeOf(proto) !== null) {
-    proto = Object.getPrototypeOf(proto);
-  }
-  return Object.getPrototypeOf(value) === proto;
-}
-function deepMerge(...objects) {
-  const output = {};
-  for (const obj of objects) {
-    for (const [key, value] of Object.entries(obj)) {
-      const prevValue = output[key];
-      output[key] = isPlainObject(prevValue) && isPlainObject(value) ? deepMerge(prevValue, value) : value;
-    }
-  }
-  return output;
-}
-export function makeTheme(...themes) {
-  const themesToMerge = [
-    defaultTheme,
-    ...themes.filter((theme) => theme != null)
-  ];
-  return deepMerge(...themesToMerge);
-}

package/dist-npm/components/core/position.d.ts

@@ -1,12 +0,0 @@
-export declare function finite({ active, pageSize, total, }: {
-    active: number;
-    pageSize: number;
-    total: number;
-}): number;
-export declare function infinite({ active, lastActive, total, pageSize, pointer, }: {
-    active: number;
-    lastActive: number;
-    total: number;
-    pageSize: number;
-    pointer: number;
-}): number;

package/dist-npm/components/core/position.js

@@ -1,29 +0,0 @@
-export function finite({
-  active,
-  pageSize,
-  total
-}) {
-  const middle = Math.floor(pageSize / 2);
-  if (total <= pageSize || active < middle) {
-    return active;
-  }
-  if (active >= total - middle) {
-    return active + pageSize - total;
-  }
-  return middle;
-}
-export function infinite({
-  active,
-  lastActive,
-  total,
-  pageSize,
-  pointer
-}) {
-  if (total <= pageSize) {
-    return active;
-  }
-  if (lastActive < active && active - lastActive < pageSize) {
-    return Math.min(Math.floor(pageSize / 2), pointer + active - lastActive);
-  }
-  return pointer;
-}

package/dist-npm/components/core/promise-polyfill.d.ts

@@ -1,7 +0,0 @@
-export declare class PromisePolyfill<T> extends Promise<T> {
-    static withResolver<T>(): {
-        promise: Promise<T>;
-        resolve: (value: T) => void;
-        reject: (error: unknown) => void;
-    };
-}

package/dist-npm/components/core/promise-polyfill.js

@@ -1,13 +0,0 @@
-export class PromisePolyfill extends Promise {
-  
-  
-  static withResolver() {
-    let resolve;
-    let reject;
-    const promise = new Promise((res, rej) => {
-      resolve = res;
-      reject = rej;
-    });
-    return { promise, resolve, reject };
-  }
-}

package/dist-npm/components/core/screen-manager.d.ts

@@ -1,14 +0,0 @@
-import type { RelinkaReadline } from "../../types/index.js";
-export default class ScreenManager {
-    private readonly rl;
-    private height;
-    private extraLinesUnderPrompt;
-    private cursorPos;
-    constructor(rl: RelinkaReadline);
-    write(content: string): void;
-    render(content: string, bottomContent?: string): void;
-    checkCursorPos(): void;
-    done({ clearContent }: {
-        clearContent: boolean;
-    }): void;
-}

package/dist-npm/components/core/screen-manager.js

@@ -1,67 +0,0 @@
-import ansiEscapes from "ansi-escapes";
-import stripAnsi from "strip-ansi";
-import { breakLines, readlineWidth } from "./utils.js";
-const height = (content) => content.split("\n").length;
-const lastLine = (content) => content.split("\n").pop() ?? "";
-function cursorDown(n) {
-  return n > 0 ? ansiEscapes.cursorDown(n) : "";
-}
-export default class ScreenManager {
-  constructor(rl) {
-    this.rl = rl;
-    this.rl = rl;
-    this.cursorPos = rl.getCursorPos();
-  }
-  // These variables are keeping information to allow correct prompt re-rendering
-  height = 0;
-  extraLinesUnderPrompt = 0;
-  cursorPos;
-  write(content) {
-    this.rl.output.unmute();
-    this.rl.output.write(content);
-    this.rl.output.mute();
-  }
-  render(content, bottomContent = "") {
-    const promptLine = lastLine(content);
-    const rawPromptLine = stripAnsi(promptLine);
-    let prompt = rawPromptLine;
-    if (this.rl.line.length > 0) {
-      prompt = prompt.slice(0, -this.rl.line.length);
-    }
-    this.rl.setPrompt(prompt);
-    this.cursorPos = this.rl.getCursorPos();
-    const width = readlineWidth();
-    content = breakLines(content, width);
-    bottomContent = breakLines(bottomContent, width);
-    if (rawPromptLine.length % width === 0) {
-      content += "\n";
-    }
-    let output = content + (bottomContent ? "\n" + bottomContent : "");
-    const promptLineUpDiff = Math.floor(rawPromptLine.length / width) - this.cursorPos.rows;
-    const bottomContentHeight = promptLineUpDiff + (bottomContent ? height(bottomContent) : 0);
-    if (bottomContentHeight > 0) {
-      output += ansiEscapes.cursorUp(bottomContentHeight);
-    }
-    output += ansiEscapes.cursorTo(this.cursorPos.cols);
-    this.write(
-      cursorDown(this.extraLinesUnderPrompt) + ansiEscapes.eraseLines(this.height) + output
-    );
-    this.extraLinesUnderPrompt = bottomContentHeight;
-    this.height = height(output);
-  }
-  checkCursorPos() {
-    const cursorPos = this.rl.getCursorPos();
-    if (cursorPos.cols !== this.cursorPos.cols) {
-      this.write(ansiEscapes.cursorTo(cursorPos.cols));
-      this.cursorPos = cursorPos;
-    }
-  }
-  done({ clearContent }) {
-    this.rl.setPrompt("");
-    let output = cursorDown(this.extraLinesUnderPrompt);
-    output += clearContent ? ansiEscapes.eraseLines(this.height) : "\n";
-    output += ansiEscapes.cursorShow;
-    this.write(output);
-    this.rl.close();
-  }
-}

package/dist-npm/components/core/theme.d.ts

@@ -1,21 +0,0 @@
-import type { Prettify } from "../../types/index.js";
-export type Status = "loading" | "idle" | "done" | (string & {});
-type DefaultTheme = {
-        prefix: string | Prettify<Omit<Record<Status, string>, "loading">>;
-        spinner: {
-                interval: number;
-                frames: string[];
-    };
-        style: {
-                answer: (text: string) => string;
-                message: (text: string, status: Status) => string;
-                error: (text: string) => string;
-                defaultAnswer: (text: string) => string;
-                help: (text: string) => string;
-                highlight: (text: string) => string;
-                key: (text: string) => string;
-    };
-};
-export type Theme<Extension extends object = object> = Prettify<Extension & DefaultTheme>;
-export declare const defaultTheme: DefaultTheme;
-export {};

package/dist-npm/components/core/theme.js

@@ -1,24 +0,0 @@
-import colors from "picocolors";
-import figures from "../../components/figures/index.js";
-export const defaultTheme = {
-  prefix: {
-    idle: colors.blue("?"),
-    
-    done: colors.green(figures.tick)
-  },
-  spinner: {
-    interval: 80,
-    frames: ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"].map(
-      (frame) => colors.yellow(frame)
-    )
-  },
-  style: {
-    answer: colors.cyan,
-    message: colors.bold,
-    error: (text) => colors.red(`> ${text}`),
-    defaultAnswer: (text) => colors.dim(`(${text})`),
-    help: colors.dim,
-    highlight: colors.cyan,
-    key: (text) => colors.cyan(colors.bold(`<${text}>`))
-  }
-};

package/dist-npm/components/core/use-effect.d.ts

@@ -1,2 +0,0 @@
-import type { RelinkaReadline } from "../../types/index.js";
-export declare function useEffect(cb: (rl: RelinkaReadline) => void | (() => void), depArray: readonly unknown[]): void;

package/dist-npm/components/core/use-effect.js

@@ -1,11 +0,0 @@
-import { withPointer, effectScheduler } from "./hook-engine.js";
-export function useEffect(cb, depArray) {
-  withPointer((pointer) => {
-    const oldDeps = pointer.get();
-    const hasChanged = !Array.isArray(oldDeps) || depArray.some((dep, i) => !Object.is(dep, oldDeps[i]));
-    if (hasChanged) {
-      effectScheduler.queue(cb);
-    }
-    pointer.set(depArray);
-  });
-}

package/dist-npm/components/core/use-keypress.d.ts

@@ -1,3 +0,0 @@
-import { type RelinkaReadline } from "../../types/index.js";
-import { type KeypressEvent } from "./key.js";
-export declare function useKeypress(userHandler: (event: KeypressEvent, rl: RelinkaReadline) => void | Promise<void>): void;

package/dist-npm/components/core/use-keypress.js

@@ -1,21 +0,0 @@
-import { withUpdates } from "./hook-engine.js";
-import { useEffect } from "./use-effect.js";
-import { useRef } from "./use-ref.js";
-export function useKeypress(userHandler) {
-  const signal = useRef(userHandler);
-  signal.current = userHandler;
-  useEffect((rl) => {
-    let ignore = false;
-    const handler = withUpdates((_input, event) => {
-      if (ignore) {
-        return;
-      }
-      void signal.current(event, rl);
-    });
-    rl.input.on("keypress", handler);
-    return () => {
-      ignore = true;
-      rl.input.removeListener("keypress", handler);
-    };
-  }, []);
-}

package/dist-npm/components/core/use-memo.d.ts

@@ -1 +0,0 @@
-export declare function useMemo<Value>(fn: () => Value, dependencies: readonly unknown[]): Value;

package/dist-npm/components/core/use-memo.js

@@ -1,12 +0,0 @@
-import { withPointer } from "./hook-engine.js";
-export function useMemo(fn, dependencies) {
-  return withPointer((pointer) => {
-    const prev = pointer.get();
-    if (!prev || prev.dependencies.length !== dependencies.length || prev.dependencies.some((dep, i) => dep !== dependencies[i])) {
-      const value = fn();
-      pointer.set({ value, dependencies });
-      return value;
-    }
-    return prev.value;
-  });
-}

package/dist-npm/components/core/use-pagination.d.ts

@@ -1,11 +0,0 @@
-import type { Prettify } from "../../types/index.js";
-import { type Layout } from "./lines.js";
-import { type Theme } from "./theme.js";
-export declare function usePagination<T>({ items, active, renderItem, pageSize, loop, }: {
-    items: readonly T[];
-        active: number;
-        renderItem: (layout: Prettify<Layout<T>>) => string;
-        pageSize: number;
-        loop?: boolean;
-    theme?: Theme;
-}): string;

package/dist-npm/components/core/use-pagination.js

@@ -1,34 +0,0 @@
-import { lines } from "./lines.js";
-import { finite, infinite } from "./position.js";
-import { useRef } from "./use-ref.js";
-import { readlineWidth } from "./utils.js";
-export function usePagination({
-  items,
-  active,
-  renderItem,
-  pageSize,
-  loop = true
-}) {
-  const state = useRef({ position: 0, lastActive: 0 });
-  const position = loop ? infinite({
-    active,
-    lastActive: state.current.lastActive,
-    total: items.length,
-    pageSize,
-    pointer: state.current.position
-  }) : finite({
-    active,
-    total: items.length,
-    pageSize
-  });
-  state.current.position = position;
-  state.current.lastActive = active;
-  return lines({
-    items,
-    width: readlineWidth(),
-    renderItem,
-    active,
-    position,
-    pageSize
-  }).join("\n");
-}

package/dist-npm/components/core/use-prefix.d.ts

@@ -1,5 +0,0 @@
-import type { Theme, Status } from "./theme.js";
-export declare function usePrefix({ status, theme, }: {
-    status?: Status;
-    theme?: Theme;
-}): string;

package/dist-npm/components/core/use-prefix.js

@@ -1,42 +0,0 @@
-import { AsyncResource } from "node:async_hooks";
-import { makeTheme } from "./make-theme.js";
-import { useEffect } from "./use-effect.js";
-import { useState } from "./use-state.js";
-export function usePrefix({
-  status = "idle",
-  theme
-}) {
-  const [showLoader, setShowLoader] = useState(false);
-  const [tick, setTick] = useState(0);
-  const { prefix, spinner } = makeTheme(theme);
-  useEffect(() => {
-    if (status === "loading") {
-      let tickInterval;
-      let inc = -1;
-      const delayTimeout = setTimeout(
-        AsyncResource.bind(() => {
-          setShowLoader(true);
-          tickInterval = setInterval(
-            AsyncResource.bind(() => {
-              inc = inc + 1;
-              setTick(inc % spinner.frames.length);
-            }),
-            spinner.interval
-          );
-        }),
-        300
-      );
-      return () => {
-        clearTimeout(delayTimeout);
-        clearInterval(tickInterval);
-      };
-    } else {
-      setShowLoader(false);
-    }
-  }, [status]);
-  if (showLoader) {
-    return spinner.frames[tick];
-  }
-  const iconName = status === "loading" ? "idle" : status;
-  return typeof prefix === "string" ? prefix : prefix[iconName] ?? prefix.idle;
-}

package/dist-npm/components/core/use-ref.d.ts

@@ -1,6 +0,0 @@
-export declare function useRef<Value>(val: Value): {
-    current: Value;
-};
-export declare function useRef<Value>(val?: Value): {
-    current: Value | undefined;
-};

package/dist-npm/components/core/use-ref.js

@@ -1,4 +0,0 @@
-import { useState } from "./use-state.js";
-export function useRef(val) {
-  return useState({ current: val })[0];
-}

package/dist-npm/components/core/use-state.d.ts

@@ -1,4 +0,0 @@
-type NotFunction<T> = T extends (...args: never) => unknown ? never : T;
-export declare function useState<Value>(defaultValue: NotFunction<Value> | (() => Value)): [Value, (newValue: Value) => void];
-export declare function useState<Value>(defaultValue?: NotFunction<Value> | (() => Value)): [Value | undefined, (newValue?: Value) => void];
-export {};

package/dist-npm/components/core/use-state.js

@@ -1,17 +0,0 @@
-import { withPointer, handleChange } from "./hook-engine.js";
-export function useState(defaultValue) {
-  return withPointer((pointer) => {
-    const setFn = (newValue) => {
-      if (pointer.get() !== newValue) {
-        pointer.set(newValue);
-        handleChange();
-      }
-    };
-    if (pointer.initialized) {
-      return [pointer.get(), setFn];
-    }
-    const value = typeof defaultValue === "function" ? defaultValue() : defaultValue;
-    pointer.set(value);
-    return [value, setFn];
-  });
-}

package/dist-npm/components/core/useKeyPress.d.ts

@@ -1,4 +0,0 @@
-import readline from "node:readline";
-type KeyPressCallback = (str: string, key: readline.Key) => void;
-export declare function useKeyPress(callback: KeyPressCallback): () => void;
-export {};