byterover-cli 3.9.0 → 3.10.1

package/node_modules/ink-scroll-view/docs/api/interfaces/ScrollViewRef.md

@@ -0,0 +1,260 @@
+[**ink-scroll-view**](../README.md)
+
+---
+
+# Interface: ScrollViewRef
+
+Ref interface for controlling the ScrollView programmatically.
+
+## Properties
+
+### getBottomOffset()
+
+> **getBottomOffset**: () => `number`
+
+Gets the scroll offset when the content is scrolled to the very bottom.
+
+#### Returns
+
+`number`
+
+The bottom scroll offset in terminal rows.
+
+#### Remarks
+
+This is calculated as `contentHeight - viewportHeight`. When the scroll
+offset equals this value, the last item of the content is visible at the
+bottom of the viewport.
+
+---
+
+### getContentHeight()
+
+> **getContentHeight**: () => `number`
+
+Gets the total height of the content.
+
+#### Returns
+
+`number`
+
+The total content height in terminal rows.
+
+#### Remarks
+
+This is the sum of the heights of all child items.
+
+---
+
+### getItemHeight()
+
+> **getItemHeight**: (`index`) => `number`
+
+Gets the height of a specific item by its index.
+
+#### Parameters
+
+##### index
+
+`number`
+
+The index of the item.
+
+#### Returns
+
+`number`
+
+The height of the item in terminal rows, or 0 if not found.
+
+---
+
+### getItemPosition()
+
+> **getItemPosition**: (`index`) => \{ `height`: `number`; `top`: `number`; \} \| `null`
+
+Gets the position of a specific item.
+
+#### Parameters
+
+##### index
+
+`number`
+
+The index of the item.
+
+#### Returns
+
+\{ `height`: `number`; `top`: `number`; \} \| `null`
+
+The position (top offset) and height of the item, or null if not found.
+
+---
+
+### getScrollOffset()
+
+> **getScrollOffset**: () => `number`
+
+Gets the current scroll offset (distance scrolled from the top).
+
+#### Returns
+
+`number`
+
+The current scroll offset in terminal rows.
+
+#### Remarks
+
+The scroll offset represents how many terminal rows the content has been
+scrolled up from its initial position. A value of 0 means the content is
+at the very top (no scrolling has occurred).
+
+---
+
+### getViewportHeight()
+
+> **getViewportHeight**: () => `number`
+
+Gets the current height of the visible viewport.
+
+#### Returns
+
+`number`
+
+The viewport height in terminal rows.
+
+---
+
+### remeasure()
+
+> **remeasure**: () => `void`
+
+Re-measures the ScrollView viewport dimensions.
+
+#### Returns
+
+`void`
+
+#### Remarks
+
+Checks the current dimensions of the viewport and updates state if they have changed.
+This is crucial for handling terminal resizes, as Ink does not automatically propagate resize events to components.
+
+#### Example
+
+```tsx
+// Handle terminal resize manually
+useEffect(() => {
+  const onResize = () => ref.current?.remeasure();
+  process.stdout.on("resize", onResize);
+  return () => process.stdout.off("resize", onResize);
+}, []);
+```
+
+---
+
+### remeasureItem()
+
+> **remeasureItem**: (`index`) => `void`
+
+Triggers re-measurement of a specific child item.
+
+#### Parameters
+
+##### index
+
+`number`
+
+The index of the child to re-measure.
+
+#### Returns
+
+`void`
+
+#### Remarks
+
+Use this if a child's internal content changes size in a way that doesn't trigger a standard React render cycle update
+(e.g., internal state change within the child that affects its height).
+
+---
+
+### scrollBy()
+
+> **scrollBy**: (`delta`) => `void`
+
+Scrolls by a relative amount.
+
+#### Parameters
+
+##### delta
+
+`number`
+
+Positive for down, negative for up.
+
+#### Returns
+
+`void`
+
+#### Example
+
+```tsx
+useInput((input, key) => {
+  if (key.downArrow) ref.current?.scrollBy(1);
+  if (key.upArrow) ref.current?.scrollBy(-1);
+});
+```
+
+---
+
+### scrollTo()
+
+> **scrollTo**: (`offset`) => `void`
+
+Scrolls to a specific vertical position.
+
+#### Parameters
+
+##### offset
+
+`number`
+
+The target Y offset (distance from top).
+
+#### Returns
+
+`void`
+
+#### Example
+
+```tsx
+// Scroll to the very top
+ref.current?.scrollTo(0);
+```
+
+---
+
+### scrollToBottom()
+
+> **scrollToBottom**: () => `void`
+
+Scrolls to the very bottom.
+
+#### Returns
+
+`void`
+
+#### Remarks
+
+This calculates the target offset as `contentHeight - viewportHeight`.
+
+---
+
+### scrollToTop()
+
+> **scrollToTop**: () => `void`
+
+Scrolls to the very top (position 0).
+
+#### Returns
+
+`void`

