pupt-lib 1.3.0 → 1.3.2

package/dist/src/types/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/types/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAkEjE;;;;;;GAMG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ7D;AAYD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,2GAUhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA4BxE;AAMD;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;EAa1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAWhB,CAAC;AAEjB;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOnC,CAAC;AAMH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,GAAG,EAAE,kBAAkB,CAAC;IACxB,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,kBAgBjC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACtC,kBAAkB,CAUpB;AAgDD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAqCnD"}

package/dist/src/types/element.d.ts

@@ -0,0 +1,47 @@
+import { Component } from '../component';
+import { TYPE, PROPS, CHILDREN, DEFERRED_REF } from './symbols';
+/**
+ * PuptNode represents any valid child of a JSX element.
+ * Can be primitives, elements, or arrays of nodes.
+ */
+export type PuptNode = string | number | boolean | null | undefined | PuptElement | PuptNode[];
+/**
+ * PuptElement represents a JSX element in the pupt-lib tree.
+ * Uses symbols for internal properties to prevent collision with property access.
+ */
+export interface PuptElement<P = Record<string, unknown>> {
+    [TYPE]: string | symbol | ComponentType<P>;
+    [PROPS]: P;
+    [CHILDREN]: PuptNode[];
+}
+/**
+ * DeferredRef represents a reference to a property on a resolved element value.
+ * This is used when accessing properties like `{github.stars}` on elements.
+ */
+export interface DeferredRef {
+    [DEFERRED_REF]: true;
+    element: PuptElement;
+    path: (string | number)[];
+}
+/**
+ * ComponentType can be either a class component (extending Component)
+ * or a function component.
+ */
+export type ComponentType<P = Record<string, unknown>> = (new () => Component<P>) | ((props: P & {
+    children?: PuptNode;
+}) => PuptNode);
+/**
+ * Type guard to check if a value is a PuptElement.
+ *
+ * @param value - The value to check
+ * @returns true if the value is a PuptElement
+ */
+export declare function isPuptElement(value: unknown): value is PuptElement;
+/**
+ * Type guard to check if a value is a DeferredRef.
+ *
+ * @param value - The value to check
+ * @returns true if the value is a DeferredRef
+ */
+export declare function isDeferredRef(value: unknown): value is DeferredRef;
+//# sourceMappingURL=element.d.ts.map

package/dist/src/types/element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../../src/types/element.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,WAAW,GACX,QAAQ,EAAE,CAAC;AAEf;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACtD,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACX,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACjD,CAAC,UAAU,SAAS,CAAC,CAAC,CAAC,CAAC,GACxB,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,KAAK,QAAQ,CAAC,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE"}

package/dist/src/types/index.d.ts

@@ -0,0 +1,10 @@
+export { TYPE, PROPS, CHILDREN, DEFERRED_REF } from './symbols';
+export type { PuptNode, PuptElement, ComponentType, DeferredRef, } from './element';
+export { isPuptElement, isDeferredRef } from './element';
+export type { LlmConfig, LlmProvider, OutputConfig, CodeConfig, UserConfig, RuntimeConfig, PromptConfig, EnvironmentContext, RenderContext, } from './context';
+export { LLM_PROVIDERS, inferProviderFromModel, DEFAULT_ENVIRONMENT, createEnvironment, createRuntimeConfig, ensureRuntimeCacheReady, llmConfigSchema, outputConfigSchema, codeConfigSchema, userConfigSchema, runtimeConfigSchema, promptConfigSchema, environmentContextSchema, } from './context';
+export type { RenderOptions, RenderResult, RenderSuccess, RenderFailure, RenderError, PostExecutionAction, ReviewFileAction, OpenUrlAction, RunCommandAction, } from './render';
+export type { InputRequirement, ValidationResult, ValidationError, } from './input';
+export type { SearchablePrompt, SearchOptions, SearchResult, SearchResultMatch, SearchEngineConfig, } from './search';
+export type { PuptConfig, PuptLibrary, DiscoveredPrompt, LibraryLoadResult, PuptInitConfig, } from './module';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGhE,YAAY,EACV,QAAQ,EACR,WAAW,EACX,aAAa,EACb,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGzD,YAAY,EACV,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,aAAa,GACd,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EAEvB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,UAAU,CAAC"}

