@soederpop/luca 0.1.1 → 0.1.3

package/dist/container.d.ts

@@ -0,0 +1,451 @@
+import { Bus } from './bus';
+import { SetStateValue, State } from './state';
+import { AvailableFeatures, Feature, FeaturesRegistry } from './feature';
+import { Helper } from './helper';
+import { uniq, keyBy, uniqBy, groupBy, debounce, throttle, mapValues, mapKeys, pick, get, set, omit, kebabCase, camelCase, upperFirst, lowerFirst } from 'lodash-es';
+import { pluralize, singularize } from 'inflect';
+import { z } from 'zod';
+import { ContainerStateSchema } from './schemas/base';
+import { type ContainerIntrospection, type IntrospectionSection } from './introspection/index';
+import { ContainerDescriber } from './container-describer';
+export { z };
+export type { AvailableFeatures };
+export type AvailableInstanceTypes<T> = {
+    [K in keyof T]: T[K] extends new (...args: any) => any ? InstanceType<T[K]> : never;
+};
+/**
+ * You'll want to use module augmentation to add your own options to the ContainerArgv interface
+ */
+export interface ContainerArgv {
+    _?: string[];
+}
+export type ContainerState = z.infer<typeof ContainerStateSchema>;
+export interface Plugin<T> {
+    attach?: (container: Container<any> & T, options?: any) => any;
+}
+export type Extension<T> = 'string' | keyof AvailableFeatures | Plugin<T> | {
+    attach: (container: Container<any>, options?: any) => T;
+};
+export interface ContainerUtils {
+    /** Generate a v4 UUID */
+    uuid: () => string;
+    /** Deterministic hash of any object */
+    hashObject: (obj: any) => string;
+    /** String case conversion and inflection utilities */
+    stringUtils: {
+        kebabCase: typeof kebabCase;
+        camelCase: typeof camelCase;
+        upperFirst: typeof upperFirst;
+        lowerFirst: typeof lowerFirst;
+        pluralize: typeof pluralize;
+        singularize: typeof singularize;
+    };
+    /** Lodash utility subset */
+    lodash: {
+        uniq: typeof uniq;
+        keyBy: typeof keyBy;
+        uniqBy: typeof uniqBy;
+        groupBy: typeof groupBy;
+        debounce: typeof debounce;
+        throttle: typeof throttle;
+        mapValues: typeof mapValues;
+        mapKeys: typeof mapKeys;
+        pick: typeof pick;
+        get: typeof get;
+        set: typeof set;
+        omit: typeof omit;
+    };
+}
+export interface ContainerContext<T extends AvailableFeatures = any> {
+    container: Container<T>;
+}
+/**
+ * The Container is the core runtime object in Luca. It is a singleton per process that acts as an
+ * event bus, state machine, and dependency injector. It holds registries of helpers (features, clients,
+ * servers, commands, endpoints) and provides factory methods to create instances from them.
+ *
+ * All helper instances share the container's context, enabling them to communicate and coordinate.
+ * The container detects its runtime environment (Node, Bun, browser, Electron) and can load
+ * platform-specific feature implementations accordingly.
+ *
+ * Use `container.feature('name')` to create feature instances, `container.use(Plugin)` to extend
+ * the container with new capabilities, and `container.on('event', handler)` to react to lifecycle events.
+ *
+ * @example
+ * ```ts
+ * // Create a feature instance (cached — same args return same instance)
+ * const fs = container.feature('fs')
+ * const content = fs.readFile('README.md')
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Listen for state changes
+ * container.on('stateChange', (state) => console.log('State changed:', state))
+ * container.setState({ started: true })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Extend with a plugin
+ * container.use(MyClient)  // calls MyClient.attach(container)
+ * container.use('contentDb') // enable a feature by name
+ * ```
+*/
+export declare class Container<Features extends AvailableFeatures = AvailableFeatures, ContainerState extends ContainerState = ContainerState> {
+    static stateSchema: z.ZodObject<{
+        started: z.ZodDefault<z.ZodBoolean>;
+        enabledFeatures: z.ZodArray<z.ZodString>;
+        registries: z.ZodArray<z.ZodString>;
+        factories: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    readonly uuid: string;
+    private readonly _events;
+    private readonly _state;
+    /**
+     * You can use module augmentation to define the starting interface for your container
+     * whether it is process.argv, process.env, or some combination thereof
+     */
+    readonly options: ContainerArgv;
+    constructor(options: ContainerArgv);
+    /**
+     * Creates a new subcontainer instance of the same concrete Container subclass.
+     * The new instance is constructed with the same options as this container,
+     * shallow-merged with any overrides you provide. This preserves the runtime
+     * container type (e.g. NodeContainer, AGIContainer, etc.).
+     *
+     * @param options - Options to override for the new container instance
+     * @returns A new container instance of the same subclass
+     *
+     * @example
+     * ```ts
+     * const child = container.subcontainer({ cwd: '/tmp/workspace' })
+     * child.cwd // '/tmp/workspace'
+     * ```
+     */
+    subcontainer<This extends Container<any, any>>(this: This, options: ConstructorParameters<This['constructor']>[0]): This;
+    z: typeof z;
+    /** The observable state object for this container instance. */
+    get state(): State<ContainerState>;
+    /** Returns the list of shortcut IDs for all currently enabled features. */
+    get enabledFeatureIds(): string[];
+    /** Returns a map of enabled feature shortcut IDs to their instances. */
+    get enabledFeatures(): Partial<AvailableInstanceTypes<Features>>;
+    /**
+     * Common utilities available on every container. Provides UUID generation, object hashing,
+     * string case conversion, and lodash helpers — no imports needed.
+     *
+     * - `utils.uuid()` — generate a v4 UUID
+     * - `utils.hashObject(obj)` — deterministic hash of any object
+     * - `utils.stringUtils` — `{ kebabCase, camelCase, upperFirst, lowerFirst, pluralize, singularize }`
+     * - `utils.lodash` — `{ uniq, keyBy, uniqBy, groupBy, debounce, throttle, mapValues, mapKeys, pick, get, set, omit }`
+     *
+     * @example
+     * ```ts
+     * const id = container.utils.uuid()
+     * const hash = container.utils.hashObject({ foo: 'bar' })
+     * const name = container.utils.stringUtils.camelCase('my-feature')
+     * const unique = container.utils.lodash.uniq([1, 2, 2, 3])
+     * ```
+     */
+    get utils(): ContainerUtils;
+    private _describer?;
+    /**
+     * Lazy-initialized ContainerDescriber for introspecting registries, helpers, and members.
+     * @internal
+     */
+    get describer(): ContainerDescriber;
+    addContext<K extends keyof ContainerContext>(key: K, value: ContainerContext[K]): this;
+    addContext(context: Partial<ContainerContext>): this;
+    /**
+     * The Container's context is an object that contains the enabled features, the container itself, and any additional context that has been added to the container.
+     *
+     * All helper instances that are created by the container will have access to the shared context.
+    */
+    get context(): ContainerContext<Features> & Partial<AvailableInstanceTypes<AvailableFeatures>>;
+    /**
+     * The current state of the container.
+     *
+     * This is a snapshot of the container's state at the time this method is called.
+     *
+     * @returns The current state of the container.
+    */
+    get currentState(): ContainerState;
+    /**
+     * Sets the state of the container. Accepts a partial state object to merge, or a function
+     * that receives the current state and returns the new state.
+     *
+     * @param newState - A partial state object to merge, or a function `(current) => newState`
+     * @returns The container instance (for chaining)
+     *
+     * @example
+     * ```ts
+     * container.setState({ started: true })
+     * container.setState((prev) => ({ ...prev, started: true }))
+     * ```
+    */
+    setState(newState: SetStateValue<ContainerState>): this;
+    get Feature(): typeof Feature;
+    get Helper(): typeof Helper;
+    get State(): typeof State;
+    /**
+     * The features registry. Use it to check what features are available, look up feature classes,
+     * or check if a feature is registered.
+     *
+     * @example
+     * ```ts
+     * container.features.available   // ['fs', 'git', 'grep', ...]
+     * container.features.has('fs')   // true
+     * container.features.lookup('fs') // FS class
+     * ```
+     */
+    get features(): FeaturesRegistry;
+    /**
+     * Create a new standalone event bus instance. Useful when you need a scoped event channel
+     * that is independent of the container's own event bus.
+     *
+     * @returns A new Bus instance
+     *
+     * @example
+     * ```ts
+     * const myBus = container.bus()
+     * myBus.on('data', (payload) => console.log(payload))
+     * myBus.emit('data', { count: 42 })
+     * ```
+    */
+    bus(): Bus;
+    /**
+     * Create a new standalone observable State object. Useful when you need reactive state
+     * that is independent of the container's own state.
+     *
+     * @param initialState - The initial state object (defaults to empty)
+     * @returns A new State instance
+     *
+     * @example
+     * ```ts
+     * const myState = container.newState({ count: 0, loading: false })
+     * myState.observe(() => console.log('Changed:', myState.current))
+     * myState.set('count', 1)
+     * ```
+    */
+    newState<T extends object = any>(initialState?: T): State<T>;
+    /**
+     * Parse helper options through the helper's static options schema so defaults are materialized.
+     * @internal
+     */
+    normalizeHelperOptions(BaseClass: any, options: any, fallbackName?: string): any;
+    /** @internal */
+    buildHelperCacheKey(type: string, id: string, options: any, omitOptionKeys?: string[]): string;
+    /** @internal */
+    createHelperInstance({ cache, type, id, BaseClass, options, fallbackName, omitOptionKeys, context, }: {
+        cache: Map<string, any>;
+        type: string;
+        id: string;
+        BaseClass: any;
+        options?: any;
+        fallbackName?: string;
+        omitOptionKeys?: string[];
+        context?: any;
+    }): any;
+    /**
+     * Creates a new instance of a feature.
+     *
+     * If you pass the same arguments, it will return the same instance as last time you created that.
+     *
+     * If you need the ability to create fresh instances, it is up to you how you define your options to support that.
+     *
+     * @param id - The id of the feature to create.
+     * @param options - The options to pass to the feature constructor.
+     * @returns The new feature instance.
+    */
+    feature<T extends keyof Features>(id: T, options?: ConstructorParameters<Features[T]>[0]): InstanceType<Features[T]>;
+    /**
+     * Start the container. Emits the 'started' event and sets `state.started` to true.
+     * Plugins and features can listen for this event to perform initialization.
+     *
+     * @returns The container instance
+     *
+     * @example
+     * ```ts
+     * container.on('started', () => console.log('Ready'))
+     * await container.start()
+     * ```
+    */
+    start(): Promise<this>;
+    /**
+     * ENVIRONMENT DETECTION METHODS
+     *
+     * One of the ideas of the container is that it can detect what kind of environment it is running in and
+     * e.g. perhaps load different versions of features to provide the same API with different implementations.
+     *
+    */
+    /**
+     * Returns true if the container is running in a browser.
+     */
+    get isBrowser(): boolean;
+    /**
+     * Returns true if the container is running in Bun.
+     */
+    get isBun(): boolean;
+    /**
+     * Returns true if the container is running in Node.
+     */
+    get isNode(): boolean;
+    /**
+     * Returns true if the container is running in Electron.
+     */
+    get isElectron(): boolean;
+    /**
+     * Returns true if the container is running in development mode.
+     */
+    get isDevelopment(): boolean;
+    /**
+     * Returns true if the container is running in production mode.
+     */
+    get isProduction(): boolean;
+    /**
+     * Returns true if the container is running in a CI environment.
+     */
+    get isCI(): boolean;
+    /**
+     * Emit an event on the container's event bus.
+     *
+     * @param event - The event name
+     * @param args - Arguments to pass to listeners
+     * @returns The container instance (for chaining)
+     *
+     * @example
+     * ```ts
+     * container.emit('taskCompleted', { id: 'abc', result: 42 })
+     * ```
+     */
+    emit(event: string, ...args: any[]): this;
+    /**
+     * Subscribe to an event on the container's event bus.
+     *
+     * @param event - The event name
+     * @param listener - The callback function
+     * @returns The container instance (for chaining)
+     *
+     * @example
+     * ```ts
+     * container.on('featureEnabled', (id, feature) => {
+     *   console.log(`Feature ${id} enabled`)
+     * })
+     * ```
+     */
+    on(event: string, listener: (...args: any[]) => void): this;
+    /**
+     * Unsubscribe a listener from an event on the container's event bus.
+     *
+     * @param event - The event name
+     * @param listener - The listener to remove
+     * @returns The container instance (for chaining)
+     */
+    off(event: string, listener?: (...args: any[]) => void): this;
+    /**
+     * Subscribe to an event on the container's event bus, but only fire once.
+     *
+     * @param event - The event name
+     * @param listener - The callback function (invoked at most once)
+     * @returns The container instance (for chaining)
+     */
+    once(event: string, listener: (...args: any[]) => void): this;
+    /**
+     * Returns a promise that resolves the next time the given event is emitted.
+     * Useful for awaiting one-time lifecycle transitions.
+     *
+     * @param event - The event name to wait for
+     * @returns A promise that resolves with the event arguments
+     *
+     * @example
+     * ```ts
+     * await container.waitFor('started')
+     * console.log('Container is ready')
+     * ```
+    */
+    waitFor(event: string): Promise<any>;
+    /**
+     * Register a helper type (registry + factory pair) on this container.
+     * Called automatically by Helper.attach() methods (e.g. Client.attach, Server.attach).
+     * @internal
+     */
+    registerHelperType(registryName: string, factoryName: string): this;
+    /** Returns the names of all attached registries (e.g. ["features", "clients", "servers"]). */
+    get registryNames(): string[];
+    /** Returns the names of all available factory methods (e.g. ["feature", "client", "server"]). */
+    get factoryNames(): string[];
+    /**
+     * Returns a full introspection object for this container, merging build-time AST data
+     * (JSDoc descriptions, methods, getters) with runtime data (registries, factories, state, environment).
+     *
+     * @returns The complete introspection data as a structured object
+     *
+     * @example
+     * ```ts
+     * const info = container.introspect()
+     * console.log(info.methods)   // all public methods with descriptions
+     * console.log(info.getters)   // all getters with return types
+     * console.log(info.registries) // features, clients, servers, etc.
+     * ```
+     */
+    introspect(): ContainerIntrospection;
+    /**
+     * Returns a human-readable markdown representation of this container's introspection data.
+     * Useful in REPLs, AI agent contexts, or documentation generation. Pass a section name
+     * to render only that section (e.g. 'methods', 'getters', 'events', 'state').
+     *
+     * @param sectionOrDepth - A section name to render, or heading depth number
+     * @param startHeadingDepth - Starting markdown heading depth (default 1)
+     * @returns Markdown-formatted introspection text
+     *
+     * @example
+     * ```ts
+     * console.log(container.introspectAsText())           // full description
+     * console.log(container.introspectAsText('methods'))   // just methods
+     * ```
+     */
+    introspectAsText(sectionOrDepth?: IntrospectionSection | number, startHeadingDepth?: number): string;
+    /** Returns JSON introspection data. */
+    introspectAsJSON(): ContainerIntrospection;
+    /**
+     * Returns the container's introspection data formatted as a TypeScript interface declaration.
+     * Includes the container's own methods, getters, factories, and registered helper types.
+     *
+     * @example
+     * ```ts
+     * console.log(container.introspectAsType())
+     * // interface NodeContainer {
+     * //   feature<T>(id: string, options?: object): T;
+     * //   readonly uuid: string;
+     * //   ...
+     * // }
+     * ```
+     */
+    introspectAsType(): string;
+    /** Make a property non-enumerable, which is nice for inspecting it in the REPL */
+    _hide(...propNames: string[]): this;
+    /** Sleep for the specified number of milliseconds. Useful for scripting and sequencing. */
+    sleep(ms?: number): Promise<this>;
+    _plugins: (() => void)[];
+    /**
+     * Apply a plugin or enable a feature by string name. Plugins are classes with a static `attach(container)` method
+     * that extend the container with new registries, factories, or capabilities.
+     *
+     * @param plugin - A feature name string, or a class/object with a static attach method
+     * @param options - Options to pass to the plugin's attach method
+     * @returns The container instance (with the plugin's type merged in)
+     *
+     * @example
+     * ```ts
+     * // Enable a feature by name
+     * container.use('contentDb')
+     *
+     * // Attach a plugin class (e.g. Client, Server, or custom)
+     * container.use(Client)    // registers the clients registry + client() factory
+     * container.use(Server)    // registers the servers registry + server() factory
+     * ```
+     */
+    use<T = {}>(plugin: Extension<T>, options?: any): this & T;
+}
+//# sourceMappingURL=container.d.ts.map

package/dist/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"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"}