package/node_modules/ink-scroll-view/docs/api/variables/ControlledScrollView.md

@@ -0,0 +1,21 @@
+[**ink-scroll-view**](../README.md)
+
+---
+
+# Variable: ControlledScrollView
+
+> `const` **ControlledScrollView**: `ForwardRefExoticComponent`\<[`ControlledScrollViewProps`](../interfaces/ControlledScrollViewProps.md) & `RefAttributes`\<[`ControlledScrollViewRef`](../interfaces/ControlledScrollViewRef.md)\>\>
+
+A ControlledScrollView component for Ink applications.
+
+## Remarks
+
+This is a lower-level component that handles the complex logic of:
+
+1. Rendering children within a virtual viewport.
+2. Continuously measuring child heights.
+3. Calculating total content height.
+4. Managing viewport wrapping adjustments (`marginTop`).
+
+It is "controlled" because it does not maintain its own scroll state; it purely renders
+based on the provided `scrollOffset` prop. This allows for flexible parent-controlled behavior.

package/node_modules/ink-scroll-view/docs/api/variables/ScrollView.md

@@ -0,0 +1,59 @@
+[**ink-scroll-view**](../README.md)
+
+---
+
+# Variable: ScrollView
+
+> `const` **ScrollView**: `ForwardRefExoticComponent`\<[`ScrollViewProps`](../interfaces/ScrollViewProps.md) & `RefAttributes`\<[`ScrollViewRef`](../interfaces/ScrollViewRef.md)\>\>
+
+A ScrollView component for Ink applications.
+
+## Remarks
+
+Allows scrolling through content that exceeds the visible area of the terminal.
+It manages a virtual viewport and renders all children, but strictly controls
+their visibility using `overflow="hidden"` and `marginTop` offsets.
+
+**Features:**
+
+- ↕️ Vertical scrolling
+- 📏 Auto-measurement of child heights
+- 🎯 Imperative scrolling methods via ref
+- 🔁 Dynamic content support (adding/removing children)
+- 🖥️ Viewport resize handling (via manual `remeasure`)
+
+**Important Notes:**
+
+- This component does NOT automatically capture keyboard input. You must use `useInput` in a parent component and control the scroll via the `onInput` hook or similar.
+- Children MUST generally have specific keys if you plan to dynamically update them, to ensure correct height tracking across renders.
+
+## Example
+
+```tsx
+import React, { useRef } from "react";
+import { Box, Text, useInput } from "ink";
+import { ScrollView, ScrollViewRef } from "ink-scroll-view";
+
+const Demo = () => {
+  const scrollRef = useRef<ScrollViewRef>(null);
+
+  useInput((input, key) => {
+    if (key.downArrow) {
+      scrollRef.current?.scrollBy(1);
+    }
+    if (key.upArrow) {
+      scrollRef.current?.scrollBy(-1);
+    }
+  });
+
+  return (
+    <Box height={10} borderStyle="single">
+      <ScrollView ref={scrollRef}>
+        {items.map((item) => (
+          <Text key={item.id}>{item.label}</Text>
+        ))}
+      </ScrollView>
+    </Box>
+  );
+};
+```