package/dist/src/types/input.d.ts

@@ -0,0 +1,51 @@
+import { ZodSchema } from 'zod';
+/**
+ * Describes a required input for a prompt
+ */
+export interface InputRequirement {
+    name: string;
+    label: string;
+    description: string;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'select' | 'multiselect' | 'date' | 'secret' | 'file' | 'path' | 'rating';
+    required: boolean;
+    default?: unknown;
+    schema?: ZodSchema;
+    min?: number;
+    max?: number;
+    options?: Array<{
+        value: string;
+        label: string;
+        text?: string;
+    }>;
+    language?: string;
+    extensions?: string[];
+    multiple?: boolean;
+    mustExist?: boolean;
+    mustBeDirectory?: boolean;
+    includeContents?: boolean;
+    includeTime?: boolean;
+    minDate?: string;
+    maxDate?: string;
+    masked?: boolean;
+    labels?: Record<number, string>;
+}
+/**
+ * Result of validating inputs against requirements
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: Array<{
+        field: string;
+        message: string;
+    }>;
+}
+/**
+ * Validation error details
+ */
+export interface ValidationError {
+    field: string;
+    message: string;
+    code: string;
+}
+//# sourceMappingURL=input.d.ts.map

package/dist/src/types/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/types/input.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IACvI,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IAGH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAG1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,MAAM,CAAC,EAAE,OAAO,CAAC;IAGjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/src/types/module.d.ts

@@ -0,0 +1,61 @@
+import { ComponentType } from './element';
+/**
+ * Configuration for a pupt library
+ */
+export interface PuptConfig {
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    license?: string;
+    prompts?: string[];
+    components?: string[];
+    dependencies?: Record<string, string>;
+}
+/**
+ * A loaded pupt library
+ */
+export interface PuptLibrary {
+    config: PuptConfig;
+    prompts: Map<string, DiscoveredPrompt>;
+    components: Map<string, ComponentType>;
+    path: string;
+}
+/**
+ * A discovered prompt from a library
+ */
+export interface DiscoveredPrompt {
+    name: string;
+    description: string;
+    path: string;
+    library: string;
+    tags: string[];
+    inputSchema?: Record<string, unknown>;
+    component: ComponentType;
+}
+/**
+ * Result of loading a library
+ */
+export interface LibraryLoadResult {
+    success: boolean;
+    library?: PuptLibrary;
+    errors?: string[];
+}
+/**
+ * Configuration for initializing the Pupt class
+ */
+export interface PuptInitConfig {
+    modules?: string[];
+    searchConfig?: {
+        threshold?: number;
+        weights?: {
+            name?: number;
+            description?: number;
+            tags?: number;
+            content?: number;
+        };
+        fuzzy?: boolean;
+        fuzziness?: number;
+    };
+}
+//# sourceMappingURL=module.d.ts.map

package/dist/src/types/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/types/module.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACvC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE;YACR,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;QACF,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH"}

package/dist/src/types/render.d.ts

