@elyx-code/project-logic-tree 0.0.7225 → 0.0.7226

package/dist/editor/extensions/module/command-builder.d.ts

@@ -0,0 +1,57 @@
+import { IComposableCommand, ICommandStep, ICommandStepContext, ICommandOptionItem, ICommandPart, CommandStepType, NamedColor, ICommandExecutionContext, ICommandExecutionResult, IBeforeSubmitResult, ICommandValidationResult } from './extensions';
+
+/**
+ * Fluent builder for creating an ICommandStep.
+ */
+export declare class StepBuilder<TContext = any> {
+    private step;
+    constructor(id: string, label: string);
+    static option<TContext = any>(id: string, label: string): StepBuilder<TContext>;
+    static argument<TContext = any>(id: string, label: string): StepBuilder<TContext>;
+    static custom<TContext = any>(id: string, label: string): StepBuilder<TContext>;
+    setType(type: CommandStepType): this;
+    setPlaceholder(placeholder: string | ((ctx: ICommandStepContext<TContext>) => string)): this;
+    setGhostHint(ghostHint: string | ((ctx: ICommandStepContext<TContext>) => string)): this;
+    setRequired(required: boolean | ((ctx: ICommandStepContext<TContext>) => boolean)): this;
+    setAllowFreeText(allowFreeText: boolean | ((ctx: ICommandStepContext<TContext>) => boolean)): this;
+    when(condition: (ctx: ICommandStepContext<TContext>) => boolean): this;
+    setOptions(getOptions: (query: string, ctx: ICommandStepContext<TContext>) => Promise<ICommandOptionItem[]>): this;
+    setPartResolver(resolvePart: (valueOrOption: any, ctx: ICommandStepContext<TContext>, partIndex: number) => ICommandPart): this;
+    setValidator(validatePart: (part: ICommandPart, ctx: ICommandStepContext<TContext>) => ICommandValidationResult | boolean): this;
+    onConfirmed(callback: (part: ICommandPart, ctx: ICommandStepContext<TContext>) => void): this;
+    build(): ICommandStep<TContext>;
+}
+/**
+ * Fluent builder for creating an IComposableCommand.
+ */
+export declare class CommandBuilder<TContext = any> {
+    private cmd;
+    private staticSteps;
+    private subcommandsMap;
+    constructor(name: string);
+    static create<TContext = any>(name: string): CommandBuilder<TContext>;
+    setLabel(label: string): this;
+    setDescription(description: string): this;
+    setCategory(category: string): this;
+    setIcon(icon: string): this;
+    setNamedColor(namedColor: NamedColor | string): this;
+    addSubcommand(name: string, subcommand: IComposableCommand<TContext> | CommandBuilder<TContext>): this;
+    setSubcommands(subcommands: Record<string, IComposableCommand<TContext>> | IComposableCommand<TContext>[]): this;
+    addStep(step: ICommandStep<TContext> | StepBuilder<TContext>): this;
+    setSteps(steps: ICommandStep<TContext>[] | ((ctx: ICommandStepContext<TContext>) => ICommandStep<TContext>[])): this;
+    setNextStepResolver(getNextStep: (ctx: ICommandStepContext<TContext>) => ICommandStep<TContext> | null): this;
+    onPartConfirmed(handler: (part: ICommandPart, ctx: ICommandStepContext<TContext>) => void | ICommandStep<TContext> | ICommandStep<TContext>[]): this;
+    onPartRemoved(handler: (part: ICommandPart, ctx: ICommandStepContext<TContext>) => void): this;
+    setValidator(validator: (ctx: ICommandStepContext<TContext>) => ICommandValidationResult | boolean): this;
+    setBeforeSubmit(beforeSubmit: (ctx: ICommandExecutionContext) => Promise<IBeforeSubmitResult>): this;
+    setExecutor(execute: (ctx: ICommandExecutionContext) => Promise<ICommandExecutionResult>): this;
+    build(): IComposableCommand<TContext>;
+}
+/**
+ * Functional factory helper for creating an IComposableCommand.
+ */
+export declare function createCommand<TContext = any>(config: IComposableCommand<TContext>): IComposableCommand<TContext>;
+/**
+ * Functional factory helper for creating an ICommandStep.
+ */
+export declare function createStep<TContext = any>(config: ICommandStep<TContext>): ICommandStep<TContext>;

package/dist/editor/extensions/module/command-step-resolver.d.ts

@@ -1,7 +1,11 @@
-import { IComposableCommand, ICommandStepResolution, ICommandPart } from './extensions';
+import { IComposableCommand, ICommandStepResolution, ICommandPart, ICommandStepContext } from './extensions';
 
 export declare function getSubcommandsList(cmd: IComposableCommand): IComposableCommand[];
 export declare function getSubcommandsMap(cmd: IComposableCommand): Record<string, IComposableCommand>;
