citadel_cli 1.1.7 → 1.4.0

package/dist/components/Citadel/components/AvailableCommands.d.ts

@@ -1,2 +1,6 @@
 import { default as React } from 'react';
-export declare const AvailableCommands: React.FC;
+interface AvailableCommandsProps {
+    currentInput?: string;
+}
+export declare const AvailableCommands: React.FC<AvailableCommandsProps>;
+export {};

package/dist/components/Citadel/components/CommandOutputLine.d.ts

@@ -4,6 +4,8 @@ interface CommandOutputLineProps {
     command: string;
     timestamp: string;
     status: CommandStatus;
+    fontFamily?: string;
+    fontSize?: string;
 }
 export declare const CommandOutputLine: React.FC<CommandOutputLineProps>;
 export {};

package/dist/components/Citadel/config/defaults.d.ts

@@ -14,7 +14,11 @@ import { CitadelConfig } from './types';
  * @property includeHelpCommand - When true, automatically adds a 'help' command that displays all available commands.
  *                               When false, no help command will be shown. Default: true.
  *
- * @property initialHeight - The initial CSS height of the interface. Default: '40vh'.
+ * @property fontFamily - The font family used by the interface. Default: 'monospace'.
+ *
+ * @property fontSize - The default font size used by the interface. Default: '0.875rem'.
+ *
+ * @property initialHeight - The initial CSS height of the interface. Default: '50vh'.
  *
  * @property logLevel - The logging level for the Citadel interface. Default: DEBUG in development, ERROR in production.
  *
@@ -22,7 +26,7 @@ import { CitadelConfig } from './types';
  *
  * @property minHeight - The minimum CSS height of the interface. Default: '200'.
  *
- * @property outputFontSize - The TailwindCSS class for the font size of the output text. Default: 'text-sm'.
+ * @property outputFontSize - The output font size as a CSS value. Default: '0.875rem'.
  *
  * @property resetStateOnHide - When true, hiding the interface (via Escape key or other means) will clear the command input.
  *                             When false, the interface preserves the last input when hidden. Default: false.

package/dist/components/Citadel/config/types.d.ts

