decocms 2.285.1 → 2.286.0

package/dist/server/node_modules/ink/build/experimental/dom.js

@@ -0,0 +1,123 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.setTextContent = exports.createTextNode = exports.setAttribute = exports.setStyle = exports.removeChildNode = exports.insertBeforeNode = exports.appendChildNode = exports.createNode = void 0;
+
+var _yogaLayoutPrebuilt = _interopRequireDefault(require("yoga-layout-prebuilt"));
+
+var _measureText = _interopRequireDefault(require("../measure-text"));
+
+var _applyStyle = _interopRequireDefault(require("./apply-style"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+// Helper utilities implementing some common DOM methods to simplify reconciliation code
+const createNode = tagName => ({
+  nodeName: tagName.toUpperCase(),
+  style: {},
+  attributes: {},
+  childNodes: [],
+  parentNode: null,
+  textContent: null,
+  yogaNode: _yogaLayoutPrebuilt.default.Node.create()
+});
+
+exports.createNode = createNode;
+
+const appendChildNode = (node, childNode) => {
+  if (childNode.parentNode) {
+    removeChildNode(childNode.parentNode, childNode);
+  }
+
+  childNode.parentNode = node;
+  node.childNodes.push(childNode);
+  node.yogaNode.insertChild(childNode.yogaNode, node.yogaNode.getChildCount());
+};
+
+exports.appendChildNode = appendChildNode;
+
+const insertBeforeNode = (node, newChildNode, beforeChildNode) => {
+  if (newChildNode.parentNode) {
+    removeChildNode(newChildNode.parentNode, newChildNode);
+  }
+
+  newChildNode.parentNode = node;
+  const index = node.childNodes.indexOf(beforeChildNode);
+
+  if (index >= 0) {
+    node.childNodes.splice(index, 0, newChildNode);
+    node.yogaNode.insertChild(newChildNode.yogaNode, index);
+    return;
+  }
+
+  node.childNodes.push(newChildNode);
+  node.yogaNode.insertChild(newChildNode.yogaNode, node.yogaNode.getChildCount());
+};
+
+exports.insertBeforeNode = insertBeforeNode;
+
+const removeChildNode = (node, removeNode) => {
+  removeNode.parentNode.yogaNode.removeChild(removeNode.yogaNode);
+  removeNode.parentNode = null;
+  const index = node.childNodes.indexOf(removeNode);
+
+  if (index >= 0) {
+    node.childNodes.splice(index, 1);
+  }
+};
+
+exports.removeChildNode = removeChildNode;
+
+const setStyle = (node, style) => {
+  node.style = style;
+  (0, _applyStyle.default)(node.yogaNode, style);
+};
+
+exports.setStyle = setStyle;
+
+const setAttribute = (node, key, value) => {
+  node.attributes[key] = value;
+};
+
+exports.setAttribute = setAttribute;
+
+const createTextNode = text => {
+  const node = {
+    nodeName: '#text',
+    nodeValue: text,
+    yogaNode: _yogaLayoutPrebuilt.default.Node.create()
+  };
+  setTextContent(node, text);
+  return node;
+};
+
+exports.createTextNode = createTextNode;
+
+const setTextContent = (node, text) => {
+  if (typeof text !== 'string') {
+    text = String(text);
+  }
+
+  let width = 0;
+  let height = 0;
+
+  if (text.length > 0) {
+    const dimensions = (0, _measureText.default)(text);
+    width = dimensions.width;
+    height = dimensions.height;
+  }
+
+  if (node.nodeName === '#text') {
+    node.nodeValue = text;
+    node.yogaNode.setWidth(width);
+    node.yogaNode.setHeight(height);
+  } else {
+    node.textContent = text;
+    node.yogaNode.setWidth(node.style.width || width);
+    node.yogaNode.setHeight(node.style.height || height);
+  }
+};
+
+exports.setTextContent = setTextContent;

package/dist/server/node_modules/ink/build/experimental/output.js

@@ -0,0 +1,91 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _stringLength = _interopRequireDefault(require("string-length"));
+
+var _sliceAnsi = _interopRequireDefault(require("slice-ansi"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * "Virtual" output class
+ *
+ * Handles the positioning and saving of the output of each node in the tree.
+ * Also responsible for applying transformations to each character of the output.
+ *
+ * Used to generate the final output of all nodes before writing it to actual output stream (e.g. stdout)
+ */
+class Output {
+  constructor({
+    width,
+    height
+  }) {
+    this.width = width;
+    this.height = height;
+    this.writes = []; // Initialize output array with a specific set of rows, so that margin/padding at the bottom is preserved
+  }
+
+  write(x, y, text, {
+    transformers
+  }) {
+    if (!text) {
+      return;
+    }
+
+    this.writes.push({
+      x,
+      y,
+      text,
+      transformers
+    });
+  }
+
+  get() {
+    const output = [];
+
+    for (let y = 0; y < this.height; y++) {
+      output.push(' '.repeat(this.width));
+    }
+
+    for (const write of this.writes) {
+      const {
+        x,
+        y,
+        text,
+        transformers
+      } = write;
+      const lines = text.split('\n');
+      let offsetY = 0;
+
+      for (let line of lines) {
+        const currentLine = output[y + offsetY]; // Line can be missing if `text` is taller than height of pre-initialized `this.output`
+
+        if (!currentLine) {
+          continue;
+        }
+
+        const length = (0, _stringLength.default)(line);
+
+        for (const transformer of transformers) {
+          line = transformer(line);
+        }
+
+        output[y + offsetY] = (0, _sliceAnsi.default)(currentLine, 0, x) + line + (0, _sliceAnsi.default)(currentLine, x + length);
+        offsetY++;
+      }
+    }
+
+    const generatedOutput = output.map(line => line.trimRight()).join('\n');
+    return {
+      output: generatedOutput,
+      height: output.length
+    };
+  }
+
+}
+
+exports.default = Output;

package/dist/server/node_modules/ink/build/experimental/reconciler.js

@@ -0,0 +1,141 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _scheduler = require("scheduler");
+
+var _reactReconciler = _interopRequireDefault(require("react-reconciler"));
+
+var _dom = require("./dom");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+const NO_CONTEXT = true;
+const hostConfig = {
+  schedulePassiveEffects: _scheduler.unstable_scheduleCallback,
+  cancelPassiveEffects: _scheduler.unstable_cancelCallback,
+  now: Date.now,
+  getRootHostContext: () => NO_CONTEXT,
+  prepareForCommit: () => {},
+  resetAfterCommit: rootNode => {
+    // Since renders are throttled at the instance level and <Static> component children
+    // are rendered only once and then get deleted, we need an escape hatch to
+    // trigger an immediate render to ensure <Static> children are written to output before they get erased
+    if (rootNode.isStaticDirty) {
+      rootNode.isStaticDirty = false;
+      rootNode.onImmediateRender();
+      return;
+    }
+
+    rootNode.onRender();
+  },
+  getChildHostContext: () => NO_CONTEXT,
+  shouldSetTextContent: (type, props) => {
+    return typeof props.children === 'string' || typeof props.children === 'number';
+  },
+  createInstance: (type, newProps) => {
+    const node = (0, _dom.createNode)(type);
+
+    for (const [key, value] of Object.entries(newProps)) {
+      if (key === 'children') {
+        if (typeof value === 'string' || typeof value === 'number') {
+          if (type === 'div') {
+            // Text node must be wrapped in another node, so that text can be aligned within container
+            const textNode = (0, _dom.createNode)('div');
+            (0, _dom.setTextContent)(textNode, value);
+            (0, _dom.appendChildNode)(node, textNode);
+          }
+
+          if (type === 'span') {
+            (0, _dom.setTextContent)(node, value);
+          }
+        }
+      } else if (key === 'style') {
+        (0, _dom.setStyle)(node, value);
+      } else if (key === 'unstable__transformChildren') {
+        node.unstable__transformChildren = value; // eslint-disable-line camelcase
+      } else if (key === 'unstable__static') {
+        node.unstable__static = true; // eslint-disable-line camelcase
+      } else {
+        (0, _dom.setAttribute)(node, key, value);
+      }
+    }
+
+    return node;
+  },
+  createTextInstance: _dom.createTextNode,
+  resetTextContent: node => {
+    if (node.textContent) {
+      node.textContent = '';
+    }
+
+    if (node.childNodes.length > 0) {
+      for (const childNode of node.childNodes) {
+        (0, _dom.removeChildNode)(node, childNode);
+      }
+    }
+  },
+  getPublicInstance: instance => instance,
+  appendInitialChild: _dom.appendChildNode,
+  appendChild: _dom.appendChildNode,
+  insertBefore: _dom.insertBeforeNode,
+  finalizeInitialChildren: (node, type, props, rootNode) => {
+    if (node.unstable__static) {
+      rootNode.isStaticDirty = true;
+    }
+  },
+  supportsMutation: true,
+  appendChildToContainer: _dom.appendChildNode,
+  insertInContainerBefore: _dom.insertBeforeNode,
+  removeChildFromContainer: _dom.removeChildNode,
+  prepareUpdate: (node, type, oldProps, newProps, rootNode) => {
+    if (node.unstable__static) {
+      rootNode.isStaticDirty = true;
+    }
+
+    return true;
+  },
+  commitUpdate: (node, updatePayload, type, oldProps, newProps) => {
+    for (const [key, value] of Object.entries(newProps)) {
+      if (key === 'children') {
+        if (typeof value === 'string' || typeof value === 'number') {
+          if (type === 'div') {
+            // Text node must be wrapped in another node, so that text can be aligned within container
+            // If there's no such node, a new one must be created
+            if (node.childNodes.length === 0) {
+              const textNode = (0, _dom.createNode)('div');
+              (0, _dom.setTextContent)(textNode, value);
+              (0, _dom.appendChildNode)(node, textNode);
+            } else {
+              (0, _dom.setTextContent)(node.childNodes[0], value);
+            }
+          }
+
+          if (type === 'span') {
+            (0, _dom.setTextContent)(node, value);
+          }
+        }
+      } else if (key === 'style') {
+        (0, _dom.setStyle)(node, value);
+      } else if (key === 'unstable__transformChildren') {
+        node.unstable__transformChildren = value; // eslint-disable-line camelcase
+      } else if (key === 'unstable__static') {
+        node.unstable__static = true; // eslint-disable-line camelcase
+      } else {
+        (0, _dom.setAttribute)(node, key, value);
+      }
+    }
+  },
+  commitTextUpdate: (node, oldText, newText) => {
+    (0, _dom.setTextContent)(node, newText);
+  },
+  removeChild: _dom.removeChildNode
+};
+
+var _default = (0, _reactReconciler.default)(hostConfig); // eslint-disable-line new-cap
+
+
+exports.default = _default;

package/dist/server/node_modules/ink/build/experimental/renderer.js

@@ -0,0 +1,81 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _yogaLayoutPrebuilt = _interopRequireDefault(require("yoga-layout-prebuilt"));
+
+var _renderNodeToOutput = _interopRequireDefault(require("../render-node-to-output"));
+
+var _calculateWrappedText = _interopRequireDefault(require("../calculate-wrapped-text"));
+
+var _output = _interopRequireDefault(require("./output"));
+
+var _dom = require("./dom");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+// Since <Static> components can be placed anywhere in the tree, this helper finds and returns them
+const findStaticNode = node => {
+  if (node.unstable__static) {
+    return node;
+  }
+
+  for (const childNode of node.childNodes) {
+    if (childNode.unstable__static) {
+      return childNode;
+    }
+
+    if (Array.isArray(childNode.childNodes) && childNode.childNodes.length > 0) {
+      return findStaticNode(childNode);
+    }
+  }
+};
+
+var _default = ({
+  terminalWidth = 100
+}) => {
+  return node => {
+    (0, _dom.setStyle)(node, {
+      width: terminalWidth
+    });
+    node.yogaNode.calculateLayout(_yogaLayoutPrebuilt.default.UNDEFINED, _yogaLayoutPrebuilt.default.UNDEFINED, _yogaLayoutPrebuilt.default.DIRECTION_LTR);
+    (0, _calculateWrappedText.default)(node);
+    node.yogaNode.calculateLayout(_yogaLayoutPrebuilt.default.UNDEFINED, _yogaLayoutPrebuilt.default.UNDEFINED, _yogaLayoutPrebuilt.default.DIRECTION_LTR);
+    const output = new _output.default({
+      width: node.yogaNode.getComputedWidth(),
+      height: node.yogaNode.getComputedHeight()
+    });
+    (0, _renderNodeToOutput.default)(node, output, {
+      skipStaticElements: true
+    });
+    const staticNode = findStaticNode(node);
+    let staticOutput;
+
+    if (staticNode) {
+      staticOutput = new _output.default({
+        width: staticNode.yogaNode.getComputedWidth(),
+        height: staticNode.yogaNode.getComputedHeight()
+      });
+      (0, _renderNodeToOutput.default)(staticNode, staticOutput, {
+        skipStaticElements: false
+      });
+    }
+
+    const {
+      output: generatedOutput,
+      height: outputHeight
+    } = output.get();
+    return {
+      output: generatedOutput,
+      outputHeight,
+      // Newline at the end is needed, because static output doesn't have one, so
+      // interactive output will override last line of static output
+      staticOutput: staticOutput ? `${staticOutput.get().output}\n` : undefined
+    };
+  };
+};
+
+exports.default = _default;

package/dist/server/node_modules/ink/build/get-max-width.d.ts

@@ -0,0 +1,3 @@
+import { type Node as YogaNode } from 'yoga-layout';
+declare const getMaxWidth: (yogaNode: YogaNode) => number;
+export default getMaxWidth;

package/dist/server/node_modules/ink/build/get-max-width.js

@@ -0,0 +1,10 @@
+import Yoga from 'yoga-layout';
+const getMaxWidth = (yogaNode) => {
+    return (yogaNode.getComputedWidth() -
+        yogaNode.getComputedPadding(Yoga.EDGE_LEFT) -
+        yogaNode.getComputedPadding(Yoga.EDGE_RIGHT) -
+        yogaNode.getComputedBorder(Yoga.EDGE_LEFT) -
+        yogaNode.getComputedBorder(Yoga.EDGE_RIGHT));
+};
+export default getMaxWidth;
+//# sourceMappingURL=get-max-width.js.map

package/dist/server/node_modules/ink/build/get-max-width.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-max-width.js","sourceRoot":"","sources":["../src/get-max-width.ts"],"names":[],"mappings":"AAAA,OAAO,IAA6B,MAAM,aAAa,CAAC;AAExD,MAAM,WAAW,GAAG,CAAC,QAAkB,EAAE,EAAE;IAC1C,OAAO,CACN,QAAQ,CAAC,gBAAgB,EAAE;QAC3B,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC;QAC3C,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC;QAC5C,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC;QAC1C,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAC3C,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/server/node_modules/ink/build/hooks/use-app.d.ts

@@ -0,0 +1,5 @@
+/**
+`useApp` is a React hook that exposes a method to manually exit the app (unmount).
+*/
+declare const useApp: () => import("../components/AppContext.js").Props;
+export default useApp;

package/dist/server/node_modules/ink/build/hooks/use-app.js

@@ -0,0 +1,8 @@
+import { useContext } from 'react';
+import AppContext from '../components/AppContext.js';
+/**
+`useApp` is a React hook that exposes a method to manually exit the app (unmount).
+*/
+const useApp = () => useContext(AppContext);
+export default useApp;
+//# sourceMappingURL=use-app.js.map

package/dist/server/node_modules/ink/build/hooks/use-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-app.js","sourceRoot":"","sources":["../../src/hooks/use-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,UAAU,MAAM,6BAA6B,CAAC;AAErD;;EAEE;AACF,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC5C,eAAe,MAAM,CAAC"}

package/dist/server/node_modules/ink/build/hooks/use-cursor.d.ts

@@ -0,0 +1,12 @@
+import { type CursorPosition } from '../log-update.js';
+/**
+`useCursor` is a React hook that lets you control the terminal cursor position.
+
+Setting a cursor position makes the cursor visible at the specified coordinates (relative to the Ink output origin). This is useful for IME (Input Method Editor) support, where the composing character is displayed at the cursor location.
+
+Pass `undefined` to hide the cursor.
+*/
+declare const useCursor: () => {
+    setCursorPosition: (position: CursorPosition | undefined) => void;
+};
+export default useCursor;

package/dist/server/node_modules/ink/build/hooks/use-cursor.js

@@ -0,0 +1,29 @@
+import { useContext, useRef, useCallback, useInsertionEffect } from 'react';
+import CursorContext from '../components/CursorContext.js';
+/**
+`useCursor` is a React hook that lets you control the terminal cursor position.
+
+Setting a cursor position makes the cursor visible at the specified coordinates (relative to the Ink output origin). This is useful for IME (Input Method Editor) support, where the composing character is displayed at the cursor location.
+
+Pass `undefined` to hide the cursor.
+*/
+const useCursor = () => {
+    const context = useContext(CursorContext);
+    const positionRef = useRef(undefined);
+    const setCursorPosition = useCallback((position) => {
+        positionRef.current = position;
+    }, []);
+    // Propagate cursor position to log-update only during commit phase.
+    // useInsertionEffect runs before resetAfterCommit (which triggers onRender),
+    // and does NOT run for abandoned concurrent renders (e.g. suspended components).
+    // This prevents cursor state from leaking across render boundaries.
+    useInsertionEffect(() => {
+        context.setCursorPosition(positionRef.current);
+        return () => {
+            context.setCursorPosition(undefined);
+        };
+    });
+    return { setCursorPosition };
+};
+export default useCursor;
+//# sourceMappingURL=use-cursor.js.map

package/dist/server/node_modules/ink/build/hooks/use-cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-cursor.js","sourceRoot":"","sources":["../../src/hooks/use-cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAC,MAAM,OAAO,CAAC;AAC1E,OAAO,aAAa,MAAM,gCAAgC,CAAC;AAG3D;;;;;;EAME;AACF,MAAM,SAAS,GAAG,GAAG,EAAE;IACtB,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,MAAM,CAA6B,SAAS,CAAC,CAAC;IAElE,MAAM,iBAAiB,GAAG,WAAW,CACpC,CAAC,QAAoC,EAAE,EAAE;QACxC,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IAChC,CAAC,EACD,EAAE,CACF,CAAC;IAEF,oEAAoE;IACpE,6EAA6E;IAC7E,iFAAiF;IACjF,oEAAoE;IACpE,kBAAkB,CAAC,GAAG,EAAE;QACvB,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,GAAG,EAAE;YACX,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,EAAC,iBAAiB,EAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/server/node_modules/ink/build/hooks/use-focus-manager.d.ts

@@ -0,0 +1,28 @@
+import { type Props } from '../components/FocusContext.js';
+type Output = {
+    /**
+    Enable focus management for all components.
+    */
+    enableFocus: Props['enableFocus'];
+    /**
+    Disable focus management for all components. The currently active component (if there's one) will lose its focus.
+    */
+    disableFocus: Props['disableFocus'];
+    /**
+    Switch focus to the next focusable component. If there's no active component right now, focus will be given to the first focusable component. If the active component is the last in the list of focusable components, focus will be switched to the first focusable component.
+    */
+    focusNext: Props['focusNext'];
+    /**
+    Switch focus to the previous focusable component. If there's no active component right now, focus will be given to the first focusable component. If the active component is the first in the list of focusable components, focus will be switched to the last focusable component.
+    */
+    focusPrevious: Props['focusPrevious'];
+    /**
+    Switch focus to the element with provided `id`. If there's no element with that `id`, focus will be given to the first focusable component.
+    */
+    focus: Props['focus'];
+};
+/**
+This hook exposes methods to enable or disable focus management for all components or manually switch focus to the next or previous components.
+*/
+declare const useFocusManager: () => Output;
+export default useFocusManager;

package/dist/server/node_modules/ink/build/hooks/use-focus-manager.js

@@ -0,0 +1,17 @@
+import { useContext } from 'react';
+import FocusContext from '../components/FocusContext.js';
+/**
+This hook exposes methods to enable or disable focus management for all components or manually switch focus to the next or previous components.
+*/
+const useFocusManager = () => {
+    const focusContext = useContext(FocusContext);
+    return {
+        enableFocus: focusContext.enableFocus,
+        disableFocus: focusContext.disableFocus,
+        focusNext: focusContext.focusNext,
+        focusPrevious: focusContext.focusPrevious,
+        focus: focusContext.focus,
+    };
+};
+export default useFocusManager;
+//# sourceMappingURL=use-focus-manager.js.map

package/dist/server/node_modules/ink/build/hooks/use-focus-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-focus-manager.js","sourceRoot":"","sources":["../../src/hooks/use-focus-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,YAA0B,MAAM,+BAA+B,CAAC;AA6BvE;;EAEE;AACF,MAAM,eAAe,GAAG,GAAW,EAAE;IACpC,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAE9C,OAAO;QACN,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,YAAY,EAAE,YAAY,CAAC,YAAY;QACvC,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,aAAa,EAAE,YAAY,CAAC,aAAa;QACzC,KAAK,EAAE,YAAY,CAAC,KAAK;KACzB,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/server/node_modules/ink/build/hooks/use-focus.d.ts

@@ -0,0 +1,29 @@
+type Input = {
+    /**
+    Enable or disable this component's focus, while still maintaining its position in the list of focusable components.
+    */
+    isActive?: boolean;
+    /**
+    Auto-focus this component if there's no active (focused) component right now.
+    */
+    autoFocus?: boolean;
+    /**
+    Assign an ID to this component, so it can be programmatically focused with `focus(id)`.
+    */
+    id?: string;
+};
+type Output = {
+    /**
+    Determines whether this component is focused.
+    */
+    isFocused: boolean;
+    /**
+    Allows focusing a specific element with the provided `id`.
+    */
+    focus: (id: string) => void;
+};
+/**
+A component that uses the `useFocus` hook becomes "focusable" to Ink, so when the user presses <kbd>Tab</kbd>, Ink will switch focus to this component. If there are multiple components that execute the `useFocus` hook, focus will be given to them in the order in which these components are rendered. This hook returns an object with an `isFocused` boolean property, which determines whether this component is focused.
+*/
+declare const useFocus: ({ isActive, autoFocus, id: customId, }?: Input) => Output;
+export default useFocus;

package/dist/server/node_modules/ink/build/hooks/use-focus.js

@@ -0,0 +1,42 @@
+import { useEffect, useContext, useMemo } from 'react';
+import FocusContext from '../components/FocusContext.js';
+import useStdin from './use-stdin.js';
+/**
+A component that uses the `useFocus` hook becomes "focusable" to Ink, so when the user presses <kbd>Tab</kbd>, Ink will switch focus to this component. If there are multiple components that execute the `useFocus` hook, focus will be given to them in the order in which these components are rendered. This hook returns an object with an `isFocused` boolean property, which determines whether this component is focused.
+*/
+const useFocus = ({ isActive = true, autoFocus = false, id: customId, } = {}) => {
+    const { isRawModeSupported, setRawMode } = useStdin();
+    const { activeId, add, remove, activate, deactivate, focus } = useContext(FocusContext);
+    const id = useMemo(() => {
+        return customId ?? Math.random().toString().slice(2, 7);
+    }, [customId]);
+    useEffect(() => {
+        add(id, { autoFocus });
+        return () => {
+            remove(id);
+        };
+    }, [id, autoFocus]);
+    useEffect(() => {
+        if (isActive) {
+            activate(id);
+        }
+        else {
+            deactivate(id);
+        }
+    }, [isActive, id]);
+    useEffect(() => {
+        if (!isRawModeSupported || !isActive) {
+            return;
+        }
+        setRawMode(true);
+        return () => {
+            setRawMode(false);
+        };
+    }, [isActive]);
+    return {
+        isFocused: Boolean(id) && activeId === id,
+        focus,
+    };
+};
+export default useFocus;
+//# sourceMappingURL=use-focus.js.map

package/dist/server/node_modules/ink/build/hooks/use-focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-focus.js","sourceRoot":"","sources":["../../src/hooks/use-focus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAC,MAAM,OAAO,CAAC;AACrD,OAAO,YAAY,MAAM,+BAA+B,CAAC;AACzD,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA+BtC;;EAEE;AACF,MAAM,QAAQ,GAAG,CAAC,EACjB,QAAQ,GAAG,IAAI,EACf,SAAS,GAAG,KAAK,EACjB,EAAE,EAAE,QAAQ,MACF,EAAE,EAAU,EAAE;IACxB,MAAM,EAAC,kBAAkB,EAAE,UAAU,EAAC,GAAG,QAAQ,EAAE,CAAC;IACpD,MAAM,EAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAC,GACzD,UAAU,CAAC,YAAY,CAAC,CAAC;IAE1B,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QACvB,OAAO,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,SAAS,CAAC,GAAG,EAAE;QACd,GAAG,CAAC,EAAE,EAAE,EAAC,SAAS,EAAC,CAAC,CAAC;QAErB,OAAO,GAAG,EAAE;YACX,MAAM,CAAC,EAAE,CAAC,CAAC;QACZ,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IAEpB,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,QAAQ,EAAE,CAAC;YACd,QAAQ,CAAC,EAAE,CAAC,CAAC;QACd,CAAC;aAAM,CAAC;YACP,UAAU,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC;IACF,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IAEnB,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,kBAAkB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,OAAO;QACR,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,CAAC;QAEjB,OAAO,GAAG,EAAE;YACX,UAAU,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,OAAO;QACN,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,QAAQ,KAAK,EAAE;QACzC,KAAK;KACL,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,QAAQ,CAAC"}