+/**
+ * Creates a rich, standardized step context object for commands and lifecycle hooks.
+ */
+export declare function createStepContext<TContext = any>(activeCommand: IComposableCommand<TContext> | null, activeSubcommand: IComposableCommand<TContext> | null, confirmedParts: ICommandPart[], activeSegmentText: string, ctx?: TContext): ICommandStepContext<TContext>;
 /**
  * Dynamically resolves the active step, placeholder, ghost hint, and completion state
  * for a composable command based on the sequence of confirmed parts and active input.

package/dist/editor/extensions/module/extensions.d.ts

@@ -234,8 +234,10 @@ export declare enum NamedColor {
     ObjectValue = "object--value"
 }
 export interface ICommandPart {
+    id?: string;
+    stepId?: string;
     index: number;
-    type: 'command' | 'subcommand' | 'option' | 'argument' | 'text' | 'node';
+    type: 'command' | 'subcommand' | 'option' | 'argument' | 'text' | 'node' | string;
     label: string;
     sublabel?: string;
     value: string;
@@ -308,18 +310,43 @@ export interface ICommandOptionItem<TMetadata = any> {
     metadata?: TMetadata;
     rawEntity?: any;
 }
+export interface ICommandValidationResult {
+    isValid: boolean;
+    error?: string;
+}
+export interface ICommandStepContext<TContext = any> {
+    /** Project context / editor service */
+    context?: TContext;
+    project?: any;
+    /** Complete list of confirmed parts in sequence */
+    confirmedParts: ICommandPart[];
+    /** Dictionary mapping part id/type/stepId to ICommandPart */
+    partsMap: Record<string, ICommandPart>;
+    /** Text currently typed into active input segment */
+    activeSegmentText: string;
+    /** Active top-level command */
+    activeCommand: IComposableCommand<TContext> | null;
+    /** Active subcommand (if any) */
+    activeSubcommand: IComposableCommand<TContext> | null;
+    /** Helper to retrieve the value of a specific part by step ID or type */
+    getPartValue: <T = string>(idOrType: string) => T | undefined;
+    /** Helper to retrieve the full ICommandPart by step ID or type */
+    getPart: (idOrType: string) => ICommandPart | undefined;
+}
 export interface ICommandStep<TContext = any> {
     id: string;
     type: CommandStepType;
     label: string;
-    placeholder?: string;
-    ghostHint?: string;
-    required?: boolean;
-    allowFreeText?: boolean;
-    isEnabled?: (confirmedParts: ICommandPart[], ctx?: TContext) => boolean;
-    getOptions?: (query: string, ctx: TContext) => Promise<ICommandOptionItem[]>;
-    resolvePart: (valueOrOption: any, ctx: TContext, partIndex: number) => ICommandPart;
-    isStepSatisfied?: (value: string | ICommandPart, ctx: TContext) => boolean;
+    placeholder?: string | ((ctx: ICommandStepContext<TContext>) => string);
+    ghostHint?: string | ((ctx: ICommandStepContext<TContext>) => string);
+    required?: boolean | ((ctx: ICommandStepContext<TContext>) => boolean);
+    allowFreeText?: boolean | ((ctx: ICommandStepContext<TContext>) => boolean);
+    isEnabled?: (ctx: ICommandStepContext<TContext>) => boolean;
+    getOptions?: (query: string, ctx: ICommandStepContext<TContext>) => Promise<ICommandOptionItem[]>;
+    resolvePart: (valueOrOption: any, ctx: ICommandStepContext<TContext>, partIndex: number) => ICommandPart;
+    isStepSatisfied?: (value: string | ICommandPart, ctx: ICommandStepContext<TContext>) => boolean;
+    validatePart?: (part: ICommandPart, ctx: ICommandStepContext<TContext>) => ICommandValidationResult | boolean;
+    onConfirmed?: (part: ICommandPart, ctx: ICommandStepContext<TContext>) => void;
 }
 export interface IComposableCommand<TContext = any> {
     name: string;
@@ -329,7 +356,12 @@ export interface IComposableCommand<TContext = any> {
     icon?: string;
     namedColor?: NamedColor | string;
     subcommands?: Record<string, IComposableCommand<TContext>> | IComposableCommand<TContext>[];
-    steps?: ICommandStep<TContext>[] | ((confirmedParts: ICommandPart[], ctx?: TContext) => ICommandStep<TContext>[]);
+    steps?: ICommandStep<TContext>[] | ((ctx: ICommandStepContext<TContext>) => ICommandStep<TContext>[]);
+    getNextStep?: (ctx: ICommandStepContext<TContext>) => ICommandStep<TContext> | null;
+    onInit?: (ctx: ICommandStepContext<TContext>) => void;
+    onPartConfirmed?: (part: ICommandPart, ctx: ICommandStepContext<TContext>) => void | ICommandStep<TContext> | ICommandStep<TContext>[];
+    onPartRemoved?: (part: ICommandPart, ctx: ICommandStepContext<TContext>) => void;
+    validate?: (ctx: ICommandStepContext<TContext>) => ICommandValidationResult | boolean;
     beforeSubmit?: (ctx: ICommandExecutionContext) => Promise<IBeforeSubmitResult>;
     execute?: (ctx: ICommandExecutionContext) => Promise<ICommandExecutionResult>;
     getOptions?: (stage: CommandStage, query: string, ctx: ICommandAutocompleteContext) => Promise<any[]>;
@@ -344,6 +376,7 @@ export interface ICommandStepResolution<TContext = any> {
     ghostHint?: string;
     allowFreeText: boolean;
     stage: CommandStage;
+    context?: ICommandStepContext<TContext>;
 }
 export interface ICommandExtensionModule extends IExtensionModuleCore {
     beforeSubmit?: (ctx: ICommandExecutionContext) => Promise<IBeforeSubmitResult>;

package/dist/editor/extensions/module/index.d.ts

@@ -1,3 +1,4 @@
 export * from './extensions';
 export * from './defaults';
 export * from './command-step-resolver';
+export * from './command-builder';