@@ -0,0 +1,82 @@
+import { EnvironmentContext } from './context';
+/**
+ * Options for rendering a prompt
+ */
+export interface RenderOptions {
+    trim?: boolean;
+    inputs?: Map<string, unknown> | Record<string, unknown>;
+    env?: EnvironmentContext;
+}
+/**
+ * A validation or runtime error encountered during rendering
+ */
+export interface RenderError {
+    /** Component class name or registry name, e.g. "Section" */
+    component: string;
+    /** The specific prop that failed validation, or null for cross-field/runtime errors */
+    prop: string | null;
+    /** Human-readable error message */
+    message: string;
+    /** Error code (Zod issue code or 'runtime_error' / 'missing_schema') */
+    code: string;
+    /** Path within the props object */
+    path: (string | number)[];
+    /** The value that was received */
+    received?: unknown;
+    /** The expected type or constraint */
+    expected?: string;
+}
+/**
+ * Successful render result — no validation errors (may contain non-fatal warnings)
+ */
+export interface RenderSuccess {
+    ok: true;
+    text: string;
+    /** Non-fatal validation warnings (code: 'validation_warning') */
+    errors?: RenderError[];
+    postExecution: PostExecutionAction[];
+}
+/**
+ * Failed render result — contains validation errors and best-effort output
+ */
+export interface RenderFailure {
+    ok: false;
+    /** Best-effort rendered output (children rendered as fallback for invalid components) */
+    text: string;
+    errors: RenderError[];
+    postExecution: PostExecutionAction[];
+}
+/**
+ * Result of rendering a prompt — discriminated union on `ok`
+ */
+export type RenderResult = RenderSuccess | RenderFailure;
+/**
+ * Actions to be executed after the LLM response
+ */
+export type PostExecutionAction = ReviewFileAction | OpenUrlAction | RunCommandAction;
+/**
+ * Action to open a file for review in an editor
+ */
+export interface ReviewFileAction {
+    type: 'reviewFile';
+    file: string;
+    editor?: string;
+}
+/**
+ * Action to open a URL in a browser
+ */
+export interface OpenUrlAction {
+    type: 'openUrl';
+    url: string;
+    browser?: string;
+}
+/**
+ * Action to execute a shell command
+ */
+export interface RunCommandAction {
+    type: 'runCommand';
+    command: string;
+    cwd?: string;
+    env?: Record<string, string>;
+}
+//# sourceMappingURL=render.d.ts.map

package/dist/src/types/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/types/render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxD,GAAG,CAAC,EAAE,kBAAkB,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,aAAa,EAAE,mBAAmB,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,KAAK,CAAC;IACV,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,aAAa,EAAE,mBAAmB,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,aAAa,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,aAAa,GACb,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B"}

package/dist/src/types/search.d.ts