package/dist/endpoint.d.ts

@@ -0,0 +1,113 @@
+import { Helper } from './helper.js';
+import type { Container } from './container.js';
+import { Registry } from './registry.js';
+import { z } from 'zod';
+import { EndpointStateSchema, EndpointOptionsSchema } from './schemas/base.js';
+export interface AvailableEndpoints {
+}
+export type EndpointState = z.infer<typeof EndpointStateSchema>;
+export type EndpointOptions = z.infer<typeof EndpointOptionsSchema>;
+export type EndpointHandler = (parameters: Record<string, any>, context: EndpointContext) => Promise<any> | any;
+export type EndpointContext = {
+    container: Container<any>;
+    request: any;
+    response: any;
+    query: Record<string, any>;
+    body: Record<string, any>;
+    params: Record<string, any>;
+};
+export interface EndpointRateLimit {
+    /** Maximum requests allowed per window */
+    maxRequests: number;
+    /** Window size in seconds (default: 1) */
+    windowSeconds?: number;
+}
+export interface EndpointModule {
+    path: string;
+    get?: EndpointHandler;
+    post?: EndpointHandler;
+    put?: EndpointHandler;
+    patch?: EndpointHandler;
+    delete?: EndpointHandler;
+    getSchema?: z.ZodType;
+    postSchema?: z.ZodType;
+    putSchema?: z.ZodType;
+    patchSchema?: z.ZodType;
+    deleteSchema?: z.ZodType;
+    /** Rate limit applied to all methods on this endpoint */
+    rateLimit?: EndpointRateLimit;
+    /** Per-method rate limits (overrides the endpoint-level rateLimit) */
+    getRateLimit?: EndpointRateLimit;
+    postRateLimit?: EndpointRateLimit;
+    putRateLimit?: EndpointRateLimit;
+    patchRateLimit?: EndpointRateLimit;
+    deleteRateLimit?: EndpointRateLimit;
+    description?: string;
+    tags?: string[];
+}
+/**
+ * Sliding-window rate limiter keyed by IP address.
+ * Tracks timestamps of requests and prunes entries older than the window.
+ */
+declare class RateLimiter {
+    private _windows;
+    /** Returns true if the request is allowed, false if rate-limited. */
+    allow(key: string, maxRequests: number, windowMs: number): boolean;
+    /** Clear all tracking state */
+    reset(): void;
+}
+export type EndpointFactory = <T extends keyof AvailableEndpoints>(key: T, options?: ConstructorParameters<AvailableEndpoints[T]>[0]) => NonNullable<InstanceType<AvailableEndpoints[T]>>;
+export interface EndpointsInterface {
+    endpoints: EndpointsRegistry;
+    endpoint: EndpointFactory;
+}
+export declare class Endpoint<T extends EndpointState = EndpointState, K extends EndpointOptions = EndpointOptions> extends Helper<T, K> {
+    static shortcut: string;
+    static description: string;
+    static stateSchema: z.ZodObject<{
+        mounted: z.ZodDefault<z.ZodBoolean>;
+        path: z.ZodDefault<z.ZodString>;
+        methods: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        requestCount: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        filePath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        loaded: z.ZodTuple<[z.ZodAny], null>;
+        mounted: z.ZodTuple<[z.ZodString], null>;
+        request: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodAny], null>;
+        error: z.ZodTuple<[z.ZodAny], null>;
+    }, z.core.$strip>;
+    private _module;
+    private _rateLimiter;
+    static attach(container: Container & EndpointsInterface): any;
+    get initialState(): T;
+    get path(): string;
+    get module(): EndpointModule | null;
+    get methods(): string[];
+    get isMounted(): boolean;
+    load(mod?: EndpointModule): Promise<this>;
+    reload(): Promise<this>;
+    handler(method: string): EndpointHandler | undefined;
+    schema(method: string): z.ZodType | undefined;
+    /** Returns the rate limit config for a given method, or undefined if none. */
+    rateLimitFor(method: string): EndpointRateLimit | undefined;
+    /** Access the rate limiter instance (useful for testing or manual resets) */
+    get rateLimiter(): RateLimiter;
+    mount(app: any): this;
+    toOpenAPIPathItem(): Record<string, any>;
+}
+export declare function warnUnknownExports(mod: Record<string, any>, filePath: string): void;
+export declare class EndpointsRegistry extends Registry<Endpoint<any>> {
+    scope: string;
+    baseClass: typeof Endpoint;
+}
+export declare const endpoints: EndpointsRegistry;
+export declare const helperCache: Map<any, any>;
+export default Endpoint;
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../src/endpoint.ts"],"names":[],"mappings":"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"}