package/node_modules/ink-scroll-view/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "ink-scroll-view",
+  "version": "0.3.5",
+  "description": "A ScrollView component for Ink CLI applications",
+  "keywords": [
+    "react",
+    "ink",
+    "cli",
+    "terminal",
+    "scrollview",
+    "component",
+    "ui"
+  ],
+  "homepage": "https://www.byteland.app/opensource/ink-scroll-view",
+  "bugs": {
+    "url": "https://github.com/ByteLandTechnology/ink-scroll-view/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ByteLandTechnology/ink-scroll-view.git"
+  },
+  "license": "MIT",
+  "author": "ByteLand Technology <github@byteland.app>",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "source": "src/index.tsx",
+  "files": [
+    "docs",
+    "dist"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "prepare": "husky",
+    "build": "tsup",
+    "docs": "typedoc && prettier --write docs/api"
+  },
+  "peerDependencies": {
+    "ink": ">=6",
+    "react": ">=19"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.2.0",
+    "@commitlint/config-conventional": "^20.2.0",
+    "@sindresorhus/tsconfig": "^8.1.0",
+    "@types/ink": "^0.5.2",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.7",
+    "husky": "^9.1.7",
+    "ink": "^6.5.1",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.7.4",
+    "react": "^19.2.1",
+    "tsup": "^8.5.1",
+    "typedoc": "^0.28.15",
+    "typedoc-plugin-markdown": "^4.9.0",
+    "vitest": "^4.0.16"
+  }
+}

package/node_modules/ink-spinner/build/index.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="react" />
+import type { SpinnerName } from 'cli-spinners';
+type Props = {
+    /**
+     * Type of a spinner.
+     * See [cli-spinners](https://github.com/sindresorhus/cli-spinners) for available spinners.
+     *
+     * @default dots
+     */
+    type?: SpinnerName;
+};
+/**
+ * Spinner.
+ */
+declare function Spinner({ type }: Props): JSX.Element;
+export default Spinner;

package/node_modules/ink-spinner/build/index.js

@@ -0,0 +1,24 @@
+import React, { useState, useEffect } from 'react';
+import { Text } from 'ink';
+import spinners from 'cli-spinners';
+/**
+ * Spinner.
+ */
+function Spinner({ type = 'dots' }) {
+    const [frame, setFrame] = useState(0);
+    const spinner = spinners[type];
+    useEffect(() => {
+        const timer = setInterval(() => {
+            setFrame(previousFrame => {
+                const isLastFrame = previousFrame === spinner.frames.length - 1;
+                return isLastFrame ? 0 : previousFrame + 1;
+            });
+        }, spinner.interval);
+        return () => {
+            clearInterval(timer);
+        };
+    }, [spinner]);
+    return React.createElement(Text, null, spinner.frames[frame]);
+}
+export default Spinner;
+//# sourceMappingURL=index.js.map

package/node_modules/ink-spinner/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../source/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAC,QAAQ,EAAE,SAAS,EAAC,MAAM,OAAO,CAAC;AACjD,OAAO,EAAC,IAAI,EAAC,MAAM,KAAK,CAAC;AACzB,OAAO,QAAQ,MAAM,cAAc,CAAC;AAapC;;GAEG;AACH,SAAS,OAAO,CAAC,EAAC,IAAI,GAAG,MAAM,EAAQ;IACtC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE/B,SAAS,CAAC,GAAG,EAAE;QACd,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE;gBACxB,MAAM,WAAW,GAAG,aAAa,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;gBAChE,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC;QACJ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAErB,OAAO,GAAG,EAAE;YACX,aAAa,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,oBAAC,IAAI,QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAQ,CAAC;AAC7C,CAAC;AAED,eAAe,OAAO,CAAC"}

package/node_modules/ink-spinner/license

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) Vadym Demedes <vadimdemedes@hey.com> (github.com/vadimdemedes)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/node_modules/ink-spinner/package.json

@@ -0,0 +1,75 @@
+{
+	"name": "ink-spinner",
+	"version": "5.0.0",
+	"description": "Spinner component for Ink",
+	"license": "MIT",
+	"repository": "vadimdemedes/ink-spinner",
+	"author": {
+		"name": "Vadim Demedes",
+		"email": "vadimdemedes@hey.com",
+		"url": "https://github.com/vadimdemedes"
+	},
+	"type": "module",
+	"exports": {
+		"types": "./build/index.d.ts",
+		"default": "./build/index.js"
+	},
+	"engines": {
+		"node": ">=14.16"
+	},
+	"scripts": {
+		"test": "tsc && xo && ava",
+		"prepare": "tsc"
+	},
+	"files": [
+		"build"
+	],
+	"keywords": [
+		"ink",
+		"progress",
+		"spinner",
+		"loader",
+		"loading",
+		"component",
+		"jsx",
+		"react"
+	],
+	"dependencies": {
+		"cli-spinners": "^2.7.0"
+	},
+	"devDependencies": {
+		"@sindresorhus/tsconfig": "^3.0.1",
+		"@types/react": "^18.0.0",
+		"@vdemedes/prettier-config": "^1.0.1",
+		"ava": "^5.1.1",
+		"delay": "^5.0.0",
+		"eslint-config-xo-react": "^0.27.0",
+		"eslint-plugin-react": "^7.32.2",
+		"eslint-plugin-react-hooks": "^4.6.0",
+		"ink": "^4.0.0",
+		"ink-testing-library": "^3.0.0",
+		"prettier": "^2.0.5",
+		"react": "^18.0.0",
+		"ts-node": "^10.9.1",
+		"typescript": "^4.9.5",
+		"xo": "^0.53.0"
+	},
+	"peerDependencies": {
+		"ink": ">=4.0.0",
+		"react": ">=18.0.0"
+	},
+	"ava": {
+		"extensions": {
+			"ts": "module",
+			"tsx": "module"
+		},
+		"nodeArguments": [
+			"--loader=ts-node/esm"
+		]
+	},
+	"xo": {
+		"extends": "xo-react",
+		"prettier": true
+	},
+	"prettier": "@vdemedes/prettier-config"
+}

package/node_modules/ink-spinner/readme.md

@@ -0,0 +1,39 @@
+# ink-spinner ![test](https://github.com/vadimdemedes/ink-spinner/workflows/test/badge.svg)
+
+> Spinner component for [Ink](https://github.com/vadimdemedes/ink). Uses [cli-spinners](https://github.com/sindresorhus/cli-spinners) for the collection of spinners.
+
+Looking for a version compatible with Ink 2.x? Check out [this release](https://github.com/vadimdemedes/ink-spinner/tree/v3.1.0).
+
+## Install
+
+```
+$ npm install ink-spinner
+```
+
+## Usage
+
+```jsx
+import React from 'react';
+import { render, Text } from 'ink';
+import Spinner from 'ink-spinner';
+
+render(
+	<Text>
+		<Text color="green">
+			<Spinner type="dots" />
+		</Text>
+		{' Loading'}
+	</Text>
+);
+```
+
+<img src="media/demo.gif" width="482">
+
+## Props
+
+### type
+
+Type: `string`<br>
+Defaults: `dots`
+
+Type of a spinner. See [cli-spinners](https://github.com/sindresorhus/cli-spinners) for available spinners.

package/node_modules/ink-text-input/build/index.d.ts

@@ -0,0 +1,46 @@
+import React from 'react';
+import type { Except } from 'type-fest';
+export type Props = {
+    /**
+     * Text to display when `value` is empty.
+     */
+    readonly placeholder?: string;
+    /**
+     * Listen to user's input. Useful in case there are multiple input components
+     * at the same time and input must be "routed" to a specific component.
+     */
+    readonly focus?: boolean;
+    /**
+     * Replace all chars and mask the value. Useful for password inputs.
+     */
+    readonly mask?: string;
+    /**
+     * Whether to show cursor and allow navigation inside text input with arrow keys.
+     */
+    readonly showCursor?: boolean;
+    /**
+     * Highlight pasted text
+     */
+    readonly highlightPastedText?: boolean;
+    /**
+     * Value to display in a text input.
+     */
+    readonly value: string;
+    /**
+     * Function to call when value updates.
+     */
+    readonly onChange: (value: string) => void;
+    /**
+     * Function to call when `Enter` is pressed, where first argument is a value of the input.
+     */
+    readonly onSubmit?: (value: string) => void;
+};
+declare function TextInput({ value: originalValue, placeholder, focus, mask, highlightPastedText, showCursor, onChange, onSubmit, }: Props): React.JSX.Element;
+export default TextInput;
+type UncontrolledProps = {
+    /**
+     * Initial value.
+     */
+    readonly initialValue?: string;
+} & Except<Props, 'value' | 'onChange'>;
+export declare function UncontrolledTextInput({ initialValue, ...props }: UncontrolledProps): React.JSX.Element;