@homedev/objector 1.2.61 → 1.2.62

package/dist/index.d.ts

@@ -0,0 +1,750 @@
+export declare const AsyncFunction: any;
+
+/**
+ * Maps an array asynchronously using Promise.all for parallel execution
+ * @typeParam T - Type of input array items
+ * @typeParam U - Type of async result items
+ * @param arr - Array to map
+ * @param fn - Async mapping function
+ * @returns Promise of mapped array
+ * @public
+ */
+export declare const asyncMap: <T, U>(arr: T[], fn: (item: T, index: number, array: T[]) => Promise<U>) => Promise<U[]>;
+
+/**
+ * Converts a string to camelCase (lowerCamelCase).
+ * Handles spaces, underscores, and hyphens as word separators.
+ *
+ * @example
+ * camel('hello_world') // 'helloWorld'
+ * camel('hello world') // 'helloWorld'
+ * camel('HelloWorld') // 'helloWorld'
+ *
+ * @param v - The string to convert
+ * @returns The string in camelCase
+ */
+export declare const camel: (v: string) => string;
+
+/**
+ * Converts a string to Capital Case (each word capitalized, spaces preserved).
+ * Only capitalizes words following spaces.
+ *
+ * @example
+ * capital('hello world') // 'Hello World'
+ * capital('hello_world') // 'hello_World'
+ *
+ * @param v - The string to convert
+ * @returns The string with each space-separated word capitalized
+ */
+export declare const capital: (v: string) => string;
+
+/**
+ * Changes the case of a string to uppercase, lowercase, or returns unchanged.
+ *
+ * @example
+ * changeCase('Hello', 'upper') // 'HELLO'
+ * changeCase('Hello', 'lower') // 'hello'
+ * changeCase('Hello') // 'Hello'
+ *
+ * @param v - The string to transform
+ * @param arg - The case type: 'upper', 'lower', or undefined to return unchanged
+ * @returns The transformed string
+ */
+export declare const changeCase: (v: string, arg?: string) => string;
+
+/**
+ * @public
+ */
+export declare const conditionPredicates: Record<string, (...args: any[]) => boolean>;
+
+export declare const decoder: (options?: DecoderOptions) => (_: any, ctx: ClassMethodDecoratorContext<ObjectorPlugin, (data: string) => unknown>) => void;
+
+declare type DecoderOptions = ObjectorDecoratorOptions;
+
+/**
+ * Deep clones an object using structuredClone (faster) with JSON fallback
+ * - Uses structuredClone for better performance and broader type support (Date, RegExp, etc.)
+ * - Falls back to JSON serialization if structuredClone fails or is unavailable
+ * - Note: Functions, symbols, and undefined values are lost in JSON fallback
+ * @typeParam T - Type of object to clone
+ * @param model - Object to clone
+ * @returns Deep clone of the object
+ * @public
+ */
+export declare const deepClone: <T>(model: T) => T;
+
+/**
+ * Asserts that a value is defined, throwing an error if undefined
+ * @typeParam T - Type of the value
+ * @param value - Value to check
+ * @param msg - Error message to throw if value is undefined or null
+ * @returns The value if defined
+ * @throws Error if value is undefined
+ * @public
+ */
+export declare const defined: <T>(value: T | undefined | null, msg?: string) => T;
+
+declare interface Encoder {
+    fn: (data: unknown, ...args: any[]) => string | Promise<string>;
+    options?: EncoderOptions;
+}
+
+export declare const encoder: (options?: EncoderOptions_2) => (_: any, ctx: ClassMethodDecoratorContext<ObjectorPlugin, (data: unknown) => string | Promise<string>>) => void;
+
+declare interface EncoderOptions {
+    includeTags?: boolean;
+}
+
+declare type EncoderOptions_2 = ObjectorDecoratorOptions;
+
+export declare const exists: (fileName: string) => Promise<boolean>;
+
+export declare interface FieldContext {
+    path: string;
+    root: any;
+    options: ProcessFieldsOptions;
+    value: string | object | number | NavigateResult | null;
+    key: string;
+    args: any[];
+    rawArgs: {
+        value: string;
+        quoted: boolean;
+    }[];
+    tags: Record<string, string[]>;
+    parent?: any;
+}
+
+export declare interface FieldProcessor {
+    fn: FieldProcessorFunc;
+    options: FieldProcessorOptions;
+}
+
+export declare type FieldProcessorFunc = (context: FieldContext) => any;
+
+export declare type FieldProcessorMap = Record<string, FieldProcessorTypedFunc>;
+
+export declare interface FieldProcessorOptions {
+    filters?: RegExp[];
+    processArgs?: boolean;
+    types?: Record<number, string | any[] | ((value: string, root: any, index: number, quoted: boolean) => any)> | FieldProcessorTypeChecker;
+}
+
+export declare interface FieldProcessorSection {
+    config: Record<string, any>;
+    content: string;
+    trim?: boolean;
+    indent?: number;
+    show?: boolean;
+}
+
+export declare type FieldProcessorSectionConfigFunc = (context: FieldProcessorSectionContext) => Promise<boolean | void> | boolean | void;
+
+export declare interface FieldProcessorSectionContext {
+    section: FieldProcessorSection;
+    content: string;
+    path: string;
+    root: Record<string, any>;
+    options: ProcessFieldsOptions;
+}
+
+export declare type FieldProcessorSectionFunc = (context: FieldProcessorSectionContext) => Promise<void | boolean | string> | void | boolean | string;
+
+export declare type FieldProcessorSectionMap = Record<string, FieldProcessorSectionFunc>;
+
+export declare type FieldProcessorTypeChecker = (n: number, value: any, args: any[]) => any;
+
+export declare type FieldProcessorTypeCheckers<T = unknown> = Record<keyof T, FieldProcessorTypeChecker>;
+
+export declare type FieldProcessorTypedFunc = FieldProcessorFunc | (FieldProcessorOptions & {
+    fn: FieldProcessorFunc;
+});
+
+declare interface FilePatternOptions {
+    cwd: string;
+    filter?: (fileName: string, index: number, array: string[]) => boolean;
+    map: (fileName: string, index: number, array: string[]) => Promise<any>;
+}
+
+/**
+ * Finds values in an object tree that match a predicate function.
+ *
+ * @public
+ * @param from - The object to search through
+ * @param cb - Predicate function that receives the path and value, returns true for matches
+ * @returns Array of matching values
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: { b: 1 }, c: { d: 2 } }
+ * const results = await find(obj, (path, value) => value === 2)
+ * // results: [2]
+ * ```
+ */
+export declare const find: (from: any, cb: (path: string, value: any) => boolean) => Promise<any[]>;
+
+export declare const globMap: <T>(pattern: string | string[], options: FilePatternOptions) => Promise<T[] | T>;
+
+/**
+ * @public
+ */
+export declare const importGlob: (patterns: string[], options?: ImportOptions) => Promise<any[]>;
+
+/**
+ * @public
+ */
+export declare const importList: (modules: string[], options?: ImportOptions) => Promise<any[]>;
+
+/**
+ * @public
+ */
+export declare interface ImportOptions {
+    cwd?: string;
+    resolveDefault?: boolean | 'only';
+    filter?: (name: string) => boolean | undefined;
+    fail?: (name: string, error: any) => boolean | undefined;
+    map?: (module: any, name: string) => any;
+}
+
+export declare const key: (options?: KeyOptions) => (_: any, ctx: ClassMethodDecoratorContext<ObjectorPlugin, (value: any) => any>) => void;
+
+declare type KeyOptions = ObjectorDecoratorOptions;
+
+/**
+ * @public
+ */
+export declare interface LoadContext {
+    included: string[];
+    document: unknown;
+}
+
+/**
+ * @public
+ * @param fileName
+ * @param options
+ * @returns
+ */
+export declare const loadFormat: <T = any>(fileName: string, options?: LoadOptions) => Promise<LoadResult<T>>;
+
+/**
+ * @public
+ */
+export declare interface LoadFormatParser {
+    matching?: string[];
+    fn: (data: string) => any;
+}
+
+/**
+ * @public
+ */
+export declare interface LoadObjectOptions {
+    fileName: string;
+    fullPath: string;
+    folderPath: string;
+}
+
+/**
+ * @public
+ */
+export declare interface LoadOptions {
+    dirs?: string[];
+    parsers?: Record<string, LoadFormatParser>;
+    format?: string;
+}
+
+export declare interface LoadResult<T> {
+    fullPath: string;
+    folderPath: string;
+    content: T;
+}
+
+export declare const locate: (fileName: string, dirs?: string[]) => Promise<string>;
+
+export declare type LogFunction = (className: string, ...args: any[]) => void;
+
+export declare class Logger {
+    options: LoggerOptions;
+    constructor(options?: Partial<LoggerOptions>);
+    write(className: string, ...args: any[]): void;
+    info(...args: any[]): void;
+    error(...args: any[]): void;
+    warn(...args: any[]): void;
+    debug(...args: any[]): void;
+    verbose(...args: any[]): void;
+}
+
+export declare interface LoggerOptions {
+    level: string;
+    showClass: boolean;
+    levels: string[];
+    timeStamp: boolean;
+    timeLocale?: string;
+    timeOptions?: Intl.DateTimeFormatOptions;
+    logFunction: LogFunction;
+}
+
+export declare const macro: (options?: MacroOptions) => (_: any, ctx: ClassMethodDecoratorContext<ObjectorPlugin, (...args: any[]) => any>) => void;
+
+declare type MacroOptions = ObjectorDecoratorOptions;
+
+export declare const makeFieldProcessor: (fn: SourceFunc, types?: FieldProcessorTypeChecker) => FieldProcessorTypedFunc;
+
+export declare const makeFieldProcessorList: <T = unknown>(source: SourceFunc[], options?: {
+    types?: FieldProcessorTypeCheckers<T>;
+}) => FieldProcessorMap;
+
+export declare const makeFieldProcessorMap: <T = unknown>(source: Record<keyof T, SourceFunc>, options?: {
+    types?: FieldProcessorTypeCheckers<T>;
+    keys?: (keyof T)[];
+}) => FieldProcessorMap;
+
+/**
+ * @public
+ * @param source
+ * @param target
+ * @param options
+ */
+export declare const merge: (source: any, target: any, options?: MergeOptions) => void;
+
+/**
+ * @public
+ * @param elements
+ * @param options
+ */
+export declare const mergeAll: (elements: any[], options?: MergeOptions) => any;
+
+/**
+ * @public
+ */
+export declare type MergeMode = 'merge' | 'source' | 'target' | 'skip';
+
+/**
+ * @public
+ */
+export declare interface MergeOptions {
+    conflict?: (key: string, source: any, target: any, sourceContainer: any, targetContainer: any) => any;
+    mismatch?: (key: string, source: any, target: any, sourceContainer: any, targetContainer: any) => any;
+    navigate?: (key: string, source: any, target: any, sourceContainer: any, targetContainer: any) => boolean | undefined;
+    mode?: (key: string, source: any, target: any, sourceContainer: any, targetContainer: any) => MergeMode | void;
+}
+
+/**
+ * Recursively navigates through an object tree, invoking a callback for each property.
+ * Supports various actions like replacing, deleting, or merging values during traversal.
+ * Includes circular reference detection to prevent infinite loops.
+ *
+ * Performance optimizations:
+ * - Caches static NavigateResult instances
+ * - Uses WeakSet for O(1) circular reference detection
+ * - Avoids Object.entries() to prevent array allocations
+ * - Optimizes switch statement order for common cases
+ *
+ * @public
+ * @param o - The object to navigate
+ * @param cb - Callback function invoked for each property
+ * @throws {Error} When attempting to replace the root object
+ */
+export declare const navigate: (o: any, cb: NavigateCallback) => Promise<void>;
+
+/**
+ * @public
+ */
+export declare enum NavigateAction {
+    Explore = 0,
+    SkipSiblings = 1,
+    NoExplore = 2,
+    ReplaceParent = 3,
+    DeleteParent = 4,
+    MergeParent = 5,
+    ReplaceItem = 6,
+    DeleteItem = 7
+}
+
+/**
+ * @public
+ */
+export declare type NavigateCallback = (context: NavigateContext) => Promise<NavigateResult> | NavigateResult;
+
+/**
+ * @public
+ */
+export declare interface NavigateContext {
+    key: string;
+    value: any;
+    path: string[];
+    parent: any;
+    parents: any[];
+}
+
+/**
+ * @public
+ */
+export declare class NavigateResult {
+    readonly action: NavigateAction;
+    by?: any | undefined;
+    skipSiblings?: boolean | undefined;
+    reexplore?: boolean | undefined;
+    constructor(action: NavigateAction, by?: any | undefined, skipSiblings?: boolean | undefined, reexplore?: boolean | undefined);
+    private static readonly _explore;
+    private static readonly _noExplore;
+    private static readonly _skipSiblings;
+    private static readonly _deleteParent;
+    static ReplaceParent(by: any, reexplore?: boolean): NavigateResult;
+    static SkipSiblings(): NavigateResult;
+    static Explore(): NavigateResult;
+    static NoExplore(): NavigateResult;
+    static DeleteParent(): NavigateResult;
+    static MergeParent(by: any): NavigateResult;
+    static ReplaceItem(by: any, skipSiblings?: boolean): NavigateResult;
+    static DeleteItem(skipSiblings?: boolean): NavigateResult;
+}
+
+/**
+ * Maps an array while filtering out null/undefined values (performance optimized)
+ * Combines filter and map operations to avoid double iteration
+ * @typeParam T - Type of input array items
+ * @typeParam U - Type of mapped result items
+ * @param arr - Array to map (can be undefined)
+ * @param fn - Mapping function
+ * @returns Mapped array with nulls/undefined filtered out, or empty array if input is undefined
+ * @public
+ */
+export declare const nonNullMap: <T, U>(arr: T[] | undefined, fn: (item: T, index: number, array: T[]) => U) => U[];
+
+/**
+ * @public
+ */
+export declare class Objector {
+    private includeManager;
+    private includeProcessor;
+    private cacheManager;
+    private outputs;
+    private vars;
+    private funcs;
+    private fields;
+    private objectMetadata;
+    private currentContext;
+    private storedSections;
+    private dataEncoders;
+    private dataDecoders;
+    constructor();
+    use(handler: ObjectorPluginConstructor | ObjectorPluginFunction): this;
+    includeDirectory(...dirs: string[]): this;
+    getIncludeDirectories(): string[];
+    include(...files: string[]): this;
+    keys(keys: FieldProcessorMap): this;
+    sources(sources: FieldProcessorMap): this;
+    sections(sections: Record<string, FieldProcessorSectionFunc>): this;
+    variables(vars: Record<string, unknown>): this;
+    functions(funcs: Record<string, typeof AsyncFunction>): this;
+    getFunctions(): Record<string, typeof AsyncFunction>;
+    getOutputs(): Output[];
+    output(o: Output): this;
+    metadata(path: string, o: unknown): this;
+    getMetadata(path: string): unknown;
+    getAllMetadata(): Record<string, unknown>;
+    setCacheMaxSize(size: number): this;
+    clearCache(): this;
+    getCurrentContext(): LoadContext | null;
+    fieldOptions(options: ProcessFieldsOptions): this;
+    section(section: FieldProcessorSection): this;
+    getSection(name: string): FieldProcessorSection | undefined;
+    encoders(encoders: Record<string, Encoder>): this;
+    decoders(decoders: Record<string, LoadFormatParser>): this;
+    getEncoder(name: string): Encoder | undefined;
+    getDecoder(name: string): LoadFormatParser | undefined;
+    filter(f: RegExp): this;
+    loadObject<T = any>(data: T, container?: any, options?: LoadObjectOptions): Promise<T>;
+    load<T = unknown>(fileName: string, cwd?: string, container?: unknown, noProcess?: boolean, ld?: LoadContext): Promise<T | null>;
+    writeAll(option?: WriteOutputsOption): Promise<void>;
+}
+
+declare interface ObjectorDecoratorOptions {
+    name?: string;
+}
+
+export declare class ObjectorPlugin {
+    protected readonly o: Objector;
+    protected readonly context: {
+        path: string;
+        root: any;
+        options: ProcessFieldsOptions;
+        value?: string | object | number | null;
+        key?: string;
+        args?: any[];
+        rawArgs?: {
+            value: string;
+            quoted: boolean;
+        }[];
+        tags?: Record<string, string[]>;
+        parent?: any;
+        config?: Record<string, any>;
+    };
+    constructor(o: Objector);
+}
+
+export declare type ObjectorPluginConstructor = new (o: Objector, ...args: any[]) => ObjectorPlugin;
+
+declare type ObjectorPluginFunction = (o: Objector) => void;
+
+export declare interface Output {
+    name: string;
+    type?: 'json' | 'yaml' | 'text';
+    value: any;
+    class?: string;
+}
+
+/**
+ * Adds indentation to each line of a string.
+ * Useful for formatting multi-line text with consistent indentation.
+ *
+ * @example
+ * padBlock('hello\\nworld', 2) // '  hello\\n  world'
+ * padBlock('a|b|c', 1, '|', '-') // '-a|-b|-c'
+ *
+ * @param str - The string to indent
+ * @param indent - The number of padding units to add
+ * @param separator - The separator between lines (default: '\\n')
+ * @param padder - The character to repeat for padding (default: ' ')
+ * @returns The indented string
+ */
+export declare const padBlock: (str: string, indent: number, separator?: string, padder?: string) => string;
+
+/**
+ * Converts a string to PascalCase (UpperCamelCase).
+ * Handles spaces, underscores, and hyphens as word separators.
+ *
+ * @example
+ * pascal('hello_world') // 'HelloWorld'
+ * pascal('hello world') // 'HelloWorld'
+ * pascal('helloWorld') // 'HelloWorld'
+ *
+ * @param v - The string to convert
+ * @returns The string in PascalCase
+ */
+export declare const pascal: (v: string) => string;
+
+/**
+ * @public
+ * @param obj
+ * @param options
+ * @returns
+ */
+export declare const processFields: (obj: any, options?: ProcessFieldsOptions) => Promise<any>;
+
+export declare interface ProcessFieldsOptions {
+    sources?: FieldProcessorMap;
+    keys?: FieldProcessorMap;
+    sections?: FieldProcessorSectionMap;
+    filters?: RegExp[];
+    root?: Record<any, any>;
+    globalContext?: any;
+    onSection?: FieldProcessorSectionFunc;
+    onSectionConfig?: FieldProcessorSectionConfigFunc;
+    configParser?: (configText: string) => any;
+}
+
+export declare const section: (options?: SectionOptions) => (_: any, ctx: ClassMethodDecoratorContext<ObjectorPlugin, (section: FieldProcessorSection) => any>) => void;
+
+declare type SectionOptions = ObjectorDecoratorOptions;
+
+/**
+ * Selects a value from a nested object using a path string with advanced querying capabilities
+ *
+ * Supports:
+ * - Dot notation: 'user.profile.name'
+ * - Array indexing: 'users.0' or 'users[0]'
+ * - Array filtering: 'users.[name=John].age'
+ * - References: 'users.\{activeUserId\}.name'
+ * - Optional paths: 'user.profile?.bio'
+ * - Default values: 'config.timeout?=5000'
+ *
+ * @public
+ * @param from - The root object to select from
+ * @param path - The path string to navigate
+ * @param options - Optional configuration
+ * @returns The selected value or undefined
+ *
+ * @example
+ * ```typescript
+ * const obj = { user: { name: 'Alice', age: 30 } }
+ * select(obj, 'user.name') // 'Alice'
+ * select(obj, 'user.email', { defaultValue: 'N/A' }) // 'N/A'
+ * ```
+ */
+export declare const select: <T = any>(from: any, path: string, options?: SelectOptions) => T | undefined;
+
+/**
+ * Options for configuring the select function behavior
+ * @public
+ */
+export declare interface SelectOptions {
+    /** Value to set at the selected path */
+    set?: any;
+    /** Alternative key to use (currently unused) */
+    key?: string;
+    /** Path separator character (default: '.') */
+    separator?: string;
+    /** Default value to return when path is not found */
+    defaultValue?: any;
+    /** If true, returns undefined instead of throwing on missing paths */
+    optional?: boolean;
+}
+
+export declare const sharedFunction: (options?: SharedFunctionOptions) => (_: any, ctx: ClassMethodDecoratorContext<ObjectorPlugin, (...args: any[]) => any>) => void;
+
+declare type SharedFunctionOptions = ObjectorDecoratorOptions;
+
+/**
+ * Converts a string to snake_case or custom_case.
+ * Inserts the separator between lowercase and uppercase characters.
+ *
+ * @example
+ * snake('helloWorld', '_') // 'hello_world'
+ * snake('HelloWorld', '-') // 'hello-world'
+ * snake('hello world', '_') // 'hello_world'
+ *
+ * @param v - The string to convert
+ * @param separator - The separator to use between words (default: '_')
+ * @returns The string in snake case with the specified separator
+ */
+export declare const snake: (v: string, separator?: string) => string;
+
+/**
+ * Sorts an array by a selector function with custom comparison
+ * Uses a shallow copy to avoid mutating the original array
+ * @typeParam T - Type of array items
+ * @typeParam U - Type of comparison values
+ * @param arr - Array to sort
+ * @param selector - Function to extract comparison value from item
+ * @param compare - Comparison function (default: numeric comparison)
+ * @returns New sorted array
+ * @public
+ */
+export declare const sortBy: <T, U>(arr: T[], selector: (item: T) => U, compare?: (a: U, b: U) => number) => T[];
+
+declare type SourceFunc = (...args: any[]) => any;
+
+export declare const splitNested: (str: string, separator: string, open?: string, close?: string) => string[];
+
+/**
+ * Splits a string by a separator while respecting quoted values.
+ * Quoted values can contain the separator without being split.
+ * Supports both single (') and double (") quotes.
+ *
+ * @param input - The string to split
+ * @param separator - Single or multi-character separator (default: ',')
+ * @returns Array of objects with value and quoted status
+ *
+ * @example
+ * splitWithQuotes('hello, "world", test')
+ * // Returns: [
+ * //   { value: 'hello', quoted: false },
+ * //   { value: 'world', quoted: true },
+ * //   { value: 'test', quoted: false }
+ * // ]
+ *
+ * @example
+ * splitWithQuotes('a:: "b:: c":: d', '::')
+ * // Returns: [
+ * //   { value: 'a', quoted: false },
+ * //   { value: 'b:: c', quoted: true },
+ * //   { value: 'd', quoted: false }
+ * // ]
+ */
+export declare const splitWithQuotes: (input: string, separator?: string) => {
+    value: string;
+    quoted: boolean;
+}[];
+
+export declare const stripIndent: (value: string) => string;
+
+/**
+ * Replaces tokens in a string with values from an object.
+ * Tokens are in the format `$\{key\}`.
+ *
+ * @example
+ * tokenize('Hello $\{name\}', { name: 'World' }) // 'Hello World'
+ * tokenize('$\{greeting\} $\{name\}!', { greeting: 'Hi', name: 'Alice' }) // 'Hi Alice!'
+ * tokenize('$\{missing\}', {}) // ''
+ *
+ * @param str - The string containing tokens
+ * @param from - An object with key-value pairs for token replacement
+ * @param tokenizer - The regex pattern for token matching (default: `/\$\{([^}]+)\}/g`)
+ * @returns The string with tokens replaced by values from the object
+ */
+export declare const tokenize: (str: string, from: Record<string, unknown>, tokenizer?: RegExp) => string;
+
+/**
+ * Converts an object's entries into an array of objects with a key property
+ * @typeParam T - The type of items in the resulting array
+ * @param from - Object to convert
+ * @param key - Property name to use for keys (default: 'name')
+ * @returns Array of objects with key properties
+ * @example
+ * toList({ a: { value: 1 }, b: { value: 2 } }) // [{ name: 'a', value: 1 }, { name: 'b', value: 2 }]
+ * @public
+ */
+export declare const toList: <T>(from: Record<string, unknown>, key?: string) => T[];
+
+/**
+ * Converts an array into an object indexed by a key property, excluding the key from items
+ * @typeParam T - The type of the resulting object values
+ * @param from - Array to convert
+ * @param key - Property name to use as key (default: 'name')
+ * @returns Object indexed by key values, without the key property in values
+ * @example
+ * toObject([{ name: 'a', value: 1 }]) // { a: { value: 1 } }
+ * @public
+ */
+export declare const toObject: <T extends Record<string, unknown>>(from: T[], key?: string) => Record<string, Omit<T, typeof key>>;
+
+/**
+ * Converts an array into an object indexed by a key property, keeping the full items
+ * @typeParam T - The type of the resulting object
+ * @param from - Array to convert
+ * @param key - Property name to use as key (default: 'name')
+ * @returns Object indexed by key values
+ * @example
+ * toObjectWithKey([{ name: 'a', value: 1 }]) // { a: { name: 'a', value: 1 } }
+ * @public
+ */
+export declare const toObjectWithKey: <T extends Record<string, unknown>>(from: T[], key?: string) => Record<string, T>;
+
+export declare const variable: (options?: VariableOptions) => (_: any, ctx: ClassFieldDecoratorContext<ObjectorPlugin, any>) => void;
+
+declare type VariableOptions = ObjectorDecoratorOptions;
+
+export declare const writeFormat: (filePath: string, content: any, options?: WriteFormatOptions) => Promise<void>;
+
+/**
+ * @public
+ */
+export declare interface WriteFormatEncoder {
+    matching?: string[];
+    fn: (data: any) => Promise<string> | string;
+}
+
+/**
+ * @public
+ */
+export declare interface WriteFormatOptions {
+    format: string;
+    encoders?: Record<string, WriteFormatEncoder>;
+}
+
+export declare const writeOutput: (o: Output, options?: WriteOutputOption) => Promise<void>;
+
+export declare interface WriteOutputOption {
+    targetDirectory?: string;
+    writing?: (output: Output) => boolean | undefined | void;
+    classes?: string[];
+    classRequired?: boolean;
+}
+
+export declare const writeOutputs: (outputs: Output[], options?: WriteOutputsOption) => Promise<void>;
+
+export declare interface WriteOutputsOption extends WriteOutputOption {
+    removeFirst?: boolean;
+}
+
+export { }