package/dist/feature.d.ts

@@ -0,0 +1,47 @@
+import { Helper } from './helper.js';
+import { Registry } from './registry.js';
+import type { ContainerContext } from './container.js';
+import type { YAML } from './node/features/yaml.js';
+import { z } from 'zod';
+import { FeatureStateSchema, FeatureOptionsSchema } from './schemas/base.js';
+/**
+ * Use module augmentation to register features, the same way you would register
+ * them at runtime.  This will help developers get autocomplete etc.
+*/
+export interface AvailableFeatures {
+    yaml: typeof YAML;
+}
+export type FeatureOptions = z.infer<typeof FeatureOptionsSchema>;
+export type FeatureState = z.infer<typeof FeatureStateSchema>;
+export declare abstract class Feature<T extends FeatureState = FeatureState, K extends FeatureOptions = FeatureOptions> extends Helper<T, K> {
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        enabled: z.ZodTuple<[], null>;
+    }, z.core.$strip>;
+    /** Self-register a Feature subclass from a static initialization block. */
+    static register: (SubClass: typeof Feature, id?: string) => typeof Feature;
+    get shortcut(): string;
+    get isEnabled(): T["enabled"] | undefined;
+    constructor(options: K, context: ContainerContext);
+    /**
+     * For features where there only needs to be a single instance, you
+     * can use this method to attach the feature to the container.
+    */
+    protected attachToContainer(): void;
+    enable(options?: any): Promise<this>;
+}
+export declare class FeaturesRegistry extends Registry<Feature<any, any>> {
+    scope: string;
+    baseClass: any;
+}
+export declare const features: FeaturesRegistry;
+//# sourceMappingURL=feature.d.ts.map

