@mrclrchtr/supi-extras 1.2.0 → 1.3.0

package/node_modules/@mrclrchtr/supi-core/README.md

@@ -12,7 +12,12 @@ pnpm add @mrclrchtr/supi-core
 
 ## Package role
 
-`@mrclrchtr/supi-core` is a library package. It does **not** register a pi extension and is not meant to be installed as a standalone pi package.
+`@mrclrchtr/supi-core` now has two explicit surfaces:
+
+- `@mrclrchtr/supi-core/api` — shared library helpers for other SuPi packages
+- `@mrclrchtr/supi-core/extension` — a minimal pi extension that registers `/supi-settings`
+
+`pi.extensions` still points at the real file path `./src/extension.ts` inside the package. The `/api` and `/extension` paths are consumer-facing package exports, not manifest aliases.
 
 ## What it provides
 
@@ -59,7 +64,7 @@ Main helpers:
 ## Example
 
 ```ts
-import { loadSupiConfig, registerConfigSettings, wrapExtensionContext } from "@mrclrchtr/supi-core";
+import { loadSupiConfig, registerConfigSettings, wrapExtensionContext } from "@mrclrchtr/supi-core/api";
 
 const config = loadSupiConfig("my-extension", process.cwd(), {
   enabled: true,
@@ -87,4 +92,5 @@ const message = wrapExtensionContext("my-extension", "hello", {
 
 ## Source
 
-- Main exports: `src/index.ts`
+- Library surface: `src/api.ts`
+- Extension surface: `src/extension.ts`

package/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {
@@ -30,5 +30,15 @@
       "optional": true
     }
   },
-  "main": "src/index.ts"
+  "main": "src/api.ts",
+  "exports": {
+    "./api": "./src/api.ts",
+    "./extension": "./src/extension.ts",
+    "./package.json": "./package.json"
+  },
+  "pi": {
+    "extensions": [
+      "./src/extension.ts"
+    ]
+  }
 }

package/node_modules/@mrclrchtr/supi-core/src/api.ts

@@ -0,0 +1,83 @@
+// supi-core — shared infrastructure for SuPi extensions.
+// Provides XML context tag wrapping, unified config system, context-message utilities,
+// and settings registry for supi-wide TUI settings.
+
+export type { SupiConfigLocation, SupiConfigOptions } from "./config.ts";
+export {
+  loadSupiConfig,
+  loadSupiConfigForScope,
+  removeSupiConfigKey,
+  writeSupiConfig,
+} from "./config.ts";
+export type { ConfigSettingsHelpers, ConfigSettingsOptions } from "./config-settings.ts";
+export { registerConfigSettings } from "./config-settings.ts";
+export type { ContextMessageLike } from "./context-messages.ts";
+export {
+  findLastUserMessageIndex,
+  getContextToken,
+  getPromptContent,
+  pruneAndReorderContextMessages,
+  restorePromptContent,
+} from "./context-messages.ts";
+export type { ContextProvider } from "./context-provider-registry.ts";
+export {
+  clearRegisteredContextProviders,
+  getRegisteredContextProviders,
+  registerContextProvider,
+} from "./context-provider-registry.ts";
+export { wrapExtensionContext } from "./context-tag.ts";
+export type {
+  DebugAgentAccess,
+  DebugEvent,
+  DebugEventInput,
+  DebugEventQuery,
+  DebugEventQueryResult,
+  DebugEventView,
+  DebugLevel,
+  DebugNotifyLevel,
+  DebugRegistryConfig,
+  DebugSummary,
+} from "./debug-registry.ts";
+export {
+  clearDebugEvents,
+  configureDebugRegistry,
+  DEBUG_REGISTRY_DEFAULTS,
+  getDebugEvents,
+  getDebugRegistryConfig,
+  getDebugSummary,
+  recordDebugEvent,
+  redactDebugData,
+  resetDebugRegistry,
+} from "./debug-registry.ts";
+export type { KnownRootEntry } from "./project-roots.ts";
+export {
+  buildKnownRootsMap,
+  byPathDepth,
+  dedupeTopmostRoots,
+  findProjectRoot,
+  isWithin,
+  isWithinOrEqual,
+  mergeKnownRoots,
+  resolveKnownRoot,
+  segmentCount,
+  sortRootsBySpecificity,
+  walkProject,
+} from "./project-roots.ts";
+export { getActiveBranchEntries } from "./session-utils.ts";
+export { registerSettingsCommand } from "./settings-command.ts";
+export type { SettingsScope, SettingsSection } from "./settings-registry.ts";
+export {
+  clearRegisteredSettings,
+  getRegisteredSettings,
+  registerSettings,
+} from "./settings-registry.ts";
+export { createInputSubmenu, openSettingsOverlay } from "./settings-ui.ts";
+export type { TitleTarget } from "./terminal.ts";
+export {
+  DONE_SYMBOL,
+  formatTitle,
+  signalBell,
+  signalDone,
+  signalWaiting,
+  WAITING_SYMBOL,
+} from "./terminal.ts";

package/node_modules/@mrclrchtr/supi-core/src/extension.ts

@@ -0,0 +1 @@
+export { registerSettingsCommand as default } from "./settings-command.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-extras",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "SuPi extras — command aliases, skill shorthand, tab spinner, /supi-stash prompt stash with TUI overlay, and other small utilities",
   "license": "MIT",
   "repository": {
@@ -21,12 +21,12 @@
   ],
   "dependencies": {
     "clipboardy": "^5.3.1",
-    "@mrclrchtr/supi-core": "1.2.0"
+    "@mrclrchtr/supi-core": "1.3.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"
   ],
-  "main": "src/index.ts",
+  "main": "src/api.ts",
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*"
@@ -41,7 +41,12 @@
   },
   "pi": {
     "extensions": [
-      "./src/index.ts"
+      "./src/extension.ts"
     ]
+  },
+  "exports": {
+    "./api": "./src/api.ts",
+    "./extension": "./src/extension.ts",
+    "./package.json": "./package.json"
   }
 }

package/src/api.ts

@@ -0,0 +1 @@
+export { default } from "./index.ts";

package/src/clipboard.ts

@@ -1,15 +1,19 @@
 /**
  * Shared clipboard utility for supi-extras.
  *
- * Copies text to the system clipboard via `clipboardy`, a cross-platform
- * wrapper around platform-native clipboard tools.
+ * Copies text to the system clipboard. Uses `clipboardy` when available
+ * (preferred cross-platform wrapper), falls back gracefully otherwise.
+ *
+ * The import is lazy so the extension always loads — clipboard functionality
+ * degrades gracefully when `clipboardy` is not installed or unavailable.
  */
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import clipboard from "clipboardy";
 
 /**
  * Copy text to the system clipboard.
  *
+ * Uses a dynamic import of `clipboardy` to avoid hard-load failures.
+ *
  * @returns `true` on success, `false` on failure.
  */
 export async function copyToClipboard(
@@ -18,6 +22,7 @@ export async function copyToClipboard(
   _pi: ExtensionAPI,
 ): Promise<boolean> {
   try {
+    const { default: clipboard } = await import("clipboardy");
     await clipboard.write(text);
     return true;
   } catch {

package/src/extension.ts

@@ -0,0 +1 @@
+export { default } from "./index.ts";

package/src/tab-spinner.ts

@@ -10,7 +10,7 @@
  * agent starts or the session shuts down.
  */
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { formatTitle, signalDone } from "@mrclrchtr/supi-core";
+import { formatTitle, signalDone } from "@mrclrchtr/supi-core/api";
 
 const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];