package/dist/index.js

@@ -1,4 +1,4 @@
-var Ar=Object.create;var{getPrototypeOf:ro,defineProperty:Q,getOwnPropertyNames:Er,getOwnPropertyDescriptor:to}=Object,Qe=Object.prototype.hasOwnProperty;function Xe(e){return this[e]}var R=(e,r,t)=>{var n=Er(r);for(let o of n)if(!Qe.call(e,o)&&o!=="default")Q(e,o,{get:Xe.bind(r,o),enumerable:!0});if(t){for(let o of n)if(!Qe.call(t,o)&&o!=="default")Q(t,o,{get:Xe.bind(r,o),enumerable:!0});return t}},no,oo,io=(e,r,t)=>{var n=e!=null&&typeof e==="object";if(n){var o=r?no??=new WeakMap:oo??=new WeakMap,i=o.get(e);if(i)return i}t=e!=null?Ar(ro(e)):{};let l=r||!e||!e.__esModule?Q(t,"default",{value:e,enumerable:!0}):t;for(let a of Er(e))if(!Qe.call(l,a))Q(l,a,{get:Xe.bind(e,a),enumerable:!0});if(n)o.set(e,l);return l};var so=(e,r)=>()=>(r||e((r={exports:{}}).exports,r),r.exports),br=(e,r)=>{return Object.defineProperty(e,"name",{value:r,enumerable:!1,configurable:!0}),e},ao=(e)=>e;function lo(e,r){this[e]=ao.bind(null,r)}var W=(e,r)=>{for(var t in r)Q(e,t,{get:r[t],enumerable:!0,configurable:!0,set:lo.bind(r,t)})};var Mr=(e,r)=>(r=Symbol[e])?r:Symbol.for("Symbol."+e),ae=(e)=>{throw TypeError(e)},uo=(e,r,t)=>(r in e)?Q(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t;var Ve=(e,r,t)=>r.has(e)||ae("Cannot "+t),po=(e,r)=>Object(r)!==r?ae('Cannot use the "in" operator on this value'):e.has(r),Or=(e,r,t)=>(Ve(e,r,"read from private field"),t?t.call(e):r.get(e));var vr=(e,r,t,n)=>(Ve(e,r,"write to private field"),n?n.call(e,t):r.set(e,t),t),fo=(e,r,t)=>(Ve(e,r,"access private method"),t),Sr=(e)=>[,,,Ar(e?.[Mr("metadata")]??null)],jr=["class","method","getter","setter","accessor","field","value","get","set"],se=(e)=>e!==void 0&&typeof e!=="function"?ae("Function expected"):e,co=(e,r,t,n,o)=>({kind:jr[e],name:r,metadata:n,addInitializer:(i)=>t._?ae("Already initialized"):o.push(se(i||null))}),Ze=(e,r)=>uo(r,Mr("metadata"),e[3]),kr=(e,r,t,n)=>{for(var o=0,i=e[r>>1],l=i&&i.length;o<l;o++)r&1?i[o].call(t):n=i[o].call(t,n);return n},m=(e,r,t,n,o,i)=>{var l,a,p,h,O,y=r&7,u=!!(r&8),d=!!(r&16),A=y>3?e.length+1:y?u?1:2:0,g=jr[y+5],v=y>3&&(e[A-1]=[]),f=e[A]||(e[A]=[]),j=y&&(!d&&!u&&(o=o.prototype),y<5&&(y>3||!d)&&to(y<4?o:{get[t](){return Or(this,i)},set[t](S){vr(this,i,S)}},t));y?d&&y<4&&br(i,(y>2?"set ":y>1?"get ":"")+t):br(o,t);for(var b=n.length-1;b>=0;b--){if(h=co(y,t,p={},e[3],f),y){if(h.static=u,h.private=d,O=h.access={has:d?(S)=>po(o,S):(S)=>(t in S)},y^3)O.get=d?(S)=>(y^1?Or:fo)(S,o,y^4?i:j.get):(S)=>S[t];if(y>2)O.set=d?(S,k)=>vr(S,o,k,y^4?i:j.set):(S,k)=>S[t]=k}if(a=(0,n[b])(y?y<4?d?i:j[g]:y>4?void 0:{get:j.get,set:j.set}:o,h),p._=1,y^4||a===void 0)se(a)&&(y>4?v.unshift(a):y?d?i=a:j[g]=a:o=a);else if(typeof a!=="object"||a===null)ae("Object expected");else se(l=a.get)&&(j.get=l),se(l=a.set)&&(j.set=l),se(l=a.init)&&v.unshift(l)}return y||Ze(e,o),j&&Q(o,t,j),d?y^4?i:j:o};var Rt=so((pl,Ft)=>{var{defineProperty:hr,getOwnPropertyNames:ci,getOwnPropertyDescriptor:mi}=Object,gi=Object.prototype.hasOwnProperty,kt=new WeakMap,yi=(e)=>{var r=kt.get(e),t;if(r)return r;if(r=hr({},"__esModule",{value:!0}),e&&typeof e==="object"||typeof e==="function")ci(e).map((n)=>!gi.call(r,n)&&hr(r,n,{get:()=>e[n],enumerable:!(t=mi(e,n))||t.enumerable}));return kt.set(e,r),r},di=(e,r)=>{for(var t in r)hr(e,t,{get:r[t],enumerable:!0,configurable:!0,set:(n)=>r[t]=()=>n})},Dt={};di(Dt,{splitWithQuotes:()=>hi,splitNested:()=>wi});Ft.exports=yi(Dt);var wi=(e,r,t="(",n=")")=>{let o=0,i="",l=[];for(let a of e){if(i+=a,a===t)o++;if(a===n)o--;if(o===0&&a===r)l.push(i.slice(0,-1)),i=""}if(i)l.push(i);return l},hi=(e,r=",")=>{let t=[],n=e.length,o=r.length,i=0,l=(a)=>{if(a+o>n)return!1;for(let p=0;p<o;p++)if(e[a+p]!==r[p])return!1;return!0};while(i<n){while(i<n&&e[i]===" ")i++;if(i>=n)break;let a="",p=e[i]==='"'||e[i]==="'";if(p){let h=e[i++];while(i<n&&e[i]!==h)a+=e[i++];if(i<n)i++}else{while(i<n&&!l(i)){let h=e[i];if(h==='"'||h==="'"){a+=h,i++;while(i<n&&e[i]!==h)a+=e[i++];if(i<n)a+=e[i++]}else a+=e[i++]}a=a.trim()}if(a)t.push({value:a,quoted:p});if(l(i))i+=o}return t}});var N={};W(N,{writeOutputs:()=>me,writeOutput:()=>xe,writeFormat:()=>Re,variable:()=>Yr,tokenize:()=>yr,toObjectWithKey:()=>or,toObject:()=>ge,toList:()=>Z,stripIndent:()=>dr,sortBy:()=>ar,snake:()=>re,sharedFunction:()=>Gr,select:()=>D,section:()=>Tr,processFields:()=>C,pascal:()=>ee,padBlock:()=>T,nonNullMap:()=>ir,navigate:()=>We,mergeAll:()=>z,merge:()=>_,makeFieldProcessorMap:()=>K,makeFieldProcessorList:()=>qe,makeFieldProcessor:()=>pe,macro:()=>c,locate:()=>V,loadFormat:()=>fe,key:()=>Kr,importList:()=>$e,importGlob:()=>tr,globMap:()=>ce,getProcessor:()=>ue,getArgs:()=>Fe,find:()=>fr,exists:()=>q,encoder:()=>Qr,defined:()=>sr,deepClone:()=>I,decoder:()=>Xr,conditionPredicates:()=>L,changeCase:()=>te,capital:()=>we,camel:()=>he,asyncMap:()=>lr,ObjectorPlugin:()=>H,Objector:()=>$t,NavigateResult:()=>M,NavigateAction:()=>Ce,Logger:()=>Ke,AsyncFunction:()=>gr});var ze={};W(ze,{processFields:()=>C,makeFieldProcessorMap:()=>K,makeFieldProcessorList:()=>qe,makeFieldProcessor:()=>pe,getProcessor:()=>ue,getArgs:()=>Fe});var mo=Object.create,{getPrototypeOf:go,defineProperty:Dr,getOwnPropertyNames:yo}=Object,wo=Object.prototype.hasOwnProperty,ho=(e,r,t)=>{t=e!=null?mo(go(e)):{};let n=r||!e||!e.__esModule?Dr(t,"default",{value:e,enumerable:!0}):t;for(let o of yo(e))if(!wo.call(n,o))Dr(n,o,{get:()=>e[o],enumerable:!0});return n},bo=(e,r)=>()=>(r||e((r={exports:{}}).exports,r),r.exports),Oo=bo((e,r)=>{var{defineProperty:t,getOwnPropertyNames:n,getOwnPropertyDescriptor:o}=Object,i=Object.prototype.hasOwnProperty,l=new WeakMap,a=(u)=>{var d=l.get(u),A;if(d)return d;if(d=t({},"__esModule",{value:!0}),u&&typeof u==="object"||typeof u==="function")n(u).map((g)=>!i.call(d,g)&&t(d,g,{get:()=>u[g],enumerable:!(A=o(u,g))||A.enumerable}));return l.set(u,d),d},p=(u,d)=>{for(var A in d)t(u,A,{get:d[A],enumerable:!0,configurable:!0,set:(g)=>d[A]=()=>g})},h={};p(h,{splitWithQuotes:()=>y,splitNested:()=>O}),r.exports=a(h);var O=(u,d,A="(",g=")")=>{let v=0,f="",j=[];for(let b of u){if(f+=b,b===A)v++;if(b===g)v--;if(v===0&&b===d)j.push(f.slice(0,-1)),f=""}if(f)j.push(f);return j},y=(u,d=",")=>{let A=[],g=u.length,v=d.length,f=0,j=(b)=>{if(b+v>g)return!1;for(let S=0;S<v;S++)if(u[b+S]!==d[S])return!1;return!0};while(f<g){while(f<g&&u[f]===" ")f++;if(f>=g)break;let b="",S=u[f]==='"'||u[f]==="'";if(S){let k=u[f++];while(f<g&&u[f]!==k)b+=u[f++];if(f<g)f++}else{while(f<g&&!j(f)){let k=u[f];if(k==='"'||k==="'"){b+=k,f++;while(f<g&&u[f]!==k)b+=u[f++];if(f<g)b+=u[f++]}else b+=u[f++]}b=b.trim()}if(b)A.push({value:b,quoted:S});if(j(f))f+=v}return A}}),vo=ho(Oo(),1),X;((e)=>{e[e.Explore=0]="Explore",e[e.SkipSiblings=1]="SkipSiblings",e[e.NoExplore=2]="NoExplore",e[e.ReplaceParent=3]="ReplaceParent",e[e.DeleteParent=4]="DeleteParent",e[e.MergeParent=5]="MergeParent",e[e.ReplaceItem=6]="ReplaceItem",e[e.DeleteItem=7]="DeleteItem"})(X||={});class x{action;by;skipSiblings;reexplore;constructor(e,r,t,n){this.action=e,this.by=r,this.skipSiblings=t,this.reexplore=n}static _explore=new x(0);static _noExplore=new x(2);static _skipSiblings=new x(1);static _deleteParent=new x(4);static ReplaceParent(e,r){return new x(3,e,void 0,r)}static SkipSiblings(){return x._skipSiblings}static Explore(){return x._explore}static NoExplore(){return x._noExplore}static DeleteParent(){return x._deleteParent}static MergeParent(e){return new x(5,e)}static ReplaceItem(e,r){return new x(6,e,r)}static DeleteItem(e){return new x(7,void 0,e)}}var Ao=async(e,r)=>{let t=new WeakSet,n=[],o=[],i=async(a,p,h)=>{let O=a===null,y=O?x.Explore():await r({key:a,value:p,path:n,parent:h,parents:o});if(p&&typeof p==="object"&&y.action===0){if(t.has(p))return y;if(t.add(p),!O)n.push(a),o.push(h);let u=p;while(await l(u,a,h))u=h[a];if(!O)o.pop(),n.pop()}return y},l=async(a,p,h)=>{let O=Object.keys(a),y=O.length;for(let u=0;u<y;u++){let d=O[u],A=a[d],g=await i(d,A,a),v=g.action;if(v===0||v===2)continue;if(v===6){if(a[d]=g.by,g.skipSiblings)return;continue}if(v===7){if(delete a[d],g.skipSiblings)return;continue}if(v===1)return;if(v===3){if(p===null)throw Error("Cannot replace root object");if(h[p]=g.by,g.reexplore)return!0;return}if(v===4){if(p===null)throw Error("Cannot delete root object");delete h[p];return}if(v===5)delete a[d],Object.assign(a,g.by)}};await i(null,e,null)},Eo=Object.create,{getPrototypeOf:Mo,defineProperty:Fr,getOwnPropertyNames:So}=Object,jo=Object.prototype.hasOwnProperty,ko=(e,r,t)=>{t=e!=null?Eo(Mo(e)):{};let n=r||!e||!e.__esModule?Fr(t,"default",{value:e,enumerable:!0}):t;for(let o of So(e))if(!jo.call(n,o))Fr(n,o,{get:()=>e[o],enumerable:!0});return n},Do=(e,r)=>()=>(r||e((r={exports:{}}).exports,r),r.exports),Fo=Do((e,r)=>{var{defineProperty:t,getOwnPropertyNames:n,getOwnPropertyDescriptor:o}=Object,i=Object.prototype.hasOwnProperty,l=new WeakMap,a=(u)=>{var d=l.get(u),A;if(d)return d;if(d=t({},"__esModule",{value:!0}),u&&typeof u==="object"||typeof u==="function")n(u).map((g)=>!i.call(d,g)&&t(d,g,{get:()=>u[g],enumerable:!(A=o(u,g))||A.enumerable}));return l.set(u,d),d},p=(u,d)=>{for(var A in d)t(u,A,{get:d[A],enumerable:!0,configurable:!0,set:(g)=>d[A]=()=>g})},h={};p(h,{splitWithQuotes:()=>y,splitNested:()=>O}),r.exports=a(h);var O=(u,d,A="(",g=")")=>{let v=0,f="",j=[];for(let b of u){if(f+=b,b===A)v++;if(b===g)v--;if(v===0&&b===d)j.push(f.slice(0,-1)),f=""}if(f)j.push(f);return j},y=(u,d=",")=>{let A=[],g=u.length,v=d.length,f=0,j=(b)=>{if(b+v>g)return!1;for(let S=0;S<v;S++)if(u[b+S]!==d[S])return!1;return!0};while(f<g){while(f<g&&u[f]===" ")f++;if(f>=g)break;let b="",S=u[f]==='"'||u[f]==="'";if(S){let k=u[f++];while(f<g&&u[f]!==k)b+=u[f++];if(f<g)f++}else{while(f<g&&!j(f)){let k=u[f];if(k==='"'||k==="'"){b+=k,f++;while(f<g&&u[f]!==k)b+=u[f++];if(f<g)b+=u[f++]}else b+=u[f++]}b=b.trim()}if(b)A.push({value:b,quoted:S});if(j(f))f+=v}return A}}),Ro=ko(Fo(),1),xo=/^\[([^=\]]*)([=]*)([^\]]*)\]$/,$o=/^([^[\]]*)\[([^\]]*)]$/,He=(e,r,t,n)=>{if(e.startsWith("{")&&e.endsWith("}")){let o=e.substring(1,e.length-1);return le(r,o,t)?.toString()}return n?e:void 0},Co=(e,r,t,n)=>{let o=He(r,t,n);if(o)return le(e,o,n);let i=xo.exec(r);if(i){let[,a,p,h]=i,O=He(a.trim(),t,n,!0),y=He(h.trim(),t,n,!0);if(Array.isArray(e)&&(p==="="||p==="==")&&O)return e.find((u)=>u?.[O]==y)}let l=$o.exec(r);if(l){let[,a,p]=l;return e?.[a]?.[p]}return e?.[r]},le=(e,r,t)=>{let n=void 0,o=void 0,i=r??"",l=(y)=>{if(!y)return[y,!1];return y.endsWith("?")?[y.substring(0,y.length-1),!0]:[y,!1]},a=(y,u)=>{let[d,A]=l(u.pop());if(!d){if(t?.set!==void 0&&o!==void 0&&n!==void 0)n[o]=t.set;return y}let g=Co(y,d,e,t);if(g===void 0){if(A||t?.optional||t?.defaultValue!==void 0)return;throw Error(`Unknown path element: "${d}" in "${i}"`)}return n=y,o=d,a(g,u)},p=Ro.splitNested(i,t?.separator??".","{","}"),h=void 0;if(p.length>0&&p[p.length-1].startsWith("?="))h=p.pop()?.substring(2);p.reverse();let O=a(e,p);if(O===void 0)return h??t?.defaultValue;return O},Rr=(e,r)=>{if(typeof e.value==="string"){if(e.quoted)return e.value;if(e.value.startsWith("[")&&e.value.endsWith("]")){let t=e.value.slice(1,-1);if(t.trim()==="")return[];return t.split(";").map((n)=>{let o=n.trim();if(!isNaN(+o))return+o;return o})}if(e.value.startsWith("{")&&e.value.endsWith("}")){if(e.value.slice(1,-1).trim()==="")return{}}if(e.value==="null")return null;if(e.value==="undefined")return;if(e.value.startsWith("@"))return e.value.slice(1);if(!isNaN(+e.value))return+e.value}return r(e.value)},De=(e,r,t,n,o,i)=>{let l=n?.(e)??e,a=o(l);if(a[0])return a[1];if(!r){let p=le(t,e),h=o(p);if(h[0])return h[1]}throw Error(i)},$r=(e,r,t,n,o)=>{let i=typeof e.types==="function"?e.types(n,r.value,o):e.types?.[n];if(!i||i==="ref")return Rr(r,(a)=>le(t,a));let l=Rr(r,()=>r.value);if(Array.isArray(i)){if(!i.includes(l))throw Error(`Argument ${n.toString()} must be one of [${i.join(", ")}]: ${l}`);return l}if(typeof i==="string"){if(i.endsWith("?")){let a=i.slice(0,-1);if(r.value==="null")return x.ReplaceItem(null);if(r.value==="undefined")return x.ReplaceItem(void 0);if(r.value==="")return"";i=a}switch(i){case"any":return l;case"array":return De(l,r.quoted,t,null,(a)=>[Array.isArray(a),a],`Argument ${n.toString()} must be an array: ${l}`);case"object":return De(l,r.quoted,t,null,(a)=>[typeof a==="object"&&a!==null,a],`Argument ${n.toString()} must be an object: ${l}`);case"number":return De(l,r.quoted,t,(a)=>Number(a),(a)=>[!isNaN(a),a],`Argument ${n.toString()} must be a number: ${l}`);case"boolean":return De(l,r.quoted,t,null,(a)=>{if([!0,"true","1",1,"yes","on"].includes(a))return[!0,!0];if([!1,"false","0",0,"no","off"].includes(a))return[!0,!1];if([null,"null","undefined",void 0,""].includes(a))return[!0,!1];if(Array.isArray(a))return[!0,a.length>0];return[!1,!1]},`Argument ${n.toString()} must be a boolean: ${l}`);case"string":return l.toString();default:throw Error(`Unknown type for argument ${n.toString()}: ${i}`)}}return i(l,t,n,r.quoted)},ue=(e,r)=>{let t=e?.[r];if(t===void 0)throw Error(`Unhandled field processor type: ${r}`);return typeof t==="function"?{options:{},fn:t}:{options:t,fn:t.fn}},Cr=(e)=>!e.quoted&&e.value.startsWith("."),Wo=(e)=>{let r={};for(let t of e){if(!Cr(t))continue;let n=t.value.indexOf("="),o=n>-1?t.value.slice(1,n):t.value.slice(1),i=n>-1?t.value.slice(n+1):"";if(i.length>=2){let l=i[0],a=i[i.length-1];if(l==='"'&&a==='"'||l==="'"&&a==="'")i=i.slice(1,-1)}if(!r[o])r[o]=[];r[o].push(i)}return r},Fe=(e,r,t)=>{let n=vo.splitWithQuotes(e??""),o=Wo(n),i=n.filter((a)=>!Cr(a)),l=r.options.processArgs===!1?[]:i.map((a,p)=>$r(r.options,a,t,p,i));return{rawArgs:i,parsedArgs:l,tags:o}},No=(e)=>{return e!==null&&typeof e==="object"&&"action"in e},Io=(e,r)=>r.keys!==void 0&&e.key.startsWith(".")&&r.keys[e.key.substring(1)]!==void 0,Lo=async(e,r,t,n)=>{let{key:o,parent:i}=e,l=ue(n.keys,o.substring(1));if(l.options.processArgs!==!1&&(typeof l.options.types==="function"||l.options.types?.[0]!==void 0))e.value=$r(l.options,{value:e.value,quoted:!1},t,0,[]);if(typeof e.value!=="string")await C(e.value,{...n,root:{...t,parent:e.parent,parents:e.parents},filters:[...n.filters??[],...l.options.filters??[]]});let a=await l.fn({path:r,root:t,parent:i,key:o,options:n,value:e.value,args:[],rawArgs:[],tags:{}});return No(a)?a:x.ReplaceParent(a)},xr=(e)=>{let r=e.split(/\r?\n/),t=r.filter((o)=>o.trim().length>0).map((o)=>/^[ \t]*/.exec(o)?.[0].length??0),n=t.length>0?Math.min(...t):0;if(n===0)return e;return r.map((o)=>o.slice(n)).join(`
+var Ar=Object.create;var{getPrototypeOf:ro,defineProperty:Q,getOwnPropertyNames:Er,getOwnPropertyDescriptor:to}=Object,Qe=Object.prototype.hasOwnProperty;function Xe(e){return this[e]}var R=(e,r,t)=>{var n=Er(r);for(let o of n)if(!Qe.call(e,o)&&o!=="default")Q(e,o,{get:Xe.bind(r,o),enumerable:!0});if(t){for(let o of n)if(!Qe.call(t,o)&&o!=="default")Q(t,o,{get:Xe.bind(r,o),enumerable:!0});return t}},no,oo,io=(e,r,t)=>{var n=e!=null&&typeof e==="object";if(n){var o=r?no??=new WeakMap:oo??=new WeakMap,i=o.get(e);if(i)return i}t=e!=null?Ar(ro(e)):{};let l=r||!e||!e.__esModule?Q(t,"default",{value:e,enumerable:!0}):t;for(let a of Er(e))if(!Qe.call(l,a))Q(l,a,{get:Xe.bind(e,a),enumerable:!0});if(n)o.set(e,l);return l};var so=(e,r)=>()=>(r||e((r={exports:{}}).exports,r),r.exports),br=(e,r)=>{return Object.defineProperty(e,"name",{value:r,enumerable:!1,configurable:!0}),e},ao=(e)=>e;function lo(e,r){this[e]=ao.bind(null,r)}var W=(e,r)=>{for(var t in r)Q(e,t,{get:r[t],enumerable:!0,configurable:!0,set:lo.bind(r,t)})};var Mr=(e,r)=>(r=Symbol[e])?r:Symbol.for("Symbol."+e),ae=(e)=>{throw TypeError(e)},uo=(e,r,t)=>(r in e)?Q(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t;var Ve=(e,r,t)=>r.has(e)||ae("Cannot "+t),po=(e,r)=>Object(r)!==r?ae('Cannot use the "in" operator on this value'):e.has(r),Or=(e,r,t)=>(Ve(e,r,"read from private field"),t?t.call(e):r.get(e));var vr=(e,r,t,n)=>(Ve(e,r,"write to private field"),n?n.call(e,t):r.set(e,t),t),fo=(e,r,t)=>(Ve(e,r,"access private method"),t),Sr=(e)=>[,,,Ar(e?.[Mr("metadata")]??null)],jr=["class","method","getter","setter","accessor","field","value","get","set"],se=(e)=>e!==void 0&&typeof e!=="function"?ae("Function expected"):e,co=(e,r,t,n,o)=>({kind:jr[e],name:r,metadata:n,addInitializer:(i)=>t._?ae("Already initialized"):o.push(se(i||null))}),Ze=(e,r)=>uo(r,Mr("metadata"),e[3]),kr=(e,r,t,n)=>{for(var o=0,i=e[r>>1],l=i&&i.length;o<l;o++)r&1?i[o].call(t):n=i[o].call(t,n);return n},m=(e,r,t,n,o,i)=>{var l,a,p,h,O,y=r&7,u=!!(r&8),d=!!(r&16),A=y>3?e.length+1:y?u?1:2:0,g=jr[y+5],v=y>3&&(e[A-1]=[]),f=e[A]||(e[A]=[]),j=y&&(!d&&!u&&(o=o.prototype),y<5&&(y>3||!d)&&to(y<4?o:{get[t](){return Or(this,i)},set[t](S){vr(this,i,S)}},t));y?d&&y<4&&br(i,(y>2?"set ":y>1?"get ":"")+t):br(o,t);for(var b=n.length-1;b>=0;b--){if(h=co(y,t,p={},e[3],f),y){if(h.static=u,h.private=d,O=h.access={has:d?(S)=>po(o,S):(S)=>(t in S)},y^3)O.get=d?(S)=>(y^1?Or:fo)(S,o,y^4?i:j.get):(S)=>S[t];if(y>2)O.set=d?(S,k)=>vr(S,o,k,y^4?i:j.set):(S,k)=>S[t]=k}if(a=(0,n[b])(y?y<4?d?i:j[g]:y>4?void 0:{get:j.get,set:j.set}:o,h),p._=1,y^4||a===void 0)se(a)&&(y>4?v.unshift(a):y?d?i=a:j[g]=a:o=a);else if(typeof a!=="object"||a===null)ae("Object expected");else se(l=a.get)&&(j.get=l),se(l=a.set)&&(j.set=l),se(l=a.init)&&v.unshift(l)}return y||Ze(e,o),j&&Q(o,t,j),d?y^4?i:j:o};var Rt=so((il,Ft)=>{var{defineProperty:hr,getOwnPropertyNames:ci,getOwnPropertyDescriptor:mi}=Object,gi=Object.prototype.hasOwnProperty,kt=new WeakMap,yi=(e)=>{var r=kt.get(e),t;if(r)return r;if(r=hr({},"__esModule",{value:!0}),e&&typeof e==="object"||typeof e==="function")ci(e).map((n)=>!gi.call(r,n)&&hr(r,n,{get:()=>e[n],enumerable:!(t=mi(e,n))||t.enumerable}));return kt.set(e,r),r},di=(e,r)=>{for(var t in r)hr(e,t,{get:r[t],enumerable:!0,configurable:!0,set:(n)=>r[t]=()=>n})},Dt={};di(Dt,{splitWithQuotes:()=>hi,splitNested:()=>wi});Ft.exports=yi(Dt);var wi=(e,r,t="(",n=")")=>{let o=0,i="",l=[];for(let a of e){if(i+=a,a===t)o++;if(a===n)o--;if(o===0&&a===r)l.push(i.slice(0,-1)),i=""}if(i)l.push(i);return l},hi=(e,r=",")=>{let t=[],n=e.length,o=r.length,i=0,l=(a)=>{if(a+o>n)return!1;for(let p=0;p<o;p++)if(e[a+p]!==r[p])return!1;return!0};while(i<n){while(i<n&&e[i]===" ")i++;if(i>=n)break;let a="",p=e[i]==='"'||e[i]==="'";if(p){let h=e[i++];while(i<n&&e[i]!==h)a+=e[i++];if(i<n)i++}else{while(i<n&&!l(i)){let h=e[i];if(h==='"'||h==="'"){a+=h,i++;while(i<n&&e[i]!==h)a+=e[i++];if(i<n)a+=e[i++]}else a+=e[i++]}a=a.trim()}if(a)t.push({value:a,quoted:p});if(l(i))i+=o}return t}});var N={};W(N,{writeOutputs:()=>me,writeOutput:()=>xe,writeFormat:()=>Re,variable:()=>Yr,tokenize:()=>yr,toObjectWithKey:()=>or,toObject:()=>ge,toList:()=>Z,stripIndent:()=>dr,sortBy:()=>ar,snake:()=>re,sharedFunction:()=>Gr,select:()=>D,section:()=>Tr,processFields:()=>C,pascal:()=>ee,padBlock:()=>T,nonNullMap:()=>ir,navigate:()=>We,mergeAll:()=>z,merge:()=>_,makeFieldProcessorMap:()=>K,makeFieldProcessorList:()=>qe,makeFieldProcessor:()=>pe,macro:()=>c,locate:()=>V,loadFormat:()=>fe,key:()=>Kr,importList:()=>$e,importGlob:()=>tr,globMap:()=>ce,getProcessor:()=>ue,getArgs:()=>Fe,find:()=>fr,exists:()=>q,encoder:()=>Qr,defined:()=>sr,deepClone:()=>I,decoder:()=>Xr,conditionPredicates:()=>L,changeCase:()=>te,capital:()=>we,camel:()=>he,asyncMap:()=>lr,ObjectorPlugin:()=>H,Objector:()=>$t,NavigateResult:()=>M,NavigateAction:()=>Ce,Logger:()=>Ke,AsyncFunction:()=>gr});var ze={};W(ze,{processFields:()=>C,makeFieldProcessorMap:()=>K,makeFieldProcessorList:()=>qe,makeFieldProcessor:()=>pe,getProcessor:()=>ue,getArgs:()=>Fe});var mo=Object.create,{getPrototypeOf:go,defineProperty:Dr,getOwnPropertyNames:yo}=Object,wo=Object.prototype.hasOwnProperty,ho=(e,r,t)=>{t=e!=null?mo(go(e)):{};let n=r||!e||!e.__esModule?Dr(t,"default",{value:e,enumerable:!0}):t;for(let o of yo(e))if(!wo.call(n,o))Dr(n,o,{get:()=>e[o],enumerable:!0});return n},bo=(e,r)=>()=>(r||e((r={exports:{}}).exports,r),r.exports),Oo=bo((e,r)=>{var{defineProperty:t,getOwnPropertyNames:n,getOwnPropertyDescriptor:o}=Object,i=Object.prototype.hasOwnProperty,l=new WeakMap,a=(u)=>{var d=l.get(u),A;if(d)return d;if(d=t({},"__esModule",{value:!0}),u&&typeof u==="object"||typeof u==="function")n(u).map((g)=>!i.call(d,g)&&t(d,g,{get:()=>u[g],enumerable:!(A=o(u,g))||A.enumerable}));return l.set(u,d),d},p=(u,d)=>{for(var A in d)t(u,A,{get:d[A],enumerable:!0,configurable:!0,set:(g)=>d[A]=()=>g})},h={};p(h,{splitWithQuotes:()=>y,splitNested:()=>O}),r.exports=a(h);var O=(u,d,A="(",g=")")=>{let v=0,f="",j=[];for(let b of u){if(f+=b,b===A)v++;if(b===g)v--;if(v===0&&b===d)j.push(f.slice(0,-1)),f=""}if(f)j.push(f);return j},y=(u,d=",")=>{let A=[],g=u.length,v=d.length,f=0,j=(b)=>{if(b+v>g)return!1;for(let S=0;S<v;S++)if(u[b+S]!==d[S])return!1;return!0};while(f<g){while(f<g&&u[f]===" ")f++;if(f>=g)break;let b="",S=u[f]==='"'||u[f]==="'";if(S){let k=u[f++];while(f<g&&u[f]!==k)b+=u[f++];if(f<g)f++}else{while(f<g&&!j(f)){let k=u[f];if(k==='"'||k==="'"){b+=k,f++;while(f<g&&u[f]!==k)b+=u[f++];if(f<g)b+=u[f++]}else b+=u[f++]}b=b.trim()}if(b)A.push({value:b,quoted:S});if(j(f))f+=v}return A}}),vo=ho(Oo(),1),X;((e)=>{e[e.Explore=0]="Explore",e[e.SkipSiblings=1]="SkipSiblings",e[e.NoExplore=2]="NoExplore",e[e.ReplaceParent=3]="ReplaceParent",e[e.DeleteParent=4]="DeleteParent",e[e.MergeParent=5]="MergeParent",e[e.ReplaceItem=6]="ReplaceItem",e[e.DeleteItem=7]="DeleteItem"})(X||={});class x{action;by;skipSiblings;reexplore;constructor(e,r,t,n){this.action=e,this.by=r,this.skipSiblings=t,this.reexplore=n}static _explore=new x(0);static _noExplore=new x(2);static _skipSiblings=new x(1);static _deleteParent=new x(4);static ReplaceParent(e,r){return new x(3,e,void 0,r)}static SkipSiblings(){return x._skipSiblings}static Explore(){return x._explore}static NoExplore(){return x._noExplore}static DeleteParent(){return x._deleteParent}static MergeParent(e){return new x(5,e)}static ReplaceItem(e,r){return new x(6,e,r)}static DeleteItem(e){return new x(7,void 0,e)}}var Ao=async(e,r)=>{let t=new WeakSet,n=[],o=[],i=async(a,p,h)=>{let O=a===null,y=O?x.Explore():await r({key:a,value:p,path:n,parent:h,parents:o});if(p&&typeof p==="object"&&y.action===0){if(t.has(p))return y;if(t.add(p),!O)n.push(a),o.push(h);let u=p;while(await l(u,a,h))u=h[a];if(!O)o.pop(),n.pop()}return y},l=async(a,p,h)=>{let O=Object.keys(a),y=O.length;for(let u=0;u<y;u++){let d=O[u],A=a[d],g=await i(d,A,a),v=g.action;if(v===0||v===2)continue;if(v===6){if(a[d]=g.by,g.skipSiblings)return;continue}if(v===7){if(delete a[d],g.skipSiblings)return;continue}if(v===1)return;if(v===3){if(p===null)throw Error("Cannot replace root object");if(h[p]=g.by,g.reexplore)return!0;return}if(v===4){if(p===null)throw Error("Cannot delete root object");delete h[p];return}if(v===5)delete a[d],Object.assign(a,g.by)}};await i(null,e,null)},Eo=Object.create,{getPrototypeOf:Mo,defineProperty:Fr,getOwnPropertyNames:So}=Object,jo=Object.prototype.hasOwnProperty,ko=(e,r,t)=>{t=e!=null?Eo(Mo(e)):{};let n=r||!e||!e.__esModule?Fr(t,"default",{value:e,enumerable:!0}):t;for(let o of So(e))if(!jo.call(n,o))Fr(n,o,{get:()=>e[o],enumerable:!0});return n},Do=(e,r)=>()=>(r||e((r={exports:{}}).exports,r),r.exports),Fo=Do((e,r)=>{var{defineProperty:t,getOwnPropertyNames:n,getOwnPropertyDescriptor:o}=Object,i=Object.prototype.hasOwnProperty,l=new WeakMap,a=(u)=>{var d=l.get(u),A;if(d)return d;if(d=t({},"__esModule",{value:!0}),u&&typeof u==="object"||typeof u==="function")n(u).map((g)=>!i.call(d,g)&&t(d,g,{get:()=>u[g],enumerable:!(A=o(u,g))||A.enumerable}));return l.set(u,d),d},p=(u,d)=>{for(var A in d)t(u,A,{get:d[A],enumerable:!0,configurable:!0,set:(g)=>d[A]=()=>g})},h={};p(h,{splitWithQuotes:()=>y,splitNested:()=>O}),r.exports=a(h);var O=(u,d,A="(",g=")")=>{let v=0,f="",j=[];for(let b of u){if(f+=b,b===A)v++;if(b===g)v--;if(v===0&&b===d)j.push(f.slice(0,-1)),f=""}if(f)j.push(f);return j},y=(u,d=",")=>{let A=[],g=u.length,v=d.length,f=0,j=(b)=>{if(b+v>g)return!1;for(let S=0;S<v;S++)if(u[b+S]!==d[S])return!1;return!0};while(f<g){while(f<g&&u[f]===" ")f++;if(f>=g)break;let b="",S=u[f]==='"'||u[f]==="'";if(S){let k=u[f++];while(f<g&&u[f]!==k)b+=u[f++];if(f<g)f++}else{while(f<g&&!j(f)){let k=u[f];if(k==='"'||k==="'"){b+=k,f++;while(f<g&&u[f]!==k)b+=u[f++];if(f<g)b+=u[f++]}else b+=u[f++]}b=b.trim()}if(b)A.push({value:b,quoted:S});if(j(f))f+=v}return A}}),Ro=ko(Fo(),1),xo=/^\[([^=\]]*)([=]*)([^\]]*)\]$/,$o=/^([^[\]]*)\[([^\]]*)]$/,He=(e,r,t,n)=>{if(e.startsWith("{")&&e.endsWith("}")){let o=e.substring(1,e.length-1);return le(r,o,t)?.toString()}return n?e:void 0},Co=(e,r,t,n)=>{let o=He(r,t,n);if(o)return le(e,o,n);let i=xo.exec(r);if(i){let[,a,p,h]=i,O=He(a.trim(),t,n,!0),y=He(h.trim(),t,n,!0);if(Array.isArray(e)&&(p==="="||p==="==")&&O)return e.find((u)=>u?.[O]==y)}let l=$o.exec(r);if(l){let[,a,p]=l;return e?.[a]?.[p]}return e?.[r]},le=(e,r,t)=>{let n=void 0,o=void 0,i=r??"",l=(y)=>{if(!y)return[y,!1];return y.endsWith("?")?[y.substring(0,y.length-1),!0]:[y,!1]},a=(y,u)=>{let[d,A]=l(u.pop());if(!d){if(t?.set!==void 0&&o!==void 0&&n!==void 0)n[o]=t.set;return y}let g=Co(y,d,e,t);if(g===void 0){if(A||t?.optional||t?.defaultValue!==void 0)return;throw Error(`Unknown path element: "${d}" in "${i}"`)}return n=y,o=d,a(g,u)},p=Ro.splitNested(i,t?.separator??".","{","}"),h=void 0;if(p.length>0&&p[p.length-1].startsWith("?="))h=p.pop()?.substring(2);p.reverse();let O=a(e,p);if(O===void 0)return h??t?.defaultValue;return O},Rr=(e,r)=>{if(typeof e.value==="string"){if(e.quoted)return e.value;if(e.value.startsWith("[")&&e.value.endsWith("]")){let t=e.value.slice(1,-1);if(t.trim()==="")return[];return t.split(";").map((n)=>{let o=n.trim();if(!isNaN(+o))return+o;return o})}if(e.value.startsWith("{")&&e.value.endsWith("}")){if(e.value.slice(1,-1).trim()==="")return{}}if(e.value==="null")return null;if(e.value==="undefined")return;if(e.value.startsWith("@"))return e.value.slice(1);if(!isNaN(+e.value))return+e.value}return r(e.value)},De=(e,r,t,n,o,i)=>{let l=n?.(e)??e,a=o(l);if(a[0])return a[1];if(!r){let p=le(t,e),h=o(p);if(h[0])return h[1]}throw Error(i)},$r=(e,r,t,n,o)=>{let i=typeof e.types==="function"?e.types(n,r.value,o):e.types?.[n];if(!i||i==="ref")return Rr(r,(a)=>le(t,a));let l=Rr(r,()=>r.value);if(Array.isArray(i)){if(!i.includes(l))throw Error(`Argument ${n.toString()} must be one of [${i.join(", ")}]: ${l}`);return l}if(typeof i==="string"){if(i.endsWith("?")){let a=i.slice(0,-1);if(r.value==="null")return x.ReplaceItem(null);if(r.value==="undefined")return x.ReplaceItem(void 0);if(r.value==="")return"";i=a}switch(i){case"any":return l;case"array":return De(l,r.quoted,t,null,(a)=>[Array.isArray(a),a],`Argument ${n.toString()} must be an array: ${l}`);case"object":return De(l,r.quoted,t,null,(a)=>[typeof a==="object"&&a!==null,a],`Argument ${n.toString()} must be an object: ${l}`);case"number":return De(l,r.quoted,t,(a)=>Number(a),(a)=>[!isNaN(a),a],`Argument ${n.toString()} must be a number: ${l}`);case"boolean":return De(l,r.quoted,t,null,(a)=>{if([!0,"true","1",1,"yes","on"].includes(a))return[!0,!0];if([!1,"false","0",0,"no","off"].includes(a))return[!0,!1];if([null,"null","undefined",void 0,""].includes(a))return[!0,!1];if(Array.isArray(a))return[!0,a.length>0];return[!1,!1]},`Argument ${n.toString()} must be a boolean: ${l}`);case"string":return l.toString();default:throw Error(`Unknown type for argument ${n.toString()}: ${i}`)}}return i(l,t,n,r.quoted)},ue=(e,r)=>{let t=e?.[r];if(t===void 0)throw Error(`Unhandled field processor type: ${r}`);return typeof t==="function"?{options:{},fn:t}:{options:t,fn:t.fn}},Cr=(e)=>!e.quoted&&e.value.startsWith("."),Wo=(e)=>{let r={};for(let t of e){if(!Cr(t))continue;let n=t.value.indexOf("="),o=n>-1?t.value.slice(1,n):t.value.slice(1),i=n>-1?t.value.slice(n+1):"";if(i.length>=2){let l=i[0],a=i[i.length-1];if(l==='"'&&a==='"'||l==="'"&&a==="'")i=i.slice(1,-1)}if(!r[o])r[o]=[];r[o].push(i)}return r},Fe=(e,r,t)=>{let n=vo.splitWithQuotes(e??""),o=Wo(n),i=n.filter((a)=>!Cr(a)),l=r.options.processArgs===!1?[]:i.map((a,p)=>$r(r.options,a,t,p,i));return{rawArgs:i,parsedArgs:l,tags:o}},No=(e)=>{return e!==null&&typeof e==="object"&&"action"in e},Io=(e,r)=>r.keys!==void 0&&e.key.startsWith(".")&&r.keys[e.key.substring(1)]!==void 0,Lo=async(e,r,t,n)=>{let{key:o,parent:i}=e,l=ue(n.keys,o.substring(1));if(l.options.processArgs!==!1&&(typeof l.options.types==="function"||l.options.types?.[0]!==void 0))e.value=$r(l.options,{value:e.value,quoted:!1},t,0,[]);if(typeof e.value!=="string")await C(e.value,{...n,root:{...t,parent:e.parent,parents:e.parents},filters:[...n.filters??[],...l.options.filters??[]]});let a=await l.fn({path:r,root:t,parent:i,key:o,options:n,value:e.value,args:[],rawArgs:[],tags:{}});return No(a)?a:x.ReplaceParent(a)},xr=(e)=>{let r=e.split(/\r?\n/),t=r.filter((o)=>o.trim().length>0).map((o)=>/^[ \t]*/.exec(o)?.[0].length??0),n=t.length>0?Math.min(...t):0;if(n===0)return e;return r.map((o)=>o.slice(n)).join(`
 `)},_o=async(e,r,t,n)=>{if(!r?.onSection&&!r?.onSectionConfig&&!r?.sections)return[e,!1];let o=/<@\s*section(?:\s*:\s*([\w-]+))?\s*@>([\s\S]*?)<@\s*\/\s*section\s*@>/g,i,l=e,a=0,p=!1,h={content:l,root:n,path:t,options:r,section:{}};while((i=o.exec(e))!==null){p=!0;let[O,y,u]=i,d=i.index,A=d+O.length,g=e[A]===`
 `;if(g)A++;let v=d+a,f=A+a,j={},b=u,S=/(^|\r?\n)[ \t]*---[ \t]*(\r?\n|$)/m.exec(u);if(S){let oe=u.slice(0,S.index),Ye=S.index+S[0].length;b=u.slice(Ye);let je=xr(oe).trim();if(je.length>0)try{j=r?.configParser?.(je)??{}}catch(Ge){throw Error(`Failed to parse YAML config for section: ${Ge.message}`)}}else if(/^\r?\n/.test(b))b=b.replace(/^\r?\n/,"");b=xr(b),b=b.replace(/(?:\r?\n[ \t]*)+$/,""),b=b.replace(/[ \t]+$/,"");let k={config:y?{...j,type:y}:j,content:b};if(h.content=l,h.section=k,Object.keys(k.config).length>0){if(await r.onSectionConfig?.(h)!==!1)await C(k.config,{...r,root:n})}let Ae=h.section.config.type?r.sections?.[h.section.config.type]:void 0,G;if(Ae)G=await Ae(h);else if(r.onSection)G=await r.onSection(h);if(k.trim)k.content=k.content.trim();if(k.indent)k.content=k.content.split(`
 `).map((oe)=>" ".repeat(k.indent)+oe).join(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homedev/objector",
-  "version": "1.2.61",
+  "version": "1.2.62",
   "description": "object extensions for YAML/JSON",
   "author": "julzor",
   "license": "ISC",