package/dist/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../src/feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAuB,MAAM,mBAAmB,CAAA;AAEjG;;;EAGE;AACF,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,OAAO,IAAI,CAAA;CACpB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACjE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,8BAAsB,OAAO,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,CAAC,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAChI,OAAgB,WAAW;;sBAAqB;IAChD,OAAgB,aAAa;;;;;sBAAuB;IACpD,OAAgB,YAAY;;;sBAAsB;IAElD,2EAA2E;IAC3E,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,OAAO,EAAE,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,OAAO,CAAA;IAE1E,IAAI,QAAQ,IACqC,MAAM,CACtD;IAED,IAAI,SAAS,6BAEZ;gBAEW,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB;IAcjD;;;MAGE;IACF,SAAS,CAAC,iBAAiB;IAQrB,MAAM,CAAC,OAAO,GAAE,GAAQ,GAAI,OAAO,CAAC,IAAI,CAAC;CASlD;AAED,qBAAa,gBAAiB,SAAQ,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACpD,KAAK,SAAa;IAClB,SAAS,EAAc,GAAG,CAAA;CACtC;AAED,eAAO,MAAM,QAAQ,kBAAyB,CAAA"}

package/dist/graft.d.ts

@@ -0,0 +1,29 @@
+import { Helper } from './helper.js';
+export type GraftScope = 'features' | 'clients' | 'servers' | 'commands' | 'endpoints' | 'selectors';
+/**
+ * Returns true when the candidate is a class (constructor function) whose
+ * prototype chain includes BaseClass. Handles cross-module-boundary cases
+ * by checking both reference equality and class name.
+ */
+export declare function isNativeHelperClass(candidate: unknown, BaseClass: typeof Helper | any): boolean;
+/**
+ * Synthesize a Helper subclass from plain module exports.
+ *
+ * Given a set of exports from a module file and a Helper base class, produces a
+ * fully-formed subclass ready for registration in the appropriate registry.
+ *
+ * Static export mappings:
+ *   description   → static description
+ *   stateSchema   → static stateSchema
+ *   optionsSchema → static optionsSchema  (also aliased from `args`)
+ *   eventsSchema  → static eventsSchema
+ *   envVars       → static envVars
+ *   argsSchema    → static argsSchema (Command scope; also aliased from `args`)
+ *   positionals   → static positionals (Command scope; stored for CLI dispatch mapping)
+ *   getters       → Object.defineProperty(proto, key, { get })  per key
+ *   run           → override run() for Command scope (receives named args + context)
+ *   handler       → legacy: wired through parseArgs() for backward compat
+ *   [fn exports]  → prototype methods (all other function-valued named exports)
+ */
+export declare function graftModule<T extends typeof Helper>(BaseClass: T, moduleExports: Record<string, any>, id: string, scope: GraftScope): T;
+//# sourceMappingURL=graft.d.ts.map

package/dist/graft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graft.d.ts","sourceRoot":"","sources":["../src/graft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAA;AAiBpG;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,MAAM,GAAG,GAAG,GAAG,OAAO,CAY/F;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,MAAM,EAClD,SAAS,EAAE,CAAC,EACZ,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,UAAU,GACf,CAAC,CAsGH"}