@@ -0,0 +1,59 @@
+/**
+ * A prompt that can be indexed and searched
+ */
+export interface SearchablePrompt {
+    name: string;
+    description?: string;
+    tags: string[];
+    library: string;
+    content?: string;
+}
+/**
+ * Options for searching prompts
+ */
+export interface SearchOptions {
+    query?: string;
+    tags?: string[];
+    library?: string;
+    limit?: number;
+    offset?: number;
+    fuzzy?: boolean;
+}
+/**
+ * A single search result with score
+ */
+export interface SearchResult {
+    prompt: SearchablePrompt;
+    score: number;
+    matches: SearchResultMatch[];
+}
+/**
+ * A match within a search result
+ */
+export interface SearchResultMatch {
+    field: string;
+    indices: number[];
+}
+/**
+ * Configuration for the search engine
+ */
+export interface SearchEngineConfig {
+    /** Minimum score threshold for results (default: 0.3) */
+    threshold?: number;
+    /** Field weights for scoring (default: name=3, tags=2, description=1.5, content=1) */
+    weights?: {
+        name?: number;
+        description?: number;
+        tags?: number;
+        content?: number;
+    };
+    /** Enable fuzzy matching for typo tolerance (default: true) */
+    fuzzy?: boolean;
+    /** Fuzzy tolerance level 0-1 (default: 0.2 = 20% typo tolerance) */
+    fuzziness?: number;
+    /** Enable prefix matching - "ref" matches "refactoring" (default: true) */
+    prefix?: boolean;
+    /** How to combine multiple search terms: 'AND' or 'OR' (default: 'AND') */
+    combineWith?: 'AND' | 'OR';
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/src/types/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/types/search.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAC5B"}

package/dist/src/types/symbols.d.ts

@@ -0,0 +1,9 @@
+/** Symbol for element type */
+export declare const TYPE: unique symbol;
+/** Symbol for element props */
+export declare const PROPS: unique symbol;
+/** Symbol for element children */
+export declare const CHILDREN: unique symbol;
+/** Marker for identifying deferred references (used in future phases) */
+export declare const DEFERRED_REF: unique symbol;
+//# sourceMappingURL=symbols.d.ts.map

package/dist/src/types/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../src/types/symbols.ts"],"names":[],"mappings":"AAEA,8BAA8B;AAC9B,eAAO,MAAM,IAAI,eAA0B,CAAC;AAE5C,+BAA+B;AAC/B,eAAO,MAAM,KAAK,eAA2B,CAAC;AAE9C,kCAAkC;AAClC,eAAO,MAAM,QAAQ,eAA8B,CAAC;AAEpD,yEAAyE;AACzE,eAAO,MAAM,YAAY,eAAiC,CAAC"}

package/dist/src/utils/children.d.ts

@@ -0,0 +1,29 @@
+import { PuptNode, PuptElement, ComponentType } from '../types';
+/**
+ * Check if a PuptElement matches a given type (class reference or string name).
+ *
+ * @param element - The element to check
+ * @param type - A component class/function reference, or a string name
+ * @returns true if the element matches the given type
+ */
+export declare function isElementOfType(element: PuptElement, type: ComponentType | string): boolean;
+/**
+ * Find all children that match a given type.
+ * Searches through Fragments transparently.
+ *
+ * @param children - The children to search (PuptNode - can be array, element, string, etc.)
+ * @param type - A component class/function reference, or a string name
+ * @returns Array of matching PuptElements
+ */
+export declare function findChildrenOfType(children: PuptNode, type: ComponentType | string): PuptElement[];
+/**
+ * Partition children into two groups: those matching the type and the rest.
+ * Unlike findChildrenOfType, this does not unwrap Fragments - it operates
+ * on the direct children array.
+ *
+ * @param children - Array of children to partition
+ * @param type - A component class/function reference, or a string name
+ * @returns Tuple of [matching elements, non-matching nodes]
+ */
+export declare function partitionChildren(children: PuptNode[], type: ComponentType | string): [PuptElement[], PuptNode[]];
+//# sourceMappingURL=children.d.ts.map

package/dist/src/utils/children.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"children.d.ts","sourceRoot":"","sources":["../../../src/utils/children.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKrE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,aAAa,GAAG,MAAM,GAC3B,OAAO,CAaT;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,aAAa,GAAG,MAAM,GAC3B,WAAW,EAAE,CAIf;AA2CD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,EAAE,EACpB,IAAI,EAAE,aAAa,GAAG,MAAM,GAC3B,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,CAa7B"}

package/dist/src/utils/delimiter.d.ts

@@ -0,0 +1,13 @@
+import { PuptNode } from '../types';
+/**
+ * Wrap content with a delimiter (XML tags, markdown header, or none).
+ * This is the shared utility that replaces the duplicated switch(delimiter)
+ * logic across structural components.
+ *
+ * @param content - The content to wrap (string or array of PuptNode)
+ * @param tag - The tag/heading name to use
+ * @param delimiter - The delimiter style: 'xml', 'markdown', or 'none'
+ * @returns The wrapped content as a PuptNode
+ */
+export declare function wrapWithDelimiter(content: PuptNode, tag: string, delimiter: 'xml' | 'markdown' | 'none'): PuptNode;
+//# sourceMappingURL=delimiter.d.ts.map

package/dist/src/utils/delimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delimiter.d.ts","sourceRoot":"","sources":["../../../src/utils/delimiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,QAAQ,EACjB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,KAAK,GAAG,UAAU,GAAG,MAAM,GACrC,QAAQ,CASV"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pupt-lib",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "TypeScript library for creating AI prompts using JSX syntax",
   "license": "MIT",
   "author": "",
@@ -36,15 +36,15 @@
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
+      "types": "./dist/src/index.d.ts",
       "import": "./dist/index.js"
     },
     "./jsx-runtime": {
-      "types": "./dist/jsx-runtime/index.d.ts",
+      "types": "./dist/src/jsx-runtime/index.d.ts",
       "import": "./dist/jsx-runtime/index.js"
     },
     "./jsx-dev-runtime": {
-      "types": "./dist/jsx-runtime/jsx-dev-runtime.d.ts",
+      "types": "./dist/src/jsx-runtime/jsx-dev-runtime.d.ts",
       "import": "./dist/jsx-runtime/jsx-dev-runtime.js"
     }
   },