@@ -26,6 +26,17 @@ export interface CitadelConfig {
      * Whether to include the default help command in the command registry.
      */
     includeHelpCommand?: boolean;
+    /**
+     * The font family used by the interface.
+     * Accepts any valid CSS `font-family` value.
+     * Example: '"JetBrains Mono", monospace'
+     */
+    fontFamily?: string;
+    /**
+     * The default font size used by the interface.
+     * Accepts any valid CSS `font-size` value (e.g. '14px', '0.875rem').
+     */
+    fontSize?: string;
     /**
      * The initial height of the command interface.
      * Accepts any valid CSS height value.
@@ -49,8 +60,9 @@ export interface CitadelConfig {
     maxHeight?: string;
     minHeight?: string;
     /**
-     * The font size for the command output text.
-     * Accepts Tailwind text size classes: 'text-xs', 'text-sm', 'text-base', 'text-lg', etc.
+     * The font size for command output text.
+     * Accepts any valid CSS `font-size` value (e.g. '14px', '0.875rem').
+     * If omitted, output uses `fontSize`.
      */
     outputFontSize?: string;
     /**

package/dist/components/Citadel/types/__tests__/command-dsl.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/Citadel/types/command-dsl.d.ts

@@ -0,0 +1,32 @@
+import { CommandRegistry, CommandSegment } from './command-registry';
+import { CommandResult, ErrorCommandResult, ImageCommandResult, JsonCommandResult, TextCommandResult } from './command-results';
+export interface CommandExecutionContext<ArgName extends string = string> {
+    rawArgs: string[];
+    namedArgs: Record<ArgName, string | undefined>;
+    commandPath: string;
+}
+export type DslCommandHandler<ArgName extends string = string> = (context: CommandExecutionContext<ArgName>) => CommandResult | Promise<CommandResult>;
+export interface CommandDefinition<ArgName extends string = string> {
+    path: string;
+    description: string;
+    details?: string;
+    segments: CommandSegment[];
+    handler: DslCommandHandler<ArgName>;
+}
+export interface ArgumentBuilderApi {
+    describe(description: string): this;
+}
+export interface CommandBuilderApi<ArgName extends string = never> {
+    describe(description: string): this;
+    details(details: string): this;
+    arg<Name extends string>(name: Name, configure?: (argument: ArgumentBuilderApi) => ArgumentBuilderApi | void): CommandBuilderApi<ArgName | Name>;
+    handle(handler: DslCommandHandler<ArgName>): CommandDefinition<ArgName>;
+}
+export declare function command(path: string): CommandBuilderApi;
+export declare function registerCommand(registry: CommandRegistry, definition: CommandDefinition): void;
+export declare function registerCommands(registry: CommandRegistry, definitions: CommandDefinition[]): CommandRegistry;
+export declare function createCommandRegistry(definitions: CommandDefinition[]): CommandRegistry;
+export declare function text(value: string): TextCommandResult;
+export declare function json(value: unknown): JsonCommandResult;
+export declare function image(url: string, altText?: string): ImageCommandResult;
+export declare function error(value: string): ErrorCommandResult;

package/dist/components/Citadel/types/command-registry.d.ts

@@ -34,6 +34,8 @@ export declare class ArgumentSegment extends BaseSegment {
     readonly valid?: (() => boolean) | undefined;
     constructor(name: string, description?: string, value?: string | undefined, valid?: (() => boolean) | undefined);
 }
+export declare const cloneCommandSegment: (segment: CommandSegment) => CommandSegment;
+export declare const cloneCommandSegments: (segments: CommandSegment[]) => CommandSegment[];
 /** Defines a complete command with its path and behavior */
 export declare class CommandNode {
     private readonly _segments;
@@ -88,6 +90,16 @@ export declare class CommandRegistry {
      * @returns An array of completion strings.
      */
     getCompletionNames(path: string[]): string[];
+    /**
+     * Returns completion segments whose names start with the given prefix.
+     * Matching is case-insensitive.
+     */
+    getMatchingCompletions(path: string[], prefix: string): CommandSegment[];
+    /**
+     * Returns a single completion when prefix matching is unambiguous.
+     * Returns undefined for ambiguous or no-match prefixes.
+     */
+    getUniqueCompletion(path: string[], prefix: string): CommandSegment | undefined;
     /**
      * Gets an array of segments reachable from a given path
      *

package/dist/components/Citadel/types/index.d.ts

@@ -1,3 +1,4 @@
 export * from './state';
 export * from './cursor';
 export * from './command-results';
+export * from './command-dsl';

package/dist/components/Citadel/utils/typography.d.ts

@@ -0,0 +1,7 @@
+import { CSSProperties } from 'react';
+interface TypographySettings {
+    style?: CSSProperties;
+}
+export declare const resolveTextSize: (size?: string) => TypographySettings;
+export declare const resolveTypography: (fontFamily?: string, fontSize?: string) => TypographySettings;
+export {};

package/dist/examples/__tests__/runtimeConfigCommands.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/examples/devopsCommands.d.ts

@@ -0,0 +1,2 @@
+import { CommandRegistry } from '../components/Citadel/types/command-registry';
+export declare function createDevOpsCommandRegistry(): CommandRegistry;

package/dist/examples/localDevCommands.d.ts

@@ -0,0 +1,2 @@
+import { CommandRegistry } from '../components/Citadel/types/command-registry';
+export declare function createLocalDevCommandRegistry(): CommandRegistry;

package/dist/examples/runtimeConfigCommands.d.ts

@@ -1,4 +1,5 @@
 import { CommandRegistry } from '../components/Citadel/types/command-registry';
+import { CommandDefinition } from '../components/Citadel/types/command-dsl';
 import { CursorType } from '../components/Citadel/types/cursor';
 export type DisplayMode = 'panel' | 'inline';
 export declare const RUNTIME_CONFIG_CURSOR_TYPES: readonly CursorType[];
@@ -7,6 +8,8 @@ export interface RuntimeConfigControls {
     setCursorColor: (color: string) => void;
     setDisplayMode: (mode: DisplayMode) => void;
     setIncludeHelpCommand: (enabled: boolean) => void;
+    setMaxHeight: (value: string) => void;
     resetConfig: () => void;
 }
 export declare function registerRuntimeConfigCommands(registry: CommandRegistry, controls: RuntimeConfigControls): void;
+export declare function createRuntimeConfigCommandDefinitions(controls: RuntimeConfigControls): CommandDefinition[];

package/package.json

@@ -17,7 +17,7 @@
     "type": "git",
     "url": "git+https://github.com/jchilders/citadel_cli.git"
   },
-  "version": "1.1.7",
+  "version": "1.4.0",
   "type": "module",
   "scripts": {
     "build": "tsc && vite build",
@@ -30,6 +30,11 @@
     "test:e2e": "playwright test",
     "test:e2e:ui": "playwright test --ui",
     "coverage": "vitest run --coverage",
+    "metrics:build": "node scripts/metrics/collect-build-metrics.mjs",
+    "metrics:runtime": "node scripts/metrics/collect-runtime-metrics.mjs",
+    "metrics:compare": "node scripts/metrics/compare-metrics.mjs",
+    "metrics:all": "node scripts/metrics/run-all-metrics.mjs",
+    "metrics:report": "node scripts/metrics/run-all-metrics.mjs --skip-build --skip-runtime",
     "postinstall": "playwright install"
   },
   "exports": {
@@ -39,7 +44,7 @@
       "import": "./dist/citadel.es.js",
       "require": "./dist/citadel.umd.cjs"
     },
-    "./styles.css": "./dist/styles.css",
+    "./styles.css": "./dist/citadel.css",
     "./citadel.css": "./dist/citadel.css"
   },
   "types": "./dist/index.d.ts",
@@ -65,15 +70,13 @@
     "@types/react-dom": "^18.2.21",
     "@vitejs/plugin-react": "^4.3.3",
     "@vitest/coverage-v8": "^2.1.6",
-    "autoprefixer": "^10.4.20",
     "eslint": "^9.13.0",
     "eslint-plugin-react-hooks": "^5.0.0",
+    "eslint-plugin-react-perf": "^3.3.3",
     "eslint-plugin-react-refresh": "^0.4.14",
     "globals": "^15.11.0",
     "jsdom": "^25.0.1",
     "playwright": "^1.49.0",
-    "postcss": "^8.4.49",
-    "tailwindcss": "^3.4.17",
     "typescript": "^5.4.2",
     "typescript-eslint": "^8.11.0",
     "vite": "^5.1.5",

package/dist/citadel.css

@@ -1 +0,0 @@
-._panelContainer_1pav9_3{position:fixed;height:var(--citadel-default-height);min-height:var(--citadel-min-height);max-height:var(--citadel-max-height);background-color:var(--citadel-bg);overflow:hidden;width:100%;box-sizing:border-box;margin:0;padding:0;bottom:0;left:0;right:0}._innerContainer_1pav9_19{height:100%;flex:1;width:100%;display:flex;flex-direction:column;margin:0;padding:0}._inputSection_1pav9_29{border-top:1px solid var(--citadel-border);padding:1rem;margin:0;box-sizing:border-box}._resizeHandle_1pav9_36{width:100%;height:6px;background:transparent;cursor:ns-resize;position:absolute;top:-3px;left:0;right:0;z-index:10;-moz-user-select:none;user-select:none;-webkit-user-select:none;pointer-events:all}._resizeHandle_1pav9_36:hover{background:#ffffff1a}@keyframes _citadel_slideUp_1pav9_65{0%{transform:translateY(100%)}to{transform:translateY(0)}}@keyframes _citadel_slideDown_1pav9_69{0%{transform:translateY(0)}to{transform:translateY(100%)}}._citadel_slideUp_1pav9_65{animation:_citadel_slideUp_1pav9_65 .2s ease-out forwards}._citadel_slideDown_1pav9_69{animation:_citadel_slideDown_1pav9_69 .2s ease-out forwards}._inlineContainer_1pav9_73{position:relative;width:100%;height:100%;display:flex;flex-direction:column;background-color:var(--citadel-bg);overflow:hidden;box-sizing:border-box}