@yukikisaku/pi-show-command-list-above 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yuki-kisaku
+
+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/README.md

@@ -0,0 +1,35 @@
+# pi-show-command-list-above
+
+## Overview
+
+Render Pi's slash-command autocomplete list above the editor.
+
+## Requirements
+
+Requires a Pi version whose `CustomEditor` internals match this package. It patches editor rendering for the active process and restores the original renderer on session shutdown.
+
+## Installation
+
+```sh
+pi install npm:@yukikisaku/pi-show-command-list-above
+```
+
+## Usage
+
+Start Pi normally. Slash-command autocomplete is moved above the editor; if compatible internals cannot be read, Pi keeps its standard layout.
+
+## Configuration
+
+No configuration.
+
+## Uninstallation
+
+```sh
+pi uninstall npm:@yukikisaku/pi-show-command-list-above
+```
+
+Remove any package-specific configuration described above if you no longer need it.
+
+## License
+
+MIT © yuki-kisaku. See [LICENSE](LICENSE).

package/index.ts

@@ -0,0 +1,94 @@
+import { CustomEditor, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+const PATCH_KEY = Symbol.for("pi-extension.command-list-above.patch");
+
+type RenderFn = (this: CustomEditor, width: number) => string[];
+
+type PatchState = {
+	originalRender: RenderFn;
+	patchedRender: RenderFn;
+};
+
+type AutocompleteListLike = {
+	render(width: number): string[];
+};
+
+type EditorInternals = {
+	autocompleteState?: unknown;
+	autocompleteList?: AutocompleteListLike;
+	paddingX?: number;
+};
+
+type PatchablePrototype = {
+	render: RenderFn;
+} & Record<PropertyKey, unknown>;
+
+function getPatchState(proto: PatchablePrototype): PatchState | undefined {
+	return proto[PATCH_KEY] as PatchState | undefined;
+}
+
+function getEditorContentWidth(editor: CustomEditor, width: number): number {
+	const internals = editor as unknown as EditorInternals;
+	const rawPadding = typeof internals.paddingX === "number" && Number.isFinite(internals.paddingX)
+		? Math.max(0, Math.floor(internals.paddingX))
+		: 0;
+	const maxPadding = Math.max(0, Math.floor((width - 1) / 2));
+	const paddingX = Math.min(rawPadding, maxPadding);
+	return Math.max(1, width - paddingX * 2);
+}
+
+function getAutocompleteLineCount(editor: CustomEditor, width: number): number {
+	const internals = editor as unknown as EditorInternals;
+	if (!internals.autocompleteState || !internals.autocompleteList) return 0;
+
+	try {
+		return internals.autocompleteList.render(getEditorContentWidth(editor, width)).length;
+	} catch {
+		// pi内部の実装が変わった場合は、表示を壊さず標準位置のままにする。
+		return 0;
+	}
+}
+
+function moveCommandListAbove(editor: CustomEditor, renderedLines: string[], width: number): string[] {
+	const autocompleteLineCount = getAutocompleteLineCount(editor, width);
+	if (autocompleteLineCount <= 0 || autocompleteLineCount >= renderedLines.length) {
+		return renderedLines;
+	}
+
+	const autocompleteStart = renderedLines.length - autocompleteLineCount;
+	const editorLines = renderedLines.slice(0, autocompleteStart);
+	const autocompleteLines = renderedLines.slice(autocompleteStart);
+	return [...autocompleteLines, ...editorLines];
+}
+
+function installCommandListAbovePatch(): void {
+	const proto = CustomEditor.prototype as unknown as PatchablePrototype;
+	if (getPatchState(proto)) return;
+
+	const originalRender = proto.render;
+	const patchedRender: RenderFn = function renderCommandListAbove(this: CustomEditor, width: number): string[] {
+		return moveCommandListAbove(this, originalRender.call(this, width), width);
+	};
+
+	proto.render = patchedRender;
+	proto[PATCH_KEY] = { originalRender, patchedRender } satisfies PatchState;
+}
+
+function uninstallCommandListAbovePatch(): void {
+	const proto = CustomEditor.prototype as unknown as PatchablePrototype;
+	const state = getPatchState(proto);
+	if (!state) return;
+
+	if (proto.render === state.patchedRender) {
+		proto.render = state.originalRender;
+	}
+	delete proto[PATCH_KEY];
+}
+
+export default function commandListAboveExtension(pi: ExtensionAPI): void {
+	installCommandListAbovePatch();
+
+	pi.on("session_shutdown", async () => {
+		uninstallCommandListAbovePatch();
+	});
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@yukikisaku/pi-show-command-list-above",
+  "version": "0.1.0",
+  "description": "Render Pi's slash-command autocomplete list above the editor.",
+  "type": "module",
+  "license": "MIT",
+  "author": "yuki-kisaku",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yukikisaku/pi-show-command-list-above.git"
+  },
+  "homepage": "https://github.com/yukikisaku/pi-show-command-list-above#readme",
+  "bugs": {
+    "url": "https://github.com/yukikisaku/pi-show-command-list-above/issues"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension"
+  ],
+  "files": [
+    "index.ts"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}