@fgv/ts-res 5.1.0-3 → 5.1.0-30

package/dist/packlets/runtime/resource-tree/readOnlyResourceTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readOnlyResourceTree.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/readOnlyResourceTree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,iBAAiB,EAAU,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC9F,OAAO,EAA4B,OAAO,EAAE,MAAM,cAAc,CAAC;AAQjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAgCtE,cAAc;AACd;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAwD;IAExD,OAAO,UAAU,IAAI,IAAI,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAI,IAA6B;IACrE,OAAO,UAAU,IAAI,IAAI,IAAI,CAAC,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IAKnC,IAAW,MAAM;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAW,MAAM;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,YAAsB,IAAkB,EAAE,UAAkC,EAAE,QAAW;QACvF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAClB,IAAkB,EAClB,UAAkC,EAClC,QAAW;QAEX,OAAO,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,wBAAwB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvF,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,0BAA0B;IAKrC,IAAW,MAAM;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAW,MAAM;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACH,YACE,IAAkB,EAClB,UAAkC,EAClC,IAAgC;QAEhC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAE9D,MAAM,QAAQ,GAAG,UAAU,CAEvB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAIzC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE;YAC/B,IAAI,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtC,OAAO,wBAAwB,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;YACjF,CAAC;YACD,OAAO,0BAA0B,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC1E,CAAC,CAAC,CACH,CAAC,OAAO,EAAE,CAAC;QAEZ,IAAI,CAAC,QAAQ,GAAG,IAAI,4BAA4B,CAC9C,IAAI,CAAC,EAAE,EACP,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAgD,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAC/E,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAClB,SAAuB,EACvB,IAA4B,EAC5B,SAAqC;QAErC,OAAO,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,0BAA0B,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IACzF,CAAC;CACF;AAQD;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IAGnC,IAAW,MAAM;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAW,QAAQ;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAW,MAAM;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,YAAsB,IAA8B;QAClD,MAAM,QAAQ,GAAG,UAAU,CAEvB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAIzC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE;YAC/B,IAAI,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtC,OAAO,wBAAwB,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;YACnF,CAAC;YACD,OAAO,0BAA0B,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC5E,CAAC,CAAC,CACH,CAAC,OAAO,EAAE,CAAC;QAEZ,IAAI,CAAC,QAAQ,GAAG,IAAI,4BAA4B,CAC9C,SAAS,EACT,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAgD,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAC/E,CAAC;IACJ,CAAC;IAgBD;;;;OAIG;IACI,MAAM,CAAC,MAAM,CAClB,IAAkD;QAElD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,wBAAwB,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE,CAClF,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAC5D,CAAC;QACJ,CAAC;QACD,OAAO,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,sBAAsB,CAAI,SAA4B;QAClE,MAAM,MAAM,GAAsB,IAAI,iBAAiB,EAAE,CAAC;QAC1D,MAAM,IAAI,GAA6B,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAExD,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,SAAS,EAAE,CAAC;YACvC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;iBACxB,SAAS,CAAC,CAAC,cAAc,EAAE,EAAE;gBAC5B,IAAI,WAAW,GAA0D,IAAI,CAAC;gBAC9E,MAAM,YAAY,GAAG,cAAc,CAAC,GAAG,EAAG,CAAC;gBAE3C,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;oBACtC,IAAI,4BAA4B,CAAC,WAAW,CAAC,EAAE,CAAC;wBAC9C,IAAI,CAAC,CAAC,QAAQ,IAAI,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;4BACxC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;wBACpD,CAAC;wBACD,IAAI,sBAAsB,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;4BAC3D,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,2CAA2C,QAAQ,GAAG,CAAC,CAAC;wBACjF,CAAC;6BAAM,CAAC;4BACN,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;wBAC/C,CAAC;oBACH,CAAC,CAAC,0EAA0E;yBAAM,IAChF,sBAAsB,CAAC,WAAW,CAAC,EACnC,CAAC;wBACD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,uCAAuC,CAAC,CAAC;wBAChE,MAAM;oBACR,CAAC,CAAC,0EAA0E;yBAAM,CAAC;wBACjF,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,yCAAyC,CAAC,CAAC;oBACpE,CAAC;gBACH,CAAC;gBAED,IAAI,4BAA4B,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC9C,IAAI,YAAY,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;wBACzC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,+BAA+B,CAAC,CAAC;oBAC1D,CAAC;yBAAM,CAAC;wBACN,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC;oBACpD,CAAC,CAAC,0EAA0E;gBAC9E,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,uCAAuC,CAAC,CAAC;gBAClE,CAAC;gBACD,OAAO,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;YACrD,CAAC,CAAC;iBACD,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;CACF","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { MessageAggregator, Result, captureResult, mapResults, succeed } from '@fgv/ts-utils';\nimport { ResourceId, ResourceName, Helpers } from '../../common';\nimport {\n  IReadOnlyResourceTreeNode,\n  IReadOnlyResourceTreeLeaf,\n  IReadOnlyResourceTreeBranch,\n  IReadOnlyResourceTreeRoot,\n  IReadOnlyValidatingResourceTreeChildren\n} from './common';\nimport { ReadOnlyResourceTreeChildren } from './resourceTreeChildren';\n\n/**\n * Interface for initializing a resource tree root with child nodes.\n * @public\n */\nexport interface IResourceTreeRootInit<T> {\n  readonly children: Record<ResourceName, ResourceTreeNodeInit<T>>;\n}\n\n/**\n * Interface for initializing a leaf node with a resource value.\n * @public\n */\nexport interface IResourceTreeLeafInit<T> {\n  readonly resource: T;\n}\n\n/**\n * Interface for initializing a branch node with child nodes.\n * @public\n */\nexport interface IResourceTreeBranchInit<T> {\n  readonly children: Record<ResourceName, ResourceTreeNodeInit<T>>;\n}\n\n/**\n * Union type for tree node initialization data.\n * @public\n */\nexport type ResourceTreeNodeInit<T> = IResourceTreeLeafInit<T> | IResourceTreeBranchInit<T>;\n\n// Type guards\n/**\n * Type guard to determine if an init object represents a branch or root with children.\n * @param init - The initialization object to test\n * @returns True if the init object has children property\n * @public\n */\nexport function isResourceTreeRootOrNodeInit<T>(\n  init: ResourceTreeNodeInit<T> | IResourceTreeRootInit<T>\n): init is IResourceTreeBranchInit<T> {\n  return 'children' in init;\n}\n\n/**\n * Type guard to determine if an init object represents a leaf node with a resource.\n * @param init - The initialization object to test\n * @returns True if the init object has a resource but no children\n * @public\n */\nexport function isResourceTreeLeafInit<T>(init: ResourceTreeNodeInit<T>): init is IResourceTreeLeafInit<T> {\n  return 'resource' in init && !('children' in init);\n}\n\n/**\n * Implementation of a read-only resource tree leaf node that contains a resource value.\n * Leaf nodes represent the actual resources in the tree and cannot have children.\n * @public\n */\nexport class ReadOnlyResourceTreeLeaf<T> implements IReadOnlyResourceTreeLeaf<T> {\n  public readonly name: ResourceName;\n  public readonly id: ResourceId;\n  public readonly resource: T;\n\n  public get isRoot(): false {\n    return false;\n  }\n\n  public get isBranch(): false {\n    return false;\n  }\n\n  public get isLeaf(): true {\n    return true;\n  }\n\n  /**\n   * Creates a new leaf node. Use the static create method instead.\n   * @param name - The name of this node (last segment of the path)\n   * @param parentPath - The path to the parent node (undefined for root-level nodes)\n   * @param resource - The resource value stored in this leaf\n   */\n  protected constructor(name: ResourceName, parentPath: ResourceId | undefined, resource: T) {\n    this.name = name;\n    this.id = Helpers.joinResourceIds(parentPath, name).orThrow();\n    this.resource = resource;\n  }\n\n  /**\n   * Creates a new ReadOnlyResourceTreeLeaf instance.\n   * @param name - The name of this node (last segment of the path)\n   * @param parentPath - The path to the parent node (undefined for root-level nodes)\n   * @param resource - The resource value to store in this leaf\n   * @returns Result containing the new leaf node or failure if construction fails\n   */\n  public static create<T>(\n    name: ResourceName,\n    parentPath: ResourceId | undefined,\n    resource: T\n  ): Result<ReadOnlyResourceTreeLeaf<T>> {\n    return captureResult(() => new ReadOnlyResourceTreeLeaf(name, parentPath, resource));\n  }\n}\n\n/**\n * Implementation of a read-only resource tree branch node that contains child nodes.\n * Branch nodes organize other nodes in a hierarchical structure and may optionally contain a resource value.\n * @public\n */\nexport class ReadOnlyResourceTreeBranch<T> implements IReadOnlyResourceTreeBranch<T> {\n  public readonly children: IReadOnlyValidatingResourceTreeChildren<T>;\n  public readonly name: ResourceName;\n  public readonly id: ResourceId;\n\n  public get isRoot(): false {\n    return false;\n  }\n\n  public get isBranch(): true {\n    return true;\n  }\n\n  public get isLeaf(): false {\n    return false;\n  }\n\n  /**\n   * Creates a new branch node. Use the static create method instead.\n   * @param name - The name of this node (last segment of the path)\n   * @param parentPath - The path to the parent node (undefined for root-level nodes)\n   * @param init - Initialization data containing child nodes\n   */\n  private constructor(\n    name: ResourceName,\n    parentPath: ResourceId | undefined,\n    init: IResourceTreeBranchInit<T>\n  ) {\n    this.name = name;\n    this.id = Helpers.joinResourceIds(parentPath, name).orThrow();\n\n    const children = mapResults<IReadOnlyResourceTreeNode<T>>(\n      (\n        Array.from(Object.entries(init.children)) as [\n          ResourceName,\n          IResourceTreeBranchInit<T> | IResourceTreeLeafInit<T>\n        ][]\n      ).map(([childName, childInit]) => {\n        if (isResourceTreeLeafInit(childInit)) {\n          return ReadOnlyResourceTreeLeaf.create(childName, this.id, childInit.resource);\n        }\n        return ReadOnlyResourceTreeBranch.create(childName, this.id, childInit);\n      })\n    ).orThrow();\n\n    this.children = new ReadOnlyResourceTreeChildren(\n      this.id,\n      children.map((c): [ResourceName, IReadOnlyResourceTreeNode<T>] => [c.name, c])\n    );\n  }\n\n  /**\n   * Creates a new ReadOnlyResourceTreeBranch instance.\n   * @param childName - The name of this node (last segment of the path)\n   * @param path - The path to the parent node (undefined for root-level nodes)\n   * @param childInit - Initialization data containing child nodes\n   * @returns Result containing the new branch node or failure if construction fails\n   */\n  public static create<T>(\n    childName: ResourceName,\n    path: ResourceId | undefined,\n    childInit: IResourceTreeBranchInit<T>\n  ): Result<ReadOnlyResourceTreeBranch<T>> {\n    return captureResult(() => new ReadOnlyResourceTreeBranch(childName, path, childInit));\n  }\n}\n\n/**\n * Union type representing any node in a read-only resource tree.\n * @public\n */\nexport type ReadOnlyResourceTreeNode<T> = ReadOnlyResourceTreeBranch<T> | ReadOnlyResourceTreeLeaf<T>;\n\n/**\n * Implementation of a read-only resource tree root that organizes resources hierarchically.\n * The root provides the entry point for tree navigation and resource access by ResourceId paths.\n * @public\n */\nexport class ReadOnlyResourceTreeRoot<T> implements IReadOnlyResourceTreeRoot<T> {\n  public readonly children: IReadOnlyValidatingResourceTreeChildren<T>;\n\n  public get isRoot(): true {\n    return true;\n  }\n\n  public get isBranch(): false {\n    return false;\n  }\n\n  public get isLeaf(): false {\n    return false;\n  }\n\n  /**\n   * Creates a new root node. Use the static create method instead.\n   * @param init - Initialization data containing child nodes\n   */\n  protected constructor(init: IResourceTreeRootInit<T>) {\n    const children = mapResults<ReadOnlyResourceTreeBranch<T> | ReadOnlyResourceTreeLeaf<T>>(\n      (\n        Array.from(Object.entries(init.children)) as [\n          ResourceName,\n          IResourceTreeBranchInit<T> | IResourceTreeLeafInit<T>\n        ][]\n      ).map(([childName, childInit]) => {\n        if (isResourceTreeLeafInit(childInit)) {\n          return ReadOnlyResourceTreeLeaf.create(childName, undefined, childInit.resource);\n        }\n        return ReadOnlyResourceTreeBranch.create(childName, undefined, childInit);\n      })\n    ).orThrow();\n\n    this.children = new ReadOnlyResourceTreeChildren(\n      undefined,\n      children.map((c): [ResourceName, IReadOnlyResourceTreeNode<T>] => [c.name, c])\n    );\n  }\n\n  /**\n   * Creates a new ReadOnlyResourceTreeRoot from an array of resources.\n   * @param resources - Array of [ResourceId, resource] pairs to build the tree from\n   * @returns Result containing the new root or failure if construction fails\n   */\n  public static create<T>(resources: [ResourceId, T][]): Result<ReadOnlyResourceTreeRoot<T>>;\n\n  /**\n   * Creates a new ReadOnlyResourceTreeRoot from initialization data.\n   * @param init - Tree initialization structure\n   * @returns Result containing the new root or failure if construction fails\n   */\n  public static create<T>(init: IResourceTreeRootInit<T>): Result<ReadOnlyResourceTreeRoot<T>>;\n\n  /**\n   * Creates a new ReadOnlyResourceTreeRoot from either resources or initialization data.\n   * @param init - Either an array of [ResourceId, resource] pairs or tree initialization structure\n   * @returns Result containing the new root or failure if construction fails\n   */\n  public static create<T>(\n    init: IResourceTreeRootInit<T> | [ResourceId, T][]\n  ): Result<ReadOnlyResourceTreeRoot<T>> {\n    if (Array.isArray(init)) {\n      return ReadOnlyResourceTreeRoot.createResourceTreeInit(init).onSuccess((treeInit) =>\n        captureResult(() => new ReadOnlyResourceTreeRoot(treeInit))\n      );\n    }\n    return captureResult(() => new ReadOnlyResourceTreeRoot(init));\n  }\n\n  /**\n   * Converts an array of resources into tree initialization data.\n   * Validates that resource paths do not conflict - if a path has child resources,\n   * it cannot itself be a resource (e.g., if 'app.messages.welcome' exists, then 'app' cannot be a resource).\n   * @param resources - Array of [ResourceId, resource] pairs to convert\n   * @returns Result containing the initialization structure or failure if validation fails\n   */\n  public static createResourceTreeInit<T>(resources: [ResourceId, T][]): Result<IResourceTreeRootInit<T>> {\n    const errors: MessageAggregator = new MessageAggregator();\n    const root: IResourceTreeRootInit<T> = { children: {} };\n\n    for (const [id, resource] of resources) {\n      Helpers.splitResourceId(id)\n        .onSuccess((pathComponents) => {\n          let currentNode: IResourceTreeBranchInit<T> | IResourceTreeRootInit<T> = root;\n          const resourceName = pathComponents.pop()!;\n\n          for (const nodeName of pathComponents) {\n            if (isResourceTreeRootOrNodeInit(currentNode)) {\n              if (!(nodeName in currentNode.children)) {\n                currentNode.children[nodeName] = { children: {} };\n              }\n              if (isResourceTreeLeafInit(currentNode.children[nodeName])) {\n                errors.addMessage(`${id}: Expected a branch but found a leaf at ${nodeName}.`);\n              } else {\n                currentNode = currentNode.children[nodeName];\n              }\n            } /* c8 ignore next 4 - defense in depth, not reachable without chicanery */ else if (\n              isResourceTreeLeafInit(currentNode)\n            ) {\n              errors.addMessage(`${id}: Expected a branch but found a leaf.`);\n              break;\n            } /* c8 ignore next 3 - defense in depth, not reachable without chicanery */ else {\n              errors.addMessage(`${id}: Unexpected structure in resource tree`);\n            }\n          }\n\n          if (isResourceTreeRootOrNodeInit(currentNode)) {\n            if (resourceName in currentNode.children) {\n              errors.addMessage(`${id}: Duplicate resource at path.`);\n            } else {\n              currentNode.children[resourceName] = { resource };\n            } /* c8 ignore next 3 - defense in depth, not reachable without chicanery */\n          } else {\n            errors.addMessage(`${id}: Expected a branch but found a leaf.`);\n          }\n          return succeed(currentNode.children[resourceName]);\n        })\n        .aggregateError(errors);\n    }\n    return errors.returnOrReport(succeed(root));\n  }\n}\n"]}

package/dist/packlets/runtime/resource-tree/resourceTreeChildren.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceTreeChildren.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/resourceTreeChildren.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Collections, Result, ResultMap, fail, succeed } from '@fgv/ts-utils';\nimport { ResourceId, ResourceName, Helpers } from '../../common';\nimport {\n  IReadOnlyResourceTreeBranch,\n  IReadOnlyResourceTreeChildren,\n  IReadOnlyResourceTreeLeaf,\n  IReadOnlyResourceTreeNode,\n  IReadOnlyValidatingResourceTreeChildren\n} from './common';\nimport { ResourceTreeChildrenValidator } from './resourceTreeChildrenValidator';\n\n/**\n * Implementation of a result-based resource tree that provides hierarchical access to resources.\n * Extends ResultMap to provide collection-like access while adding tree-specific navigation methods.\n * @public\n */\nexport class ReadOnlyResourceTreeChildren<T>\n  extends ResultMap<ResourceName, IReadOnlyResourceTreeNode<T>>\n  implements IReadOnlyValidatingResourceTreeChildren<T>\n{\n  protected path: ResourceId | undefined;\n  public validating: IReadOnlyResourceTreeChildren<T, string, string>;\n\n  /**\n   * Creates a new ReadOnlyResourceTreeChildren instance.\n   * @param path - The path to this tree node (undefined for root)\n   * @param entries - Array of [name, node] tuples to populate the tree\n   */\n  public constructor(path: ResourceId | undefined, entries: [ResourceName, IReadOnlyResourceTreeNode<T>][]) {\n    super(entries);\n    this.path = path;\n    this.validating = new ResourceTreeChildrenValidator<T>(this);\n  }\n\n  public getResource(name: ResourceName): Result<IReadOnlyResourceTreeNode<T>> {\n    return this.get(name).onSuccess((node) => {\n      if (node.isLeaf) {\n        return succeed(node).withDetail<Collections.ResultMapResultDetail>('success');\n      }\n      /* c8 ignore next 3 - functional code tested but coverage intermittently missed */\n      return fail<IReadOnlyResourceTreeNode<T>>(\n        `${name}: not a resource${this.path ? ` in ${this.path}` : ''}.`\n      ).withDetail<Collections.ResultMapResultDetail>('failure');\n    });\n  }\n\n  public getBranch(name: ResourceName): Result<IReadOnlyResourceTreeNode<T>> {\n    return this.get(name).onSuccess((node) => {\n      if (node.isBranch) {\n        return succeed(node).withDetail<Collections.ResultMapResultDetail>('success');\n      }\n      /* c8 ignore next 3 - functional code tested but coverage intermittently missed */\n      return fail<IReadOnlyResourceTreeNode<T>>(\n        `${name}: not a branch${this.path ? ` in ${this.path}` : ''}.`\n      ).withDetail<Collections.ResultMapResultDetail>('failure');\n    });\n  }\n\n  public getById(id: ResourceId): Result<IReadOnlyResourceTreeNode<T>> {\n    return Helpers.splitResourceId(id).onSuccess((names) => {\n      let name = names.shift();\n      if (name !== undefined) {\n        let node = this.get(name).orDefault();\n        while (node) {\n          name = names.shift();\n          if (name === undefined) {\n            return succeed(node);\n          }\n          if (node.isLeaf) {\n            /* c8 ignore next 1 - defense in depth */\n            return fail(`${id}: resource not found${this.path ? ` in ${this.path}` : ''}.`);\n          }\n          node = (node as IReadOnlyResourceTreeBranch<T>).children.get(name).orDefault();\n        }\n      }\n      return fail(`${id}: resource not found${this.path ? ` in ${this.path}` : ''}.`);\n    });\n  }\n\n  public getResourceById(id: ResourceId): Result<IReadOnlyResourceTreeLeaf<T>> {\n    return this.getById(id).onSuccess((node) => {\n      if (node.isLeaf) {\n        return succeed(node as IReadOnlyResourceTreeLeaf<T>).withDetail<Collections.ResultMapResultDetail>(\n          'success'\n        );\n      }\n      return fail<IReadOnlyResourceTreeLeaf<T>>(\n        `${id}: not a resource${this.path ? ` in ${this.path}` : ''}.`\n      ).withDetail<Collections.ResultMapResultDetail>('failure');\n    });\n  }\n\n  public getBranchById(id: ResourceId): Result<IReadOnlyResourceTreeBranch<T>> {\n    return this.getById(id).onSuccess((node) => {\n      if (node.isBranch) {\n        return succeed(node as IReadOnlyResourceTreeBranch<T>).withDetail<Collections.ResultMapResultDetail>(\n          'success'\n        );\n      }\n      /* c8 ignore next 3 - functional code tested but coverage intermittently missed */\n      return fail<IReadOnlyResourceTreeBranch<T>>(\n        `${id}: not a branch${this.path ? ` in ${this.path}` : ''}.`\n      ).withDetail<Collections.ResultMapResultDetail>('failure');\n    });\n  }\n}\n"]}

package/dist/packlets/runtime/resource-tree/resourceTreeChildrenValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceTreeChildrenValidator.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/resourceTreeChildrenValidator.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Validate } from '../../common';\nimport { Result, IReadOnlyResultMap, DetailedResult, Collections, failWithDetail } from '@fgv/ts-utils';\nimport { ResourceName } from '../../common';\nimport {\n  IReadOnlyResourceTreeBranch,\n  IReadOnlyResourceTreeChildren,\n  IReadOnlyResourceTreeLeaf,\n  IReadOnlyResourceTreeNode\n} from './common';\n\n/**\n * A validator wrapper for resource tree children that validates string inputs before\n * delegating to the underlying tree children collection.\n *\n * This class implements {@link Runtime.ResourceTree.IReadOnlyValidatingResourceTreeChildren | IReadOnlyValidatingResourceTreeChildren}\n * by wrapping an {@link Runtime.ResourceTree.IReadOnlyResourceTreeChildren | IReadOnlyResourceTreeChildren} instance and\n * providing string-based access to all tree operations. All string inputs are validated using the library's\n * validation utilities before being passed to the underlying collection.\n *\n * The validator acts as a bridge between string-based external APIs and the\n * strongly-typed internal tree operations, ensuring type safety and consistent\n * error handling throughout the resource tree navigation.\n *\n * @public\n */\nexport class ResourceTreeChildrenValidator<T> implements IReadOnlyResourceTreeChildren<T, string, string> {\n  private readonly _inner: IReadOnlyResourceTreeChildren<T>;\n\n  /**\n   * Creates a new validator wrapper for resource tree children.\n   * @param inner - The underlying resource tree children collection to wrap with validation\n   */\n  public constructor(inner: IReadOnlyResourceTreeChildren<T>) {\n    this._inner = inner;\n  }\n\n  /**\n   * Gets a tree node by its string ResourceId path, validating the input.\n   * @param id - The string ResourceId path to validate and look up\n   * @returns Result containing the node if found, or failure if validation fails or not found\n   */\n  public getById(id: string): Result<IReadOnlyResourceTreeNode<T>> {\n    return Validate.toResourceId(id).onSuccess((resourceId) => {\n      return this._inner.getById(resourceId);\n    });\n  }\n\n  /**\n   * Gets a resource node by its string name (single component), validating the input.\n   * @param name - The string ResourceName to validate and look up\n   * @returns Result containing the node if it's a resource, or failure if validation fails or not found\n   */\n  public getResource(name: string): Result<IReadOnlyResourceTreeNode<T>> {\n    return Validate.toResourceName(name).onSuccess((resourceName) => {\n      return this._inner.getResource(resourceName);\n    });\n  }\n\n  /**\n   * Gets a branch node by its string name (single component), validating the input.\n   * @param name - The string ResourceName to validate and look up\n   * @returns Result containing the node if it's a branch, or failure if validation fails or not found\n   */\n  public getBranch(name: string): Result<IReadOnlyResourceTreeNode<T>> {\n    return Validate.toResourceName(name).onSuccess((resourceName) => {\n      return this._inner.getBranch(resourceName);\n    });\n  }\n\n  /**\n   * Gets a resource leaf node by its string ResourceId path, validating the input.\n   * @param id - The string ResourceId path to validate and look up\n   * @returns Result containing the leaf if found and is a resource, or failure otherwise\n   */\n  public getResourceById(id: string): Result<IReadOnlyResourceTreeLeaf<T>> {\n    return Validate.toResourceId(id).onSuccess((resourceId) => {\n      return this._inner.getResourceById(resourceId);\n    });\n  }\n\n  /**\n   * Gets a branch node by its string ResourceId path, validating the input.\n   * @param id - The string ResourceId path to validate and look up\n   * @returns Result containing the branch if found and has children, or failure otherwise\n   */\n  public getBranchById(id: string): Result<IReadOnlyResourceTreeBranch<T>> {\n    return Validate.toResourceId(id).onSuccess((resourceId) => {\n      return this._inner.getBranchById(resourceId);\n    });\n  }\n\n  /**\n   * The number of direct child nodes in this collection.\n   */\n  public get size(): number {\n    return this._inner.size;\n  }\n\n  /**\n   * Returns an iterator of [ResourceName, node] pairs for all child nodes.\n   * @returns Map iterator for all child nodes\n   */\n  public entries(): IterableIterator<[ResourceName, IReadOnlyResourceTreeNode<T>]> {\n    return this._inner.entries();\n  }\n\n  /**\n   * Executes a callback function for each child node in the collection.\n   * @param cb - The callback function to execute for each child node\n   * @param arg - Optional argument to pass to the callback\n   */\n  public forEach(\n    cb: (value: unknown, key: string, map: IReadOnlyResultMap<string, unknown>, thisArg?: unknown) => void,\n    arg?: unknown\n  ): void {\n    for (const [key, value] of this._inner.entries()) {\n      cb(value, key as ResourceName, this, arg);\n    }\n  }\n\n  /**\n   * Gets a child node by its string key with detailed error information.\n   * @param key - The string key to look up\n   * @returns DetailedResult containing the node if found, or failure with details\n   */\n  public get(key: string): DetailedResult<IReadOnlyResourceTreeNode<T>, Collections.ResultMapResultDetail> {\n    if (Validate.isValidResourceName(key)) {\n      return this._inner.get(key);\n    }\n    return failWithDetail(`${key}: invalid resource name.`, 'invalid-key');\n  }\n\n  /**\n   * Checks if a child node exists at the given string key.\n   * @param key - The string key to check\n   * @returns True if a child node exists at the key, false otherwise\n   */\n  public has(key: string): boolean {\n    return this._inner.has(key as ResourceName);\n  }\n\n  /**\n   * Returns an iterator of ResourceName keys for all child nodes.\n   * @returns Map iterator for all child node keys\n   */\n  public keys(): IterableIterator<ResourceName> {\n    return this._inner.keys();\n  }\n\n  /**\n   * Returns an iterator of child node values.\n   * @returns Map iterator for all child node values\n   */\n  public values(): IterableIterator<IReadOnlyResourceTreeNode<T>> {\n    return this._inner.values();\n  }\n\n  /**\n   * Returns an iterator for [ResourceName, node] pairs, enabling for...of iteration.\n   * @returns Iterable iterator for all child nodes\n   */\n  public [Symbol.iterator](): IterableIterator<[ResourceName, IReadOnlyResourceTreeNode<T>]> {\n    return this._inner[Symbol.iterator]();\n  }\n}\n"]}

package/dist/packlets/runtime/resourceResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceResolver.js","sourceRoot":"","sources":["../../../src/packlets/runtime/resourceResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAU,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAyB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAqB,OAAO,EAAc,MAAM,WAAW,CAAC;AAInE,OAAO,EAA6B,wCAAwC,EAAE,MAAM,WAAW,CAAC;AAEhG,OAAO,EAEL,4BAA4B,EAE7B,MAAM,gCAAgC,CAAC;AA8DxC;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAqB3B;;OAEG;IACH,IAAW,UAAU;QACnB,OAAO,IAAI,CAAC,wBAAwB,CAAC,UAAU,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,IAAW,cAAc;QACvB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAW,iBAAiB;QAC1B,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,IAAW,aAAa;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAyBD;;;OAGG;IACH,YAAsB,MAAqC;;QACzD,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAC5C,IAAI,CAAC,wBAAwB,GAAG,MAAM,CAAC,wBAAwB,CAAC;QAChE,IAAI,CAAC,OAAO,GAAG;YACb,oBAAoB,EAAE,MAAA,MAAA,MAAM,CAAC,OAAO,0CAAE,oBAAoB,mCAAI,KAAK;SACpE,CAAC;QAEF,8EAA8E;QAC9E,MAAM,sBAAsB,GAAG,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC;QACpE,IAAI,CAAC,eAAe,GAAG,IAAI,KAAK,CAAoC,sBAAsB,CAAC,CAAC;QAE5F,sFAAsF;QACtF,MAAM,yBAAyB,GAAG,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC;QAC1E,IAAI,CAAC,kBAAkB,GAAG,IAAI,KAAK,CAA2C,yBAAyB,CAAC,CAAC;QAEzG,4EAA4E;QAC5E,MAAM,qBAAqB,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC;QAClE,IAAI,CAAC,cAAc,GAAG,IAAI,KAAK,CAAuC,qBAAqB,CAAC,CAAC;QAE7F,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAAC,MAAqC;QACxD,OAAO,aAAa,CAAC,GAAG,EAAE,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;OAOG;IACI,gBAAgB,CAAC,SAAoB;;QAC1C,6CAA6C;QAC7C,MAAM,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC;QACvC,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,cAAc,SAAS,CAAC,GAAG,+BAA+B,CAAC,CAAC;QAC1E,CAAC;QAED,oCAAoC;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;QAC1D,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAA,IAAI,CAAC,SAAS,0CAAE,UAAU,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;YACxD,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC;QAC/B,CAAC;QAED,sFAAsF;QACtF,MAAM,KAAK,GAAG,IAAI,CAAC,wBAAwB;aACxC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC;aACxB,SAAS,CAAC,CAAC,cAAc,EAAE,EAAE;YAC5B,mEAAmE;YACnE,OAAO,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxG,CAAC,CAAC;aACD,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;;YACjB,MAAA,IAAI,CAAC,SAAS,0CAAE,cAAc,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC,CAAC;aACD,SAAS,CAAC,OAAO,CAAC,CAAC;QAEtB,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QACpC,MAAM,cAAc,GAAG,MAAA,SAAS,CAAC,cAAc,mCAAI,OAAO,CAAC;QAC3D,MAAM,WAAW,GACf,KAAK,GAAG,OAAO;YACb,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE;YACzC,CAAC,CAAC,cAAc,GAAG,OAAO;gBAC1B,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE;gBAClE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QAEzD,kDAAkD;QAClD,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,GAAG,WAAW,CAAC;QACnD,MAAA,IAAI,CAAC,SAAS,0CAAE,WAAW,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QAEzD,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;OAOG;IACI,mBAAmB,CAAC,YAA0B;;QACnD,iDAAiD;QACjD,MAAM,iBAAiB,GAAG,YAAY,CAAC,KAAK,CAAC;QAC7C,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,iBAAiB,YAAY,CAAC,GAAG,+BAA+B,CAAC,CAAC;QAChF,CAAC;QAED,oCAAoC;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;QAChE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAA,IAAI,CAAC,SAAS,0CAAE,UAAU,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;YAC9D,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC;QAC/B,CAAC;QAED,8CAA8C;QAC9C,MAAM,UAAU,GAAiC,EAAE,CAAC;QACpD,IAAI,SAAS,GAAuB,OAAO,CAAC;QAE5C,KAAK,MAAM,SAAS,IAAI,YAAY,CAAC,UAAU,EAAE,CAAC;YAChD,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAE/F,4GAA4G;YAC5G,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBACnC,MAAA,IAAI,CAAC,SAAS,0CAAE,YAAY,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;gBAChE,OAAO,IAAI,CAAC,gCAAgC,SAAS,CAAC,GAAG,MAAM,gBAAgB,EAAE,CAAC,CAAC;YACrF,CAAC;YAED,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAEjC,IAAI,eAAe,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5C,2BAA2B;gBAC3B,OAAO,4BAA4B,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC;qBAC9D,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;;oBACpB,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAAC;oBACpD,MAAA,IAAI,CAAC,SAAS,0CAAE,WAAW,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;oBAC/D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;gBACzB,CAAC,CAAC;qBACD,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;;oBACjB,4GAA4G;oBAC5G,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAAC;oBACvD,MAAA,IAAI,CAAC,SAAS,0CAAE,YAAY,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;oBAChE,OAAO,IAAI,CAAC,GAAG,iBAAiB,qDAAqD,GAAG,EAAE,CAAC,CAAC;gBAC9F,CAAC,CAAC,CAAC;YACP,CAAC;YAED,kFAAkF;YAClF,IAAI,eAAe,CAAC,SAAS,KAAK,gBAAgB,EAAE,CAAC;gBACnD,SAAS,GAAG,gBAAgB,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,OAAO,4BAA4B,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC;aAC9D,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;;YACpB,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAAC;YACpD,MAAA,IAAI,CAAC,SAAS,0CAAE,WAAW,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;YAC/D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC;aACD,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;;YACjB,4GAA4G;YAC5G,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAAC;YACvD,MAAA,IAAI,CAAC,SAAS,0CAAE,YAAY,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;YAChE,OAAO,IAAI,CAAC,GAAG,iBAAiB,qDAAqD,GAAG,EAAE,CAAC,CAAC;QAC9F,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;OAOG;IACI,eAAe,CAAC,QAA0B;;QAC/C,4CAA4C;QAC5C,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC;QACrC,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,aAAa,QAAQ,CAAC,GAAG,+BAA+B,CAAC,CAAC;QACxE,CAAC;QAED,oCAAoC;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QACxD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAA,IAAI,CAAC,SAAS,0CAAE,UAAU,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YACtD,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC;QAC/B,CAAC;QAED,6CAA6C;QAC7C,MAAM,uBAAuB,GAAmE,EAAE,CAAC;QACnG,MAAM,8BAA8B,GAAmE,EAAE,CAAC;QAE1G,KAAK,IAAI,aAAa,GAAG,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,CAAC;YACxF,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YACrD,MAAM,kBAAkB,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAE5E,2CAA2C;YAC3C,IAAI,kBAAkB,CAAC,SAAS,EAAE,EAAE,CAAC;gBACnC,MAAA,IAAI,CAAC,SAAS,0CAAE,YAAY,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;gBACxD,OAAO,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,uCAAuC,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC;YAClG,CAAC;YAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,CAAC;YAE5C,yCAAyC;YACzC,IAAI,UAAU,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;gBACrC,uBAAuB,CAAC,IAAI,CAAC;oBAC3B,KAAK,EAAE,aAAa;oBACpB,MAAM,EAAE,UAAU;iBACnB,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,UAAU,CAAC,SAAS,KAAK,gBAAgB,EAAE,CAAC;gBACrD,8BAA8B,CAAC,IAAI,CAAC;oBAClC,KAAK,EAAE,aAAa;oBACpB,MAAM,EAAE,UAAU;iBACnB,CAAC,CAAC;YACL,CAAC;YACD,2FAA2F;QAC7F,CAAC;QAED,8EAA8E;QAC9E,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACjG,8BAA8B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAExG,sDAAsD;QACtD,MAAM,eAAe,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1E,MAAM,sBAAsB,GAAG,8BAA8B,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAExF,8BAA8B;QAC9B,MAAM,aAAa,GAA6B;YAC9C,OAAO,EAAE,IAAI;YACb,eAAe;YACf,sBAAsB;SACvB,CAAC;QACF,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;QACnD,MAAA,IAAI,CAAC,SAAS,0CAAE,WAAW,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAEvD,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;IAqBM,eAAe,CAAC,YAAgC;QACrD,sGAAsG;QACtG,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,eAAe;iBACxB,gBAAgB,CAAC,YAAY,CAAC;iBAC9B,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY,CAAC;QAE9B,kEAAkE;QAClE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC;QAExD,kEAAkE;QAClE,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;QAC9D,kEAAkE;QAClE,IAAI,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,4CAA4C,QAAQ,CAAC,EAAE,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;QACrG,CAAC;QAED,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC;QAExC,uDAAuD;QACvD,IACE,CAAC,UAAU,CAAC,OAAO;YACnB,CAAC,UAAU,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,sBAAsB,CAAC,MAAM,KAAK,CAAC,CAAC,EAC3F,CAAC;YACD,OAAO,IAAI,CAAC,8CAA8C,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5E,CAAC;QAED,8CAA8C;QAC9C,MAAM,cAAc,GAClB,UAAU,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;YACnC,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,qBAAqB;YACrD,CAAC,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB;QAEjE,IAAI,cAAc,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC,2BAA2B,cAAc,kBAAkB,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QAC1D,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,CAAC;IAqBM,4BAA4B,CACjC,YAAgC;QAEhC,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,eAAe;iBACxB,gBAAgB,CAAC,YAAY,CAAC;iBAC9B,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY,CAAC;QAE9B,kEAAkE;QAClE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC;QAExD,kEAAkE;QAClE,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;QAC9D,kEAAkE;QAClE,IAAI,cAAc,CAAC,SAAS,EAAE,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,4CAA4C,QAAQ,CAAC,EAAE,MAAM,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;QACrG,CAAC;QAED,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC;QAExC,uDAAuD;QACvD,IACE,CAAC,UAAU,CAAC,OAAO;YACnB,CAAC,UAAU,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,sBAAsB,CAAC,MAAM,KAAK,CAAC,CAAC,EAC3F,CAAC;YACD,OAAO,IAAI,CAAC,8CAA8C,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;QAC5E,CAAC;QAED,2EAA2E;QAC3E,MAAM,UAAU,GAAyB,EAAE,CAAC;QAE5C,6DAA6D;QAC7D,KAAK,MAAM,cAAc,IAAI,UAAU,CAAC,eAAe,EAAE,CAAC;YACxD,IAAI,cAAc,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;gBACjD,OAAO,IAAI,CAAC,2BAA2B,cAAc,kBAAkB,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;YACzF,CAAC;YACD,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;YACtD,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;QAED,6EAA6E;QAC7E,KAAK,MAAM,cAAc,IAAI,UAAU,CAAC,sBAAsB,EAAE,CAAC;YAC/D,2DAA2D;YAC3D,IAAI,cAAc,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;gBACjD,OAAO,IAAI,CAAC,2BAA2B,cAAc,kBAAkB,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;YACzF,CAAC;YACD,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;YACtD,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC;IAuBM,4BAA4B,CAAC,YAAgC;QAClE,sGAAsG;QACtG,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,eAAe;iBACxB,gBAAgB,CAAC,YAAY,CAAC;iBAC9B,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY,CAAC;QAE9B,OAAO,IAAI,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE;YAC1E,4DAA4D;YAC5D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC,GAAG,QAAQ,CAAC,EAAE,iCAAiC,CAAC,CAAC;YAC/D,CAAC;YAED,4EAA4E;YAC5E,IAAI,kBAAkB,GAAG,CAAC,CAAC,CAAC;YAC5B,MAAM,iBAAiB,GAAyB,EAAE,CAAC;YAEnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;gBAChC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;oBACzB,iCAAiC;oBACjC,kBAAkB,GAAG,CAAC,CAAC;oBACvB,MAAM;gBACR,CAAC;qBAAM,CAAC;oBACN,qEAAqE;oBACrE,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC;YAED,iEAAiE;YACjE,MAAM,kBAAkB,GAAG,kBAAkB,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;YAChG,MAAM,aAAa,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;YAErD,8EAA8E;YAC9E,mFAAmF;YACnF,IAAI,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnC,IAAI,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC3E,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBACrC,CAAC;gBAED,sEAAsE;gBACtE,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;oBAC/B,KAAK,EAAE;wBACL,kBAAkB,EAAE,SAAS;wBAC7B,YAAY,EAAE,IAAI;qBACnB;iBACF,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,uCAAuC;gBAErD,OAAO,MAAM;qBACV,mBAAmB,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;qBAC7C,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,yBAAyB,GAAG,EAAE,CAAC,CAAC;YAC5E,CAAC;YAED,MAAM,aAAa,GAAG;gBACpB,aAAa,CAAC,IAAI;gBAClB,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC;aACxD,CAAC,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YAElD,yHAAyH;YACzH,IAAI,aAAa,CAAC,MAAM,KAAK,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1D,OAAO,IAAI,CAAC,GAAG,QAAQ,CAAC,EAAE,kDAAkD,CAAC,CAAC;YAChF,CAAC;YAED,gGAAgG;YAChG,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;gBAC/B,KAAK,EAAE;oBACL,kBAAkB,EAAE,SAAS;oBAC7B,YAAY,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB;iBACjD;aACF,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,uCAAuC;YAErD,OAAO,MAAM;iBACV,mBAAmB,CAAC,EAAE,EAAE,aAAa,CAAC;iBACtC,eAAe,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,yBAAyB,GAAG,EAAE,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,OAA+B;QAChD,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAC1D,OAAO,wCAAwC,CAAC,MAAM,CAAC;YACrD,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,eAAe,EAAE,OAAO;SACzB,CAAC,CAAC,SAAS,CAAC,CAAC,wBAAwB,EAAE,EAAE;YACxC,OAAO,gBAAgB,CAAC,MAAM,CAAC;gBAC7B,eAAe;gBACf,cAAc;gBACd,OAAO;gBACP,wBAAwB;aACzB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACI,mBAAmB;;QACxB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEpC,MAAA,IAAI,CAAC,SAAS,0CAAE,YAAY,CAAC,WAAW,CAAC,CAAC;QAC1C,MAAA,IAAI,CAAC,SAAS,0CAAE,YAAY,CAAC,cAAc,CAAC,CAAC;QAC7C,MAAA,IAAI,CAAC,SAAS,0CAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,IAAW,kBAAkB;QAC3B,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,IAAW,qBAAqB;QAC9B,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACH,IAAW,iBAAiB;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;IACpC,CAAC;CACF","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, captureResult, fail, succeed } from '@fgv/ts-utils';\nimport { JsonValue, JsonObject, isJsonObject } from '@fgv/ts-json-base';\nimport { JsonEditor } from '@fgv/ts-json';\nimport { IResourceResolver, NoMatch, ResourceId } from '../common';\nimport { Condition, ConditionSet } from '../conditions';\nimport { AbstractDecision } from '../decisions';\nimport { ReadOnlyQualifierTypeCollector } from '../qualifier-types';\nimport { IContextQualifierProvider, ValidatingSimpleContextQualifierProvider } from './context';\nimport { IResourceManager, IResource, IResourceCandidate } from './iResourceManager';\nimport {\n  ConditionMatchType,\n  ConditionSetResolutionResult,\n  IConditionMatchResult\n} from './conditionSetResolutionResult';\nimport { IResourceResolverCacheListener } from './cacheListener';\nimport { IReadOnlyQualifierCollector } from '../qualifiers';\n\n/**\n * Represents the cached result of resolving a decision.\n * Contains either a failure indicator or a list of instance indices for matching condition sets,\n * ordered by condition set priority.\n * @public\n */\nexport type DecisionResolutionResult =\n  | { success: false }\n  | { success: true; instanceIndices: ReadonlyArray<number>; defaultInstanceIndices: ReadonlyArray<number> };\n\n/**\n * Options for configuring a {@link Runtime.ResourceResolver | ResourceResolver}.\n * @public\n */\nexport interface IResourceResolverOptions {\n  /**\n   * Controls whether null values in resource composition should suppress properties\n   * instead of setting them to null. When true, properties with null values from\n   * higher-priority partial candidates will be omitted from the final composed resource.\n   * @defaultValue false\n   */\n  suppressNullAsDelete?: boolean;\n}\n\n/**\n * Parameters for creating a {@link Runtime.ResourceResolver | ResourceResolver}.\n * @public\n */\nexport interface IResourceResolverCreateParams {\n  /**\n   * The {@link Runtime.IResourceManager | resource manager} that defines the resources available\n   * and provides access to qualifiers and conditions.\n   */\n  resourceManager: IResourceManager;\n\n  /**\n   * The {@link QualifierTypes.ReadOnlyQualifierTypeCollector | readonly qualifier type collector}\n   * that provides qualifier implementations for condition evaluation.\n   */\n  qualifierTypes: ReadOnlyQualifierTypeCollector;\n\n  /**\n   * The {@link Runtime.Context.IContextQualifierProvider | context qualifier provider} that resolves\n   * qualifier values for the current context.\n   */\n  contextQualifierProvider: IContextQualifierProvider;\n\n  /**\n   * An optional listener for {@link Runtime.ResourceResolver | ResourceResolver} cache activity.\n   */\n  listener?: IResourceResolverCacheListener;\n\n  /**\n   * Optional configuration options for the {@link Runtime.ResourceResolver | ResourceResolver}.\n   */\n  options?: IResourceResolverOptions;\n}\n\n/**\n * High-performance runtime resource resolver with O(1) condition caching.\n * Resolves resources for a given context by evaluating conditions against qualifier values\n * and caching results for optimal performance.\n * @public\n */\nexport class ResourceResolver implements IResourceResolver {\n  /**\n   * The resource manager that defines available resources and provides condition access.\n   */\n  public readonly resourceManager: IResourceManager;\n\n  /**\n   * The readonly qualifier type collector that provides qualifier implementations.\n   */\n  public readonly qualifierTypes: ReadOnlyQualifierTypeCollector;\n\n  /**\n   * The context qualifier provider that resolves qualifier values.\n   */\n  public readonly contextQualifierProvider: IContextQualifierProvider;\n\n  /**\n   * The configuration options for this resource resolver.\n   */\n  public readonly options: IResourceResolverOptions;\n\n  /**\n   * The readonly qualifier collector that provides qualifier implementations.\n   */\n  public get qualifiers(): IReadOnlyQualifierCollector {\n    return this.contextQualifierProvider.qualifiers;\n  }\n\n  /**\n   * The resource IDs that this resolver can resolve.\n   */\n  public get resourceIds(): ReadonlyArray<ResourceId> {\n    return this.resourceManager.resourceIds;\n  }\n\n  /**\n   * The cache array for resolved conditions, indexed by condition index for O(1) lookup.\n   * Each entry stores the resolved {@link Runtime.IConditionMatchResult | condition match result} for\n   * the corresponding condition.\n   */\n  public get conditionCache(): ReadonlyArray<IConditionMatchResult | undefined> {\n    return this._conditionCache;\n  }\n\n  /**\n   * The cache array for resolved condition sets, indexed by condition set index for O(1) lookup.\n   * Each entry stores the resolved ConditionSetResolutionResult for the corresponding condition set.\n   */\n  public get conditionSetCache(): ReadonlyArray<ConditionSetResolutionResult | undefined> {\n    return this._conditionSetCache;\n  }\n\n  /**\n   * The cache array for resolved decisions, indexed by decision index for O(1) lookup.\n   * Each entry stores the resolved DecisionResolutionResult for the corresponding decision.\n   */\n  public get decisionCache(): ReadonlyArray<DecisionResolutionResult | undefined> {\n    return this._decisionCache;\n  }\n\n  /**\n   * Cache array for resolved conditions, indexed by condition index for O(1) lookup.\n   * Each entry stores the resolved QualifierMatchScore for the corresponding condition.\n   */\n  private readonly _conditionCache: Array<IConditionMatchResult | undefined>;\n\n  /**\n   * Cache array for resolved condition sets, indexed by condition set index for O(1) lookup.\n   * Each entry stores the resolved ConditionSetResolutionResult for the corresponding condition set.\n   */\n  private readonly _conditionSetCache: Array<ConditionSetResolutionResult | undefined>;\n\n  /**\n   * Cache array for resolved decisions, indexed by decision index for O(1) lookup.\n   * Each entry stores the resolved DecisionResolutionResult for the corresponding decision.\n   */\n  private readonly _decisionCache: Array<DecisionResolutionResult | undefined>;\n\n  /**\n   * The listener for {@link Runtime.ResourceResolver | ResourceResolver} cache activity.\n   */\n  private readonly _listener?: IResourceResolverCacheListener;\n\n  /**\n   * Constructor for a {@link Runtime.ResourceResolver | ResourceResolver} object.\n   * @param params - {@link Runtime.IResourceResolverCreateParams | Parameters} used to create the resolver.\n   */\n  protected constructor(params: IResourceResolverCreateParams) {\n    this.resourceManager = params.resourceManager;\n    this.qualifierTypes = params.qualifierTypes;\n    this.contextQualifierProvider = params.contextQualifierProvider;\n    this.options = {\n      suppressNullAsDelete: params.options?.suppressNullAsDelete ?? false\n    };\n\n    // Initialize condition cache array with size matching the condition collector\n    const conditionCollectorSize = this.resourceManager.conditions.size;\n    this._conditionCache = new Array<IConditionMatchResult | undefined>(conditionCollectorSize);\n\n    // Initialize condition set cache array with size matching the condition set collector\n    const conditionSetCollectorSize = this.resourceManager.conditionSets.size;\n    this._conditionSetCache = new Array<ConditionSetResolutionResult | undefined>(conditionSetCollectorSize);\n\n    // Initialize decision cache array with size matching the decision collector\n    const decisionCollectorSize = this.resourceManager.decisions.size;\n    this._decisionCache = new Array<DecisionResolutionResult | undefined>(decisionCollectorSize);\n\n    this._listener = params.listener;\n  }\n\n  /**\n   * Creates a new {@link Runtime.ResourceResolver | ResourceResolver} object.\n   * @param params - {@link Runtime.IResourceResolverCreateParams | Parameters} used to create the resolver.\n   * @returns `Success` with the new {@link Runtime.ResourceResolver | ResourceResolver} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(params: IResourceResolverCreateParams): Result<ResourceResolver> {\n    return captureResult(() => new ResourceResolver(params));\n  }\n\n  /**\n   * Resolves a condition by evaluating it against the current context.\n   * Uses O(1) caching based on the condition's globally unique sequential index.\n   * @param condition - The {@link Conditions.Condition | condition} to resolve.\n   * @returns `Success` with the {@link QualifierMatchScore | match score} if successful,\n   * or `Failure` with an error message if the condition cannot be resolved.\n   * @public\n   */\n  public resolveCondition(condition: Condition): Result<IConditionMatchResult> {\n    // Get the condition's index for cache lookup\n    const conditionIndex = condition.index;\n    if (conditionIndex === undefined) {\n      return fail(`Condition \"${condition.key}\" does not have a valid index`);\n    }\n\n    // Check cache first for O(1) lookup\n    const cachedResult = this._conditionCache[conditionIndex];\n    if (cachedResult !== undefined) {\n      this._listener?.onCacheHit('condition', conditionIndex);\n      return succeed(cachedResult);\n    }\n\n    // Resolve the condition by getting qualifier value and evaluating with qualifier type\n    const score = this.contextQualifierProvider\n      .get(condition.qualifier)\n      .onSuccess((qualifierValue) => {\n        // Evaluate the condition using the qualifier type's matching logic\n        return succeed(condition.qualifier.type.matches(condition.value, qualifierValue, condition.operator));\n      })\n      .onFailure((err) => {\n        this._listener?.onContextError(condition.qualifier.name, err);\n        return fail(err);\n      })\n      .orDefault(NoMatch);\n\n    const priority = condition.priority;\n    const scoreAsDefault = condition.scoreAsDefault ?? NoMatch;\n    const matchResult: IConditionMatchResult =\n      score > NoMatch\n        ? { score, priority, matchType: 'match' }\n        : scoreAsDefault > NoMatch\n        ? { score: scoreAsDefault, priority, matchType: 'matchAsDefault' }\n        : { score: NoMatch, priority, matchType: 'noMatch' };\n\n    // Cache the resolved value for future O(1) lookup\n    this._conditionCache[conditionIndex] = matchResult;\n    this._listener?.onCacheMiss('condition', conditionIndex);\n\n    return succeed(matchResult);\n  }\n\n  /**\n   * Resolves a condition set by evaluating all its constituent conditions against the current context.\n   * Uses O(1) caching based on the condition set's globally unique sequential index.\n   * @param conditionSet - The {@link Conditions.ConditionSet | condition set} to resolve.\n   * @returns `Success` with the {@link Runtime.ConditionSetResolutionResult | resolution result} if successful,\n   * or `Failure` with an error message if the condition set cannot be resolved.\n   * @public\n   */\n  public resolveConditionSet(conditionSet: ConditionSet): Result<ConditionSetResolutionResult> {\n    // Get the condition set's index for cache lookup\n    const conditionSetIndex = conditionSet.index;\n    if (conditionSetIndex === undefined) {\n      return fail(`ConditionSet \"${conditionSet.key}\" does not have a valid index`);\n    }\n\n    // Check cache first for O(1) lookup\n    const cachedResult = this._conditionSetCache[conditionSetIndex];\n    if (cachedResult !== undefined) {\n      this._listener?.onCacheHit('conditionSet', conditionSetIndex);\n      return succeed(cachedResult);\n    }\n\n    // Resolve all conditions in the condition set\n    const conditions: Array<IConditionMatchResult> = [];\n    let matchType: ConditionMatchType = 'match';\n\n    for (const condition of conditionSet.conditions) {\n      const { value: conditionResult, message: conditionMessage } = this.resolveCondition(condition);\n\n      /* c8 ignore next 4 - defensive coding: extreme internal error scenario not reachable in normal operation */\n      if (conditionMessage !== undefined) {\n        this._listener?.onCacheError('conditionSet', conditionSetIndex);\n        return fail(`Failed to resolve condition \"${condition.key}\": ${conditionMessage}`);\n      }\n\n      conditions.push(conditionResult);\n\n      if (conditionResult.matchType === 'noMatch') {\n        // Cache the failure result\n        return ConditionSetResolutionResult.create('noMatch', conditions)\n          .onSuccess((result) => {\n            this._conditionSetCache[conditionSetIndex] = result;\n            this._listener?.onCacheMiss('conditionSet', conditionSetIndex);\n            return succeed(result);\n          })\n          .onFailure((err) => {\n            /* c8 ignore next 4 - defensive coding: extreme internal error scenario not reachable in normal operation */\n            this._conditionSetCache[conditionSetIndex] = undefined;\n            this._listener?.onCacheError('conditionSet', conditionSetIndex);\n            return fail(`${conditionSetIndex}: error creating condition set resolution result: ${err}`);\n          });\n      }\n\n      /* c8 ignore next 3 - edge case: matchAsDefault fallback logic rarely triggered */\n      if (conditionResult.matchType === 'matchAsDefault') {\n        matchType = 'matchAsDefault';\n      }\n    }\n\n    // Cache the successful result\n    return ConditionSetResolutionResult.create(matchType, conditions)\n      .onSuccess((result) => {\n        this._conditionSetCache[conditionSetIndex] = result;\n        this._listener?.onCacheMiss('conditionSet', conditionSetIndex);\n        return succeed(result);\n      })\n      .onFailure((err) => {\n        /* c8 ignore next 4 - defensive coding: extreme internal error scenario not reachable in normal operation */\n        this._conditionSetCache[conditionSetIndex] = undefined;\n        this._listener?.onCacheError('conditionSet', conditionSetIndex);\n        return fail(`${conditionSetIndex}: error creating condition set resolution result: ${err}`);\n      });\n  }\n\n  /**\n   * Resolves a decision by evaluating all its constituent condition sets against the current context.\n   * Uses O(1) caching based on the decision's globally unique sequential index.\n   * @param decision - The {@link Decisions.AbstractDecision | abstract decision} to resolve.\n   * @returns `Success` with the {@link Runtime.DecisionResolutionResult | resolution result} if successful,\n   * or `Failure` with an error message if the decision cannot be resolved.\n   * @public\n   */\n  public resolveDecision(decision: AbstractDecision): Result<DecisionResolutionResult> {\n    // Get the decision's index for cache lookup\n    const decisionIndex = decision.index;\n    if (decisionIndex === undefined) {\n      return fail(`Decision \"${decision.key}\" does not have a valid index`);\n    }\n\n    // Check cache first for O(1) lookup\n    const cachedResult = this._decisionCache[decisionIndex];\n    if (cachedResult !== undefined) {\n      this._listener?.onCacheHit('decision', decisionIndex);\n      return succeed(cachedResult);\n    }\n\n    // Resolve all condition sets in the decision\n    const matchingInstanceResults: Array<{ index: number; result: ConditionSetResolutionResult }> = [];\n    const matchingDefaultInstanceResults: Array<{ index: number; result: ConditionSetResolutionResult }> = [];\n\n    for (let instanceIndex = 0; instanceIndex < decision.candidates.length; instanceIndex++) {\n      const candidate = decision.candidates[instanceIndex];\n      const conditionSetResult = this.resolveConditionSet(candidate.conditionSet);\n\n      /* c8 ignore next 4 - defensive in depth */\n      if (conditionSetResult.isFailure()) {\n        this._listener?.onCacheError('decision', decisionIndex);\n        return fail(`${decision.key}: Failed to resolve condition set\": ${conditionSetResult.message}`);\n      }\n\n      const resolution = conditionSetResult.value;\n\n      // Only include condition sets that match\n      if (resolution.matchType === 'match') {\n        matchingInstanceResults.push({\n          index: instanceIndex,\n          result: resolution\n        });\n      } else if (resolution.matchType === 'matchAsDefault') {\n        matchingDefaultInstanceResults.push({\n          index: instanceIndex,\n          result: resolution\n        });\n      }\n      // If condition set doesn't match, we simply skip it and continue (don't fail the decision)\n    }\n\n    // Sort by condition set resolution priority using the proper comparison logic\n    matchingInstanceResults.sort((a, b) => ConditionSetResolutionResult.compare(a.result, b.result));\n    matchingDefaultInstanceResults.sort((a, b) => ConditionSetResolutionResult.compare(a.result, b.result));\n\n    // Extract just the instance indices in priority order\n    const instanceIndices = matchingInstanceResults.map((item) => item.index);\n    const defaultInstanceIndices = matchingDefaultInstanceResults.map((item) => item.index);\n\n    // Cache the successful result\n    const successResult: DecisionResolutionResult = {\n      success: true,\n      instanceIndices,\n      defaultInstanceIndices\n    };\n    this._decisionCache[decisionIndex] = successResult;\n    this._listener?.onCacheMiss('decision', decisionIndex);\n\n    return succeed(successResult);\n  }\n\n  /**\n   * Resolves a resource by finding the best matching candidate.\n   * Uses the resource's associated decision to determine the best match based on the current context.\n   * @param resource - The {@link Resources.Resource | resource} to resolve.\n   * @returns `Success` with the best matching candidate if successful,\n   * or `Failure` with an error message if no candidates match or resolution fails.\n   * @public\n   */\n  public resolveResource(resource: IResource): Result<IResourceCandidate>;\n\n  /**\n   * Resolves a resource by finding the best matching candidate.\n   * Uses the resource's associated decision to determine the best match based on the current context.\n   * @param resource - The string id of the resource to resolve.\n   * @returns `Success` with the best matching candidate if successful,\n   * or `Failure` with an error message if no candidates match or resolution fails.\n   * @public\n   */\n  public resolveResource(resource: string): Result<IResourceCandidate>;\n  public resolveResource(idOrResource: string | IResource): Result<IResourceCandidate> {\n    /* c8 ignore next 4 - defensive coding: string resource resolution should use direct resource calls */\n    if (typeof idOrResource === 'string') {\n      return this.resourceManager\n        .getBuiltResource(idOrResource)\n        .onSuccess((resource) => this.resolveResource(resource));\n    }\n\n    const resource = idOrResource;\n\n    // Get the abstract decision from the resource's concrete decision\n    const abstractDecision = resource.decision.baseDecision;\n\n    // Resolve the decision to get candidate indices in priority order\n    const decisionResult = this.resolveDecision(abstractDecision);\n    /* c8 ignore next 3 - defense in depth almost impossible to hit */\n    if (decisionResult.isFailure()) {\n      return fail(`Failed to resolve decision for resource \"${resource.id}\": ${decisionResult.message}`);\n    }\n\n    const resolution = decisionResult.value;\n\n    // Check if any candidates matched (regular or default)\n    if (\n      !resolution.success ||\n      (resolution.instanceIndices.length === 0 && resolution.defaultInstanceIndices.length === 0)\n    ) {\n      return fail(`No matching candidates found for resource \"${resource.id}\"`);\n    }\n\n    // Prefer regular matches over default matches\n    const candidateIndex =\n      resolution.instanceIndices.length > 0\n        ? resolution.instanceIndices[0] // Best regular match\n        : resolution.defaultInstanceIndices[0]; // Best default match\n\n    if (candidateIndex >= resource.candidates.length) {\n      return fail(`Invalid candidate index ${candidateIndex} for resource \"${resource.id}\"`);\n    }\n\n    const bestCandidate = resource.candidates[candidateIndex];\n    return succeed(bestCandidate);\n  }\n\n  /**\n   * Resolves all matching resource candidates in priority order.\n   * Uses the resource's associated decision to determine all matching candidates based on the current context.\n   * @param resource - The {@link Resources.Resource | resource} to resolve.\n   * @returns `Success` with an array of all matching candidates in priority order if successful,\n   * or `Failure` with an error message if no candidates match or resolution fails.\n   * @public\n   */\n  public resolveAllResourceCandidates(resource: IResource): Result<ReadonlyArray<IResourceCandidate>>;\n\n  /**\n   * Resolves all matching resource candidates in priority order.\n   * Uses the resource's associated decision to determine all matching candidates based on the current context.\n   * @param resource - The string id of the resource to resolve.\n   * @returns `Success` with an array of all matching candidates in priority order if successful,\n   * or `Failure` with an error message if no candidates match or resolution fails.\n   * @public\n   */\n  public resolveAllResourceCandidates(resource: string): Result<ReadonlyArray<IResourceCandidate>>;\n  public resolveAllResourceCandidates(\n    idOrResource: string | IResource\n  ): Result<ReadonlyArray<IResourceCandidate>> {\n    if (typeof idOrResource === 'string') {\n      return this.resourceManager\n        .getBuiltResource(idOrResource)\n        .onSuccess((resource) => this.resolveAllResourceCandidates(resource));\n    }\n\n    const resource = idOrResource;\n\n    // Get the abstract decision from the resource's concrete decision\n    const abstractDecision = resource.decision.baseDecision;\n\n    // Resolve the decision to get candidate indices in priority order\n    const decisionResult = this.resolveDecision(abstractDecision);\n    /* c8 ignore next 3 - defense in depth almost impossible to hit */\n    if (decisionResult.isFailure()) {\n      return fail(`Failed to resolve decision for resource \"${resource.id}\": ${decisionResult.message}`);\n    }\n\n    const resolution = decisionResult.value;\n\n    // Check if any candidates matched (regular or default)\n    if (\n      !resolution.success ||\n      (resolution.instanceIndices.length === 0 && resolution.defaultInstanceIndices.length === 0)\n    ) {\n      return fail(`No matching candidates found for resource \"${resource.id}\"`);\n    }\n\n    // Get all matching candidates: regular matches first, then default matches\n    const candidates: IResourceCandidate[] = [];\n\n    // Add all regular matches first (already sorted by priority)\n    for (const candidateIndex of resolution.instanceIndices) {\n      if (candidateIndex >= resource.candidates.length) {\n        return fail(`Invalid candidate index ${candidateIndex} for resource \"${resource.id}\"`);\n      }\n      const candidate = resource.candidates[candidateIndex];\n      candidates.push(candidate);\n    }\n\n    // Add all default matches after regular matches (already sorted by priority)\n    for (const candidateIndex of resolution.defaultInstanceIndices) {\n      /* c8 ignore next 3 - defense in depth should not happen */\n      if (candidateIndex >= resource.candidates.length) {\n        return fail(`Invalid candidate index ${candidateIndex} for resource \"${resource.id}\"`);\n      }\n      const candidate = resource.candidates[candidateIndex];\n      candidates.push(candidate);\n    }\n\n    return succeed(candidates);\n  }\n\n  /**\n   * Resolves a resource to a composed value by merging matching candidates according to their merge methods.\n   * Starting from the highest priority candidates, finds the first \"full\" candidate and merges all higher\n   * priority \"partial\" candidates into it in ascending order of priority.\n   * @param resource - The {@link Resources.Resource | resource} to resolve.\n   * @returns `Success` with the composed JsonValue if successful,\n   * or `Failure` with an error message if no candidates match or resolution fails.\n   * @public\n   */\n  public resolveComposedResourceValue(resource: IResource): Result<JsonValue>;\n\n  /**\n   * Resolves a resource to a composed value by merging matching candidates according to their merge methods.\n   * Starting from the highest priority candidates, finds the first \"full\" candidate and merges all higher\n   * priority \"partial\" candidates into it in ascending order of priority.\n   * @param resource - The string id of the resource to resolve.\n   * @returns `Success` with the composed JsonValue if successful,\n   * or `Failure` with an error message if no candidates match or resolution fails.\n   * @public\n   */\n  public resolveComposedResourceValue(resource: string): Result<JsonValue>;\n  public resolveComposedResourceValue(idOrResource: string | IResource): Result<JsonValue> {\n    /* c8 ignore next 4 - defensive coding: string resource resolution should use direct resource calls */\n    if (typeof idOrResource === 'string') {\n      return this.resourceManager\n        .getBuiltResource(idOrResource)\n        .onSuccess((resource) => this.resolveComposedResourceValue(resource));\n    }\n\n    const resource = idOrResource;\n\n    return this.resolveAllResourceCandidates(resource).onSuccess((candidates) => {\n      /* c8 ignore next 3 - defense in depth should never occur */\n      if (candidates.length === 0) {\n        return fail(`${resource.id}: No matching candidates found.`);\n      }\n\n      // Find the first full candidate and collect all partial candidates above it\n      let fullCandidateIndex = -1;\n      const partialCandidates: IResourceCandidate[] = [];\n\n      for (let i = 0; i < candidates.length; i++) {\n        const candidate = candidates[i];\n        if (!candidate.isPartial) {\n          // Found the first full candidate\n          fullCandidateIndex = i;\n          break;\n        } else {\n          // Collect partial candidates (these are in ascending priority order)\n          partialCandidates.unshift(candidate);\n        }\n      }\n\n      // If no full candidate found, use the last candidate as the base\n      const baseCandidateIndex = fullCandidateIndex >= 0 ? fullCandidateIndex : candidates.length - 1;\n      const baseCandidate = candidates[baseCandidateIndex];\n\n      // If there are no partial candidates to merge, but null-as-delete is enabled,\n      // still process through JsonEditor to handle null properties in the base candidate\n      if (partialCandidates.length === 0) {\n        if (this.options.suppressNullAsDelete || !isJsonObject(baseCandidate.json)) {\n          return succeed(baseCandidate.json);\n        }\n\n        // Process single candidate through JsonEditor to apply null-as-delete\n        const editor = JsonEditor.create({\n          merge: {\n            arrayMergeBehavior: 'replace',\n            nullAsDelete: true\n          }\n        }).orThrow(); // Should never fail with valid options\n\n        return editor\n          .mergeObjectsInPlace({}, [baseCandidate.json])\n          .withErrorFormat((err) => `${resource.id}: Composition failed: ${err}`);\n      }\n\n      const allCandidates = [\n        baseCandidate.json,\n        ...partialCandidates.map((candidate) => candidate.json)\n      ].filter((v): v is JsonObject => isJsonObject(v));\n\n      /* c8 ignore next 3 - defensive check: non-object values in resource candidates should be prevented at validation time */\n      if (allCandidates.length !== partialCandidates.length + 1) {\n        return fail(`${resource.id}: Unable to compose non-object candidate values.`);\n      }\n\n      // Create JsonEditor with array replacement behavior and null-as-delete for resource composition\n      const editor = JsonEditor.create({\n        merge: {\n          arrayMergeBehavior: 'replace',\n          nullAsDelete: !this.options.suppressNullAsDelete\n        }\n      }).orThrow(); // Should never fail with valid options\n\n      return editor\n        .mergeObjectsInPlace({}, allCandidates)\n        .withErrorFormat((err) => `${resource.id}: Composition failed: ${err}`);\n    });\n  }\n\n  /**\n   * {@inheritDoc IResourceResolver.withContext}\n   */\n  public withContext(context: Record<string, string>): Result<ResourceResolver> {\n    const { resourceManager, qualifierTypes, options } = this;\n    return ValidatingSimpleContextQualifierProvider.create({\n      qualifiers: this.qualifiers,\n      qualifierValues: context\n    }).onSuccess((contextQualifierProvider) => {\n      return ResourceResolver.create({\n        resourceManager,\n        qualifierTypes,\n        options,\n        contextQualifierProvider\n      });\n    });\n  }\n\n  /**\n   * Clears all caches (condition, condition set, and decision), forcing all cached items\n   * to be re-evaluated on next access. This should be called when the context changes and cached\n   * results are no longer valid.\n   * @public\n   */\n  public clearConditionCache(): void {\n    this._conditionCache.fill(undefined);\n    this._conditionSetCache.fill(undefined);\n    this._decisionCache.fill(undefined);\n\n    this._listener?.onCacheClear('condition');\n    this._listener?.onCacheClear('conditionSet');\n    this._listener?.onCacheClear('decision');\n  }\n\n  /**\n   * Gets the current size of the condition cache array.\n   * @returns The size of the condition cache array.\n   * @public\n   */\n  public get conditionCacheSize(): number {\n    return this._conditionCache.length;\n  }\n\n  /**\n   * Gets the current size of the condition set cache array.\n   * @returns The size of the condition set cache array.\n   * @public\n   */\n  public get conditionSetCacheSize(): number {\n    return this._conditionSetCache.length;\n  }\n\n  /**\n   * Gets the current size of the decision cache array.\n   * @returns The size of the decision cache array.\n   * @public\n   */\n  public get decisionCacheSize(): number {\n    return this._decisionCache.length;\n  }\n}\n"]}

package/dist/packlets/runtime/resourceTreeResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceTreeResolver.js","sourceRoot":"","sources":["../../../src/packlets/runtime/resourceTreeResolver.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, MessageAggregator, succeed, fail, captureResult } from '@fgv/ts-utils';\nimport { JsonValue, JsonObject, Converters as JsonConverters } from '@fgv/ts-json-base';\nimport { IResourceManager, IResource } from './iResourceManager';\nimport { IReadOnlyResourceTreeNode, IReadOnlyResourceTreeRoot } from './resource-tree/common';\nimport { ResourceResolver } from './resourceResolver';\n\n/**\n * Type for handling resource resolution errors during tree traversal.\n * The handler receives the resource that failed to resolve, the error message, and the resolver for recovery attempts.\n * It can return:\n * - Success(undefined) to omit the property from the result\n * - Success(value) to use an alternate value\n * - Failure to propagate the error\n * @public\n */\nexport type ResourceErrorHandler = (\n  resource: IResource,\n  message: string,\n  resolver: ResourceResolver\n) => Result<JsonValue | undefined>;\n\n/**\n * Type for handling empty branch nodes during tree composition.\n * The handler receives the branch node, names of failed children, and the resolver for recovery attempts.\n * It can return:\n * - Success(undefined) to omit the branch from the result\n * - Success(value) to use an alternate value for the branch\n * - Failure to propagate the error\n * @public\n */\nexport type EmptyBranchHandler = (\n  branchNode: IReadOnlyResourceTreeNode<IResource>,\n  failedChildNames: string[],\n  resolver: ResourceResolver\n) => Result<JsonValue | undefined>;\n\n/**\n * Options for configuring resource tree resolution.\n * @public\n */\nexport interface IResolveResourceTreeOptions {\n  /**\n   * Controls how errors are handled when resolving individual resources in the tree.\n   * - 'fail': Aggregate all errors and fail if any resource fails to resolve\n   * - 'ignore': Skip failed resources and omit them from the result\n   * - callback: Custom error handler that can provide alternate values or propagate errors\n   * @defaultValue 'fail'\n   */\n  onResourceError?: 'fail' | 'ignore' | ResourceErrorHandler;\n\n  /**\n   * Controls how empty branch nodes are handled during tree composition.\n   * - 'allow': Include empty branches as empty objects in the result\n   * - 'omit': Exclude empty branches from the parent object\n   * - callback: Custom handler that can provide alternate values or recovery logic\n   * @defaultValue 'allow'\n   */\n  onEmptyBranch?: 'allow' | 'omit' | EmptyBranchHandler;\n}\n\n/**\n * Specialized resolver for resource tree operations, providing enhanced APIs for\n * resolving entire resource trees from either resource IDs or pre-built tree nodes.\n *\n * This class provides a clean separation between individual resource resolution\n * (handled by ResourceResolver) and tree-based operations, with support for\n * lazy tree construction and enhanced error handling.\n *\n * @public\n */\nexport class ResourceTreeResolver {\n  /**\n   * The {@link Runtime.ResourceResolver | ResourceResolver} to use for individual resource resolution\n   */\n  public readonly resolver: ResourceResolver;\n\n  /**\n   * The {@link Runtime.IResourceManager | IResourceManager} to use for lazy tree construction.\n   * @internal\n   */\n  private readonly _resourceManager: IResourceManager<IResource>;\n  /**\n   * The built resource tree, lazily built on first access.\n   * @internal\n   */\n  private _tree?: Result<IReadOnlyResourceTreeRoot<IResource>>;\n\n  /**\n   * Creates a {@link Runtime.ResourceTreeResolver | ResourceTreeResolver} instance.\n   * @param resolver - The ResourceResolver to use for individual resource resolution\n   */\n  public constructor(resolver: ResourceResolver) {\n    this.resolver = resolver;\n    this._resourceManager = resolver.resourceManager;\n  }\n\n  /**\n   * Creates a {@link Runtime.ResourceTreeResolver | ResourceTreeResolver} instance.\n   * @param resolver - The ResourceResolver to use for individual resource resolution\n   */\n  public static create(resolver: ResourceResolver): Result<ResourceTreeResolver> {\n    return captureResult(() => new ResourceTreeResolver(resolver));\n  }\n\n  /**\n   * Gets the built resource tree, building it lazily on first access.\n   * @returns The resource tree root\n   * @throws Error if no resource manager was provided or tree building fails\n   * @public\n   */\n  public get tree(): IReadOnlyResourceTreeRoot<IResource> {\n    return this._getTree().orThrow();\n  }\n\n  /**\n   * Resolves a resource tree from a resource ID, building the tree lazily from the resource manager.\n   * @param resourceId - The ID of the root resource to resolve\n   * @param options - Optional configuration for error handling during resolution\n   * @returns Success with the composed JsonObject or undefined, or Failure with error message\n   * @public\n   */\n  public resolveComposedResourceTree(\n    resourceId: string,\n    options?: IResolveResourceTreeOptions\n  ): Result<JsonObject | undefined>;\n\n  /**\n   * Resolves a pre-built resource tree node.\n   * @param node - The resource tree node to resolve\n   * @param options - Optional configuration for error handling during resolution\n   * @returns Success with the composed JsonObject or undefined, or Failure with error message\n   * @public\n   */\n  public resolveComposedResourceTree(\n    node: IReadOnlyResourceTreeNode<IResource>,\n    options?: IResolveResourceTreeOptions\n  ): Result<JsonObject | undefined>;\n\n  /**\n   * Implementation for both overloads.\n   */\n  public resolveComposedResourceTree(\n    idOrNode: string | IReadOnlyResourceTreeNode<IResource>,\n    options?: IResolveResourceTreeOptions\n  ): Result<JsonObject | undefined> {\n    if (typeof idOrNode === 'string') {\n      return this._resolveFromResourceId(idOrNode, options);\n    }\n    return this._resolveFromTreeNode(idOrNode, options);\n  }\n\n  private _getTree(): Result<IReadOnlyResourceTreeRoot<IResource>> {\n    if (!this._tree) {\n      this._tree = this._resourceManager.getBuiltResourceTree();\n    }\n    return this._tree;\n  }\n\n  /**\n   * Resolves a tree from a resource ID by first building the tree from the resource manager.\n   * @internal\n   */\n  private _resolveFromResourceId(\n    resourceId: string,\n    options?: IResolveResourceTreeOptions\n  ): Result<JsonObject | undefined> {\n    return this._getTree().onSuccess((tree) => {\n      return tree.children.validating\n        .getById(resourceId)\n        .onFailure((message) => fail(`${resourceId}: Resource not found in resource tree: ${message}`))\n        .onSuccess((rootNode) => this._resolveFromTreeNode(rootNode, options));\n    });\n  }\n\n  /**\n   * Resolves a pre-built tree node using the extracted tree resolution logic.\n   * @internal\n   */\n  private _resolveFromTreeNode(\n    node: IReadOnlyResourceTreeNode<IResource>,\n    options?: IResolveResourceTreeOptions\n  ): Result<JsonObject | undefined> {\n    const resourceErrorMode = options?.onResourceError ?? 'fail';\n    const emptyBranchMode = options?.onEmptyBranch ?? 'allow';\n\n    // Handle root node with proper Result chaining\n    return node.isLeaf\n      ? this._processLeafNode(node, '', resourceErrorMode).onSuccess((value) =>\n          value !== undefined ? JsonConverters.jsonObject.convert(value) : succeed(undefined)\n        )\n      : this._processBranchNode(node, '', {\n          onResourceError: resourceErrorMode,\n          onEmptyBranch: emptyBranchMode\n        }).onSuccess((value) => {\n          // Only convert undefined to {} if emptyBranchMode is 'allow'\n          // For 'omit' mode or custom handlers returning undefined, preserve undefined\n          /* c8 ignore next 3 - defense in depth */\n          return succeed(value === undefined && emptyBranchMode === 'allow' ? {} : value);\n        });\n  }\n\n  /**\n   * Handles resource resolution errors according to the specified mode.\n   * @param resource - The resource that failed to resolve\n   * @param message - The error message from the failed resolution\n   * @param mode - The error handling mode\n   * @param path - The path to the resource in the tree (for error context)\n   * @internal\n   */\n  private _handleResourceError(\n    resource: IResource,\n    message: string,\n    mode: 'fail' | 'ignore' | ResourceErrorHandler,\n    path: string\n  ): Result<JsonValue | undefined> {\n    if (mode === 'ignore') {\n      return succeed(undefined);\n    }\n    if (mode === 'fail') {\n      const errorMessage = path ? `${path}: ${message}` : message;\n      return fail(errorMessage);\n    }\n    // Custom handler - pass the resolver for recovery attempts\n    return mode(resource, message, this.resolver);\n  }\n\n  /**\n   * Handles empty branch nodes according to the specified mode.\n   * @param node - The empty branch node\n   * @param failedChildren - Names of children that failed to resolve\n   * @param mode - The empty branch handling mode\n   * @param path - The path to the branch in the tree (for error context)\n   * @internal\n   */\n  private _handleEmptyBranch(\n    node: IReadOnlyResourceTreeNode<IResource>,\n    failedChildren: string[],\n    mode: 'allow' | 'omit' | EmptyBranchHandler,\n    path: string\n  ): Result<JsonValue | undefined> {\n    if (mode === 'omit') {\n      return succeed(undefined);\n    }\n    if (mode === 'allow') {\n      return succeed({});\n    }\n    // Custom handler - pass the resolver for recovery attempts\n    return mode(node, failedChildren, this.resolver);\n  }\n\n  /**\n   * Processes a leaf node by resolving its resource value.\n   * @param node - The leaf node to process (must be a leaf node)\n   * @param path - The path to the node in the tree\n   * @param resourceErrorMode - How to handle resource resolution errors\n   * @internal\n   */\n  private _processLeafNode(\n    node: IReadOnlyResourceTreeNode<IResource>,\n    path: string,\n    resourceErrorMode: 'fail' | 'ignore' | ResourceErrorHandler\n  ): Result<JsonValue | undefined> {\n    /* c8 ignore next 3 - defense in depth */\n    if (!node.isLeaf) {\n      return fail(`Internal error: processLeafNode called on non-leaf node at ${path}`);\n    }\n\n    return this.resolver\n      .resolveComposedResourceValue(node.resource)\n      .onSuccess<JsonValue | undefined>((value) => succeed(value))\n      .onFailure((message) => this._handleResourceError(node.resource, message, resourceErrorMode, path));\n  }\n\n  /**\n   * Processes a branch node by recursively resolving all its children.\n   * @param node - The branch node to process (must be a branch node)\n   * @param path - The path to the node in the tree\n   * @param options - Resolution options\n   * @internal\n   */\n  private _processBranchNode(\n    node: IReadOnlyResourceTreeNode<IResource>,\n    path: string,\n    options: IResolveResourceTreeOptions\n  ): Result<JsonObject | undefined> {\n    /* c8 ignore next 3 - defense in depth */\n    if (node.isLeaf) {\n      return fail(`Internal error: processBranchNode called on leaf node at ${path}`);\n    }\n\n    /* c8 ignore next 2 - ?? is defense in depth */\n    const resourceErrorMode = options.onResourceError ?? 'fail';\n    const emptyBranchMode = options.onEmptyBranch ?? 'allow';\n    const aggregator = new MessageAggregator();\n\n    // Process all children\n    const childResults: JsonObject = {};\n    const failedChildren: string[] = [];\n\n    for (const [childName, childNode] of node.children) {\n      const childPath = path ? `${path}.${childName}` : childName;\n\n      const childResult = childNode.isLeaf\n        ? this._processLeafNode(childNode, childPath, resourceErrorMode)\n        : this._processBranchNode(childNode, childPath, options);\n\n      // Process the child result and update our state\n      if (childResult.isSuccess()) {\n        const value = childResult.value;\n        if (value !== undefined) {\n          childResults[childName] = value;\n        } else {\n          failedChildren.push(childName);\n        }\n      } else {\n        if (resourceErrorMode === 'fail') {\n          aggregator.addMessage(childResult.message);\n        }\n        failedChildren.push(childName);\n      }\n    }\n\n    // Check for accumulated errors in 'fail' mode\n    if (resourceErrorMode === 'fail' && aggregator.hasMessages) {\n      return fail(aggregator.toString('; '));\n    }\n\n    // Handle empty branch\n    if (Object.keys(childResults).length === 0) {\n      return this._handleEmptyBranch(node, failedChildren, emptyBranchMode, path).onSuccess((value) => {\n        if (value === undefined) {\n          return succeed(undefined);\n        }\n        // Ensure we return JsonObject or undefined\n        return JsonConverters.jsonObject.convert(value);\n      });\n    }\n\n    return succeed(childResults);\n  }\n}\n"]}

package/dist/packlets/runtime/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/packlets/runtime/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAAa,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAc,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,UAAU,CAAC,MAAM,CAAqB;IACpC,IAAI,EAAE,cAAc,CAAC,UAAU;IAC/B,SAAS,EAAE,UAAU,CAAC,OAAO;IAC7B,WAAW,EAAE,UAAU,CAAC,GAAG,CACzB,6BAA6B,EAC7B,CAAC,CAAC,EAAyC,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS,CACnG;CACF,CAAC,CAAC;AAEL;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAkC,UAAU,CAAC,MAAM,CAAY;IAClF,EAAE,EAAE,UAAU,CAAC,GAAG,CAChB,YAAY,EACZ,CAAC,CAAC,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAC/E;IACD,IAAI,EAAE,UAAU,CAAC,GAAG,CAClB,cAAc,EACd,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAC7E;IACD,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC,CAAC,EAAqB,EAAE,CAAC,CAAC,YAAY,YAAY,CAAC;IAC1G,QAAQ,EAAE,UAAU,CAAC,GAAG,CACtB,2BAA2B,EAC3B,CAAC,CAAC,EAAyB,EAAE,CAAC,CAAC,YAAY,gBAAgB,CAC5D;IACD,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,iBAAiB,CAAC;CAClD,CAAC,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Validators, Validator } from '@fgv/ts-utils';\nimport { Validators as JsonValidators } from '@fgv/ts-json-base';\nimport { Validate, ResourceId } from '../common';\nimport { ResourceType } from '../resource-types';\nimport { ConcreteDecision } from '../decisions';\nimport { IResource, IResourceCandidate } from './iResourceManager';\n\n/**\n * Validates an {@link Runtime.IResourceCandidate | IResourceCandidate} object.\n * @public\n */\nexport const resourceCandidate: Validator<IResourceCandidate, unknown> =\n  Validators.object<IResourceCandidate>({\n    json: JsonValidators.jsonObject,\n    isPartial: Validators.boolean,\n    mergeMethod: Validators.isA(\n      'resource value merge method',\n      (v): v is 'augment' | 'delete' | 'replace' => v === 'augment' || v === 'delete' || v === 'replace'\n    )\n  });\n\n/**\n * Validates an {@link Runtime.IResource | IResource} object.\n * @public\n */\nexport const resource: Validator<IResource, unknown> = Validators.object<IResource>({\n  id: Validators.isA(\n    'ResourceId',\n    (v): v is ResourceId => typeof v === 'string' && Validate.isValidResourceId(v)\n  ),\n  name: Validators.isA(\n    'ResourceName',\n    (v): v is string => typeof v === 'string' && Validate.isValidResourceName(v)\n  ),\n  resourceType: Validators.isA('ResourceType instance', (v): v is ResourceType => v instanceof ResourceType),\n  decision: Validators.isA(\n    'ConcreteDecision instance',\n    (v): v is ConcreteDecision => v instanceof ConcreteDecision\n  ),\n  candidates: Validators.arrayOf(resourceCandidate)\n});\n"]}

package/dist/packlets/zip-archive/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAa,UAAU,EAAa,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7E,OAAO,EAAwB,OAAO,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAoC,UAAU,CAAC,eAAe,CAAC;IAC7F,MAAM;IACN,WAAW;CACH,CAAC,CAAC;AAEZ;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAsB,UAAU,CAAC,eAAe,CAAC,CAAC,MAAM,CAAU,CAAC,CAAC;AAErG;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,UAAU,CAAC,MAAM,CAA4B;IAC3C,IAAI,EAAE,mBAAmB;IACzB,YAAY,EAAE,UAAU,CAAC,MAAM;IAC/B,WAAW,EAAE,UAAU,CAAC,MAAM;CAC/B,CAAC,CAAC;AAEL;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC/B,UAAU,CAAC,MAAM,CAA6B;IAC5C,IAAI,EAAE,oBAAoB;IAC1B,YAAY,EAAE,UAAU,CAAC,MAAM;IAC/B,WAAW,EAAE,UAAU,CAAC,MAAM;CAC/B,CAAC,CAAC;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAC7B,UAAU,CAAC,MAAM,CAA2B;IAC1C,SAAS,EAAE,UAAU,CAAC,MAAM;IAC5B,KAAK,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACrC,MAAM,EAAE,oBAAoB,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEL;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAsB,UAAU,CAAC,MAAM,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAkC,UAAU,CAAC,YAAY,CAAqB;IACrG,IAAI,EAAE,UAAU,CAAC,MAAM;IACvB,IAAI,EAAE,UAAU,CAAC,MAAM;IACvB,OAAO,EAAE,UAAU,CAAC,MAAM;IAC1B,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,sBAAsB;CAC/C,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAuC,UAAU,CAAC,OAAO,CAGrF,CAAC,IAAa,EAAE,IAAiD,EAAE,OAAiB,EAAE,EAAE;IACxF,OAAO,UAAU,CAAC,YAAY,CAA0B;QACtD,IAAI,EAAE,UAAU,CAAC,MAAM;QACvB,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC;QACvC,cAAc,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;KACzC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAgD,UAAU,CAAC,GAAG,CAC5F,sBAAsB,EACtB,CAAC,KAAc,EAA6C,EAAE;IAC5D,OAAO,aAAa,CAAC,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,CAAC;AACtE,CAAC,CACF,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Validator, Validators, Converter, Converters } from '@fgv/ts-utils';\nimport * as Json from './json';\nimport { Model as ConfigModel, Convert as ConfigConvert } from '../config';\n\n/**\n * Validator for ZIP archive input type\n * @public\n */\nexport const zipArchiveInputType: Validator<'file' | 'directory'> = Validators.enumeratedValue([\n  'file',\n  'directory'\n] as const);\n\n/**\n * Validator for ZIP archive config type\n * @public\n */\nexport const zipArchiveConfigType: Validator<'file'> = Validators.enumeratedValue(['file'] as const);\n\n/**\n * Validator for ZIP archive input information\n * @public\n */\nexport const zipArchiveInputInfo: Validator<Json.IZipArchiveInputInfo> =\n  Validators.object<Json.IZipArchiveInputInfo>({\n    type: zipArchiveInputType,\n    originalPath: Validators.string,\n    archivePath: Validators.string\n  });\n\n/**\n * Validator for ZIP archive config information\n * @public\n */\nexport const zipArchiveConfigInfo: Validator<Json.IZipArchiveConfigInfo> =\n  Validators.object<Json.IZipArchiveConfigInfo>({\n    type: zipArchiveConfigType,\n    originalPath: Validators.string,\n    archivePath: Validators.string\n  });\n\n/**\n * Validator for ZIP archive manifest\n * Compatible with existing tools from ts-res-browser-cli\n * @public\n */\nexport const zipArchiveManifest: Validator<Json.IZipArchiveManifest> =\n  Validators.object<Json.IZipArchiveManifest>({\n    timestamp: Validators.string,\n    input: zipArchiveInputInfo.optional(),\n    config: zipArchiveConfigInfo.optional()\n  });\n\n/**\n * Validator for MIME type strings\n * @public\n */\nexport const mimeType: Validator<string> = Validators.string;\n\n/**\n * Converter for imported file\n * @public\n */\nexport const importedFile: Converter<Json.IImportedFile> = Converters.strictObject<Json.IImportedFile>({\n  name: Converters.string,\n  path: Converters.string,\n  content: Converters.string,\n  type: Converters.string // MIME type as string\n});\n\n/**\n * Converter for imported directory structure (recursive)\n * Note: Uses Converter pattern because Validators don't support recursion with self parameter\n * @public\n */\nexport const importedDirectory: Converter<Json.IImportedDirectory> = Converters.generic<\n  Json.IImportedDirectory,\n  unknown\n>((from: unknown, self: Converter<Json.IImportedDirectory, unknown>, context?: unknown) => {\n  return Converters.strictObject<Json.IImportedDirectory>({\n    name: Converters.string,\n    files: Converters.arrayOf(importedFile),\n    subdirectories: Converters.arrayOf(self)\n  }).convert(from, context);\n});\n\n/**\n * Validator for system configuration (delegates to config packlet)\n * This validates that the parsed JSON conforms to the system configuration schema\n * @public\n */\nexport const systemConfiguration: Validator<ConfigModel.ISystemConfiguration> = Validators.isA(\n  'system configuration',\n  (value: unknown): value is ConfigModel.ISystemConfiguration => {\n    return ConfigConvert.systemConfiguration.convert(value).isSuccess();\n  }\n);\n"]}

package/dist/packlets/zip-archive/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/index.browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,aAAa;AACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAEzB,4EAA4E;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAgBtD,mBAAmB;AACnB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACV,MAAM,oBAAoB,CAAC;AAE5B,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C,+EAA+E;AAC/E,iEAAiE;AACjE,6EAA6E","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Browser-safe ZIP archive functionality for ts-res source file archives\n *\n * This packlet provides consolidated ZIP archive creation and loading functionality\n * for source files, compatible with browsers using fflate.\n *\n * @remarks\n * ZIP archives contain source files for resource ingestion with directory\n * structure preserved and optional validation but no processing or transformation.\n * This is distinct from ZIP bundles which contain processed resource output.\n *\n * ZipArchiveCreator supports browser usage when FileTreeItems are provided directly.\n * Methods accepting file paths require Node.js fs access and should not be called in browser.\n *\n * ZipArchiveLoader is fully browser-compatible and works with File API or ArrayBuffer.\n *\n * @packageDocumentation\n */\n\nimport * as Json from './json';\nimport * as Convert from './convert';\n\n// Namespaces\nexport { Json, Convert };\n\n// Core classes (browser-compatible when used with FileTreeItems or buffers)\nexport { ZipArchiveCreator } from './zipArchiveCreator';\nexport { ZipArchiveLoader } from './zipArchiveLoader';\n\n// Types and interfaces\nexport type {\n  IZipArchivePathOptions,\n  IZipArchiveFileTreeOptions,\n  ZipArchiveOptions,\n  IZipArchiveResult,\n  IZipArchiveManifest,\n  IZipArchiveLoadOptions,\n  IZipArchiveLoadResult,\n  IImportedFile,\n  IImportedDirectory,\n  ZipArchiveProgressCallback\n} from './types';\n\n// Format utilities\nexport {\n  createZipArchiveManifest,\n  parseZipArchiveManifest,\n  validateZipArchiveManifest,\n  parseZipArchiveConfiguration,\n  generateZipArchiveFilename,\n  normalizePath,\n  getDirectoryName,\n  sanitizeFilename,\n  isZipFile\n} from './zipArchiveFormat';\n\n// Constants\nexport { ZipArchiveConstants } from './types';\n\n// Note: ZipArchiveCreator._getInputFileTreeItem() and _getConfigFileTreeItem()\n// use FileTree.forFilesystem() internally when given file paths.\n// In browser, provide FileTreeItems directly via IZipArchiveFileTreeOptions.\n"]}

package/dist/packlets/zip-archive/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AAErC,aAAa;AACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAEzB,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAgBtD,mBAAmB;AACnB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACV,MAAM,oBAAoB,CAAC;AAE5B,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * ZIP archive functionality for ts-res source file archives\n *\n * This packlet provides consolidated ZIP archive creation and loading functionality\n * for source files, compatible with existing tools while using fflate for\n * universal browser compatibility.\n *\n * @remarks\n * ZIP archives contain source files for resource ingestion with directory\n * structure preserved and optional validation but no processing or transformation.\n * This is distinct from ZIP bundles which contain processed resource output.\n *\n * @packageDocumentation\n */\n\nimport * as Json from './json';\nimport * as Convert from './convert';\n\n// Namespaces\nexport { Json, Convert };\n\n// Core classes\nexport { ZipArchiveCreator } from './zipArchiveCreator';\nexport { ZipArchiveLoader } from './zipArchiveLoader';\n\n// Types and interfaces\nexport type {\n  IZipArchivePathOptions,\n  IZipArchiveFileTreeOptions,\n  ZipArchiveOptions,\n  IZipArchiveResult,\n  IZipArchiveManifest,\n  IZipArchiveLoadOptions,\n  IZipArchiveLoadResult,\n  IImportedFile,\n  IImportedDirectory,\n  ZipArchiveProgressCallback\n} from './types';\n\n// Format utilities\nexport {\n  createZipArchiveManifest,\n  parseZipArchiveManifest,\n  validateZipArchiveManifest,\n  parseZipArchiveConfiguration,\n  generateZipArchiveFilename,\n  normalizePath,\n  getDirectoryName,\n  sanitizeFilename,\n  isZipFile\n} from './zipArchiveFormat';\n\n// Constants\nexport { ZipArchiveConstants } from './types';\n"]}

package/dist/packlets/zip-archive/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * JSON representation of ZIP archive input information\n * @public\n */\nexport interface IZipArchiveInputInfo {\n  /** Type of input (file or directory) */\n  type: 'file' | 'directory';\n  /** Original file/directory path */\n  originalPath: string;\n  /** Path within the archive (e.g., \"input/mydir\") */\n  archivePath: string;\n}\n\n/**\n * JSON representation of ZIP archive config information\n * @public\n */\nexport interface IZipArchiveConfigInfo {\n  /** Type of config (always 'file') */\n  type: 'file';\n  /** Original config file path */\n  originalPath: string;\n  /** Path within the archive (e.g., \"config.json\") */\n  archivePath: string;\n}\n\n/**\n * JSON representation of a ZIP archive manifest\n * Compatible with existing tools from ts-res-browser-cli\n * @public\n */\nexport interface IZipArchiveManifest {\n  /** Archive creation timestamp */\n  timestamp: string;\n\n  /** Optional input source information */\n  input?: IZipArchiveInputInfo;\n\n  /** Optional configuration file information */\n  config?: IZipArchiveConfigInfo;\n}\n\n/**\n * JSON representation of an imported file\n * @public\n */\nexport interface IImportedFile {\n  /** File name */\n  name: string;\n  /** Full path within archive */\n  path: string;\n  /** File content as string */\n  content: string;\n  /** MIME type */\n  type: string;\n}\n\n/**\n * JSON representation of an imported directory structure\n * @public\n */\nexport interface IImportedDirectory {\n  /** Directory name */\n  name: string;\n  /** Files in this directory */\n  files: IImportedFile[];\n  /** Subdirectories */\n  subdirectories: IImportedDirectory[];\n}\n"]}

package/dist/packlets/zip-archive/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA2GH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,yBAAyB;IACzB,aAAa,EAAE,eAAe;IAC9B,8BAA8B;IAC9B,WAAW,EAAE,aAAa;IAC1B,4BAA4B;IAC5B,SAAS,EAAE,OAAO;IAClB,oCAAoC;IACpC,UAAU,EAAE,QAAQ;CACZ,CAAC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Model as ConfigModel } from '../config';\nimport * as Json from './json';\nimport {} from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\n\n/**\n * Options for creating a ZIP archive buffer\n * @public\n */\nexport interface IZipArchivePathOptions {\n  /** File or directory path to include in the archive */\n  inputPath?: string;\n  /** Optional configuration file path */\n  configPath?: string;\n}\n\n/**\n * Options for creating a ZIP archive buffer from a file tree\n * @public\n */\nexport interface IZipArchiveFileTreeOptions {\n  /** Input file or directory */\n  inputItem?: FileTree.FileTreeItem;\n  /** Optional configuration file */\n  configItem?: FileTree.IFileTreeFileItem;\n}\n\n/**\n * Options for creating a ZIP archive buffer\n * @public\n */\nexport type ZipArchiveOptions = IZipArchivePathOptions | IZipArchiveFileTreeOptions;\n\n/**\n * Standardized ZIP archive manifest format (compatible with existing tools)\n * @public\n */\nexport type IZipArchiveManifest = Json.IZipArchiveManifest;\n\n/**\n * Result of ZIP archive buffer creation\n * @public\n */\nexport interface IZipArchiveResult {\n  /** Raw ZIP data buffer */\n  zipBuffer: Uint8Array;\n  /** Archive manifest with metadata */\n  manifest: IZipArchiveManifest;\n  /** Total ZIP size in bytes */\n  size: number;\n}\n\n/**\n * Options for loading a ZIP archive\n * @public\n */\nexport interface IZipArchiveLoadOptions {\n  /** Validate manifest strictly */\n  strictManifestValidation?: boolean;\n}\n\n/**\n * Result of ZIP archive loading\n * @public\n */\nexport interface IZipArchiveLoadResult {\n  /** Parsed archive manifest */\n  manifest: IZipArchiveManifest | undefined;\n  /** Loaded configuration */\n  config: ConfigModel.ISystemConfiguration | undefined;\n  /** All files extracted from the archive */\n  files: IImportedFile[];\n  /** Directory structure if available */\n  directory: IImportedDirectory | undefined;\n}\n\n/**\n * Imported file representation\n * @public\n */\nexport type IImportedFile = Json.IImportedFile;\n\n/**\n * Imported directory structure\n * @public\n */\nexport type IImportedDirectory = Json.IImportedDirectory;\n\n/**\n * Progress callback for ZIP operations\n * @public\n */\nexport type ZipArchiveProgressCallback = (\n  stage:\n    | 'reading-file'\n    | 'parsing-zip'\n    | 'loading-manifest'\n    | 'loading-config'\n    | 'extracting-files'\n    | 'processing-resources'\n    | 'creating-zip',\n  progress: number, // 0-100\n  details: string\n) => void;\n\n/**\n * Constants for ZIP archive structure\n * @public\n */\nexport const ZipArchiveConstants = {\n  /** Manifest file name */\n  MANIFEST_FILE: 'manifest.json',\n  /** Configuration file name */\n  CONFIG_FILE: 'config.json',\n  /** Input files directory */\n  INPUT_DIR: 'input',\n  /** Configuration files directory */\n  CONFIG_DIR: 'config'\n} as const;\n"]}

package/dist/packlets/zip-archive/zipArchiveCreator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipArchiveCreator.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/zipArchiveCreator.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { zipSync } from 'fflate';\nimport { Result, succeed, fail } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\nimport type { IZipArchiveResult, ZipArchiveOptions, ZipArchiveProgressCallback } from './types';\nimport { normalizePath } from './zipArchiveFormat';\nimport * as Json from './json';\n\n/**\n * ZIP archive creator using fflate for universal compatibility\n * @public\n */\nexport class ZipArchiveCreator {\n  /**\n   * Create a ZIP archive buffer from a supplied buffer\n   * @param options - Input paths and configuration\n   * @param onProgress - Optional progress callback\n   * @returns Result containing ZIP buffer and manifest\n   */\n  public async createFromBuffer(\n    options: ZipArchiveOptions,\n    onProgress?: ZipArchiveProgressCallback\n  ): Promise<Result<IZipArchiveResult>> {\n    try {\n      onProgress?.('creating-zip', 0, 'Starting ZIP archive creation');\n\n      const files: Record<string, Uint8Array> = {};\n      const manifest: Json.IZipArchiveManifest = {\n        timestamp: new Date().toISOString()\n      };\n\n      const { value: inputItem, message: inputItemError } = this._getInputFileTreeItem(options);\n      if (inputItemError !== undefined) {\n        return fail(inputItemError);\n      }\n\n      if (inputItem !== undefined) {\n        onProgress?.('reading-file', 10, `Processing input: ${inputItem.absolutePath}`);\n\n        if (inputItem.type === 'directory') {\n          // Add entire directory recursively, preserving structure\n          const archivePath = `input/${inputItem.name}`;\n\n          const addDirResult = await this._addDirectoryTreeToZip(files, inputItem, archivePath, onProgress);\n          /* c8 ignore next 3 - defense in depth against internal error */\n          if (addDirResult.isFailure()) {\n            return fail(addDirResult.message);\n          }\n\n          manifest.input = {\n            type: 'directory',\n            originalPath: inputItem.absolutePath,\n            archivePath\n          };\n        } else if (inputItem.type === 'file') {\n          // Add single file\n          const archivePath = `input/${inputItem.name}`;\n\n          const addFileResult = await this._addFileTreeItemToZip(files, inputItem, archivePath);\n          /* c8 ignore next 3 - defense in depth against internal error */\n          if (addFileResult.isFailure()) {\n            return fail(addFileResult.message);\n          }\n\n          manifest.input = {\n            type: 'file',\n            originalPath: inputItem.absolutePath,\n            archivePath\n          };\n        }\n      }\n\n      const { value: configItem, message: configItemError } = this._getConfigFileTreeItem(options);\n      if (configItemError !== undefined) {\n        return fail(configItemError);\n      }\n\n      if (configItem !== undefined) {\n        onProgress?.('reading-file', 40, `Processing config: ${configItem.absolutePath}`);\n\n        const archivePath = `config/${configItem.name}`;\n\n        const addConfigResult = await this._addFileTreeItemToZip(files, configItem, archivePath);\n        /* c8 ignore next 3 - defense in depth against internal error */\n        if (addConfigResult.isFailure()) {\n          return fail(addConfigResult.message);\n        }\n\n        // Update manifest with config info\n        manifest.config = {\n          type: 'file',\n          originalPath: configItem.absolutePath,\n          archivePath\n        };\n      }\n\n      // Add manifest to ZIP\n      onProgress?.('creating-zip', 70, 'Adding manifest');\n      const manifestJson = JSON.stringify(manifest, null, 2);\n      files['manifest.json'] = new TextEncoder().encode(manifestJson);\n\n      // Create ZIP buffer using fflate\n      onProgress?.('creating-zip', 80, 'Compressing files');\n      const zipBuffer = zipSync(files, { level: 6 });\n\n      const result: IZipArchiveResult = {\n        zipBuffer,\n        manifest,\n        size: zipBuffer.length\n      };\n\n      onProgress?.('creating-zip', 100, 'ZIP archive buffer created');\n\n      return succeed(result);\n      /* c8 ignore next 3 - defense in depth against internal error */\n    } catch (error) {\n      return fail(`Failed to create ZIP archive: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  /**\n   * Add a single FileTree item to the ZIP archive\n   * @param files - ZIP files collection\n   * @param fileItem - FileTree file item to add\n   * @param archivePath - Path within the archive\n   * @returns Result indicating success or failure\n   */\n  private async _addFileTreeItemToZip(\n    files: Record<string, Uint8Array>,\n    fileItem: FileTree.IFileTreeFileItem,\n    archivePath: string\n  ): Promise<Result<void>> {\n    return fileItem.getRawContents().onSuccess((content) => {\n      const contentBuffer = new TextEncoder().encode(content);\n      files[normalizePath(archivePath)] = contentBuffer;\n      return succeed(undefined);\n    });\n  }\n\n  /**\n   * Add a directory recursively to the ZIP archive using FileTree\n   * @param files - ZIP files collection\n   * @param directoryItem - FileTree directory item to add\n   * @param archivePrefix - Prefix path within the archive\n   * @param onProgress - Optional progress callback\n   * @returns Result indicating success or failure\n   */\n  private async _addDirectoryTreeToZip(\n    files: Record<string, Uint8Array>,\n    directoryItem: FileTree.IFileTreeDirectoryItem,\n    archivePrefix: string,\n    onProgress?: ZipArchiveProgressCallback\n  ): Promise<Result<void>> {\n    const childrenResult = directoryItem.getChildren();\n    /* c8 ignore next 3 - defense in depth against internal error */\n    if (childrenResult.isFailure()) {\n      return fail(`Failed to read directory ${directoryItem.absolutePath}: ${childrenResult.message}`);\n    }\n\n    for (const child of childrenResult.value) {\n      const itemArchivePath = normalizePath(`${archivePrefix}/${child.name}`);\n\n      if (child.type === 'directory') {\n        // Recursively add subdirectory\n        const addDirResult = await this._addDirectoryTreeToZip(files, child, itemArchivePath, onProgress);\n        /* c8 ignore next 3 - defense in depth against internal error */\n        if (addDirResult.isFailure()) {\n          return fail(addDirResult.message);\n        }\n      } else if (child.type === 'file') {\n        // Add file\n        const addFileResult = await this._addFileTreeItemToZip(files, child, itemArchivePath);\n        /* c8 ignore next 3 - defense in depth against internal error */\n        if (addFileResult.isFailure()) {\n          return fail(addFileResult.message);\n        }\n        onProgress?.('reading-file', 0, `Added file: ${itemArchivePath}`);\n      }\n    }\n\n    return succeed(undefined);\n  }\n\n  private _getInputFileTreeItem(options: ZipArchiveOptions): Result<FileTree.FileTreeItem | undefined> {\n    if ('inputPath' in options && options.inputPath !== undefined) {\n      return FileTree.forFilesystem()\n        .withErrorFormat((msg) => `Failed to create file tree: ${msg}`)\n        .onSuccess((fileTree) =>\n          fileTree.getItem(options.inputPath!).withErrorFormat((msg) => `Failed to get item: ${msg}`)\n        );\n    } else if ('inputItem' in options) {\n      return succeed(options.inputItem);\n    }\n    return succeed(undefined);\n  }\n\n  private _getConfigFileTreeItem(options: ZipArchiveOptions): Result<FileTree.IFileTreeFileItem | undefined> {\n    if ('configPath' in options && options.configPath !== undefined) {\n      return FileTree.forFilesystem()\n        .withErrorFormat((msg) => `Failed to create file tree: ${msg}`)\n        .onSuccess((fileTree) =>\n          fileTree.getFile(options.configPath!).withErrorFormat((msg) => `Failed to get config file: ${msg}`)\n        );\n    } else if ('configItem' in options && options.configItem !== undefined) {\n      return succeed(options.configItem);\n    }\n    return succeed(undefined);\n  }\n}\n"]}

package/dist/packlets/zip-archive/zipArchiveFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipArchiveFormat.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/zipArchiveFormat.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, captureResult } from '@fgv/ts-utils';\nimport { Model as ConfigModel } from '../config';\nimport * as Json from './json';\nimport * as Convert from './convert';\n\n/**\n * Create a ZIP archive manifest object\n * @param inputType - Type of input (file or directory)\n * @param originalPath - Original file/directory path\n * @param archivePath - Path within the archive\n * @param configPath - Optional configuration file path\n * @returns ZIP archive manifest\n * @public\n */\nexport function createZipArchiveManifest(\n  inputType: 'file' | 'directory',\n  originalPath: string,\n  archivePath: string,\n  configPath?: string\n): Json.IZipArchiveManifest {\n  const manifest: Json.IZipArchiveManifest = {\n    timestamp: new Date().toISOString(),\n    input: {\n      type: inputType,\n      originalPath,\n      archivePath\n    }\n  };\n\n  if (configPath) {\n    manifest.config = {\n      type: 'file',\n      originalPath: configPath,\n      archivePath: 'config.json'\n    };\n  }\n\n  return manifest;\n}\n\n/**\n * Parse and validate a ZIP archive manifest\n * @param manifestData - JSON string containing manifest data\n * @returns Result containing validated manifest\n * @public\n */\nexport function parseZipArchiveManifest(manifestData: string): Result<Json.IZipArchiveManifest> {\n  return captureResult(() => {\n    const parsed = JSON.parse(manifestData);\n    return parsed;\n  })\n    .onSuccess((parsed) => Convert.zipArchiveManifest.validate(parsed))\n    .withErrorFormat((e) => `Failed to parse ZIP archive manifest: ${e}`);\n}\n\n/**\n * Validate a ZIP archive manifest object\n * @param manifest - Object to validate as manifest\n * @returns Result containing validated manifest\n * @public\n */\nexport function validateZipArchiveManifest(manifest: unknown): Result<Json.IZipArchiveManifest> {\n  return Convert.zipArchiveManifest.validate(manifest);\n}\n\n/**\n * Parse and validate configuration JSON\n * @param configData - JSON string containing configuration\n * @returns Result containing validated configuration\n * @public\n */\nexport function parseZipArchiveConfiguration(configData: string): Result<ConfigModel.ISystemConfiguration> {\n  return captureResult(() => {\n    const parsed = JSON.parse(configData);\n    return parsed;\n  })\n    .onSuccess((parsed) => Convert.systemConfiguration.validate(parsed))\n    .withErrorFormat((e) => `Failed to parse ZIP archive configuration: ${e}`);\n}\n\n/**\n * Generate a timestamp-based filename for ZIP archives\n * @param customName - Optional custom name prefix\n * @returns Generated filename\n * @public\n */\nexport function generateZipArchiveFilename(customName?: string): string {\n  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').replace('T', '_').slice(0, -5);\n  return customName ? `${customName}-${timestamp}.zip` : `ts-res-archive-${timestamp}.zip`;\n}\n\n/**\n * Normalize path separators for cross-platform compatibility\n * @param path - Path to normalize\n * @returns Normalized path\n * @public\n */\nexport function normalizePath(path: string): string {\n  return path.replace(/\\\\/g, '/').replace(/\\/+/g, '/');\n}\n\n/**\n * Extract directory name from a file path\n * @param path - File path\n * @returns Directory name\n * @public\n */\nexport function getDirectoryName(path: string): string {\n  const normalized = normalizePath(path);\n  const parts = normalized.split('/');\n  return parts[parts.length - 1] || 'archive';\n}\n\n/**\n * Create a safe filename by removing invalid characters\n * @param filename - Original filename\n * @returns Sanitized filename\n * @public\n */\nexport function sanitizeFilename(filename: string): string {\n  return filename\n    .replace(/[<>:\"/\\\\|?*]/g, '_')\n    .replace(/\\s+/g, '_')\n    .replace(/_+/g, '_')\n    .trim();\n}\n\n/**\n * Validate ZIP file extension\n * @param filename - Filename to validate\n * @returns True if filename has .zip extension\n * @public\n */\nexport function isZipFile(filename: string): boolean {\n  return filename.toLowerCase().endsWith('.zip');\n}\n"]}

package/dist/packlets/zip-archive/zipArchiveLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipArchiveLoader.js","sourceRoot":"","sources":["../../../src/packlets/zip-archive/zipArchiveLoader.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, succeed, fail } from '@fgv/ts-utils';\nimport { FileTree } from '@fgv/ts-json-base';\n// ZipFileTree is browser-safe - doesn't depend on Node.js crypto/fs modules\nimport { ZipFileTree } from '@fgv/ts-extras';\nimport type {\n  IZipArchiveLoadOptions,\n  IZipArchiveLoadResult,\n  ZipArchiveProgressCallback,\n  IImportedFile,\n  IImportedDirectory\n} from './types';\nimport { Model as ConfigModel } from '../config';\nimport * as Json from './json';\nimport { parseZipArchiveManifest, parseZipArchiveConfiguration, isZipFile } from './zipArchiveFormat';\n\n/**\n * ZIP archive loader extending ts-extras foundation\n * @public\n */\nexport class ZipArchiveLoader {\n  /**\n   * Load ZIP archive from File object (Browser)\n   * @param file - File object from file input\n   * @param options - Loading options\n   * @param onProgress - Optional progress callback\n   * @returns Result containing loaded archive data\n   */\n  public async loadFromFile(\n    file: File,\n    options: IZipArchiveLoadOptions = {},\n    onProgress?: ZipArchiveProgressCallback\n  ): Promise<Result<IZipArchiveLoadResult>> {\n    onProgress?.('reading-file', 0, `Reading file: ${file.name}`);\n\n    if (!isZipFile(file.name)) {\n      return fail(`File ${file.name} is not a ZIP file`);\n    }\n\n    try {\n      const buffer = await file.arrayBuffer();\n      onProgress?.('reading-file', 100, 'File read complete');\n\n      return await this.loadFromBuffer(buffer, options, onProgress);\n      /* c8 ignore next 3 - defense in depth against internal error */\n    } catch (error) {\n      return fail(`Failed to read file: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  /**\n   * Load ZIP archive from ArrayBuffer (Universal)\n   * @param buffer - ZIP data buffer\n   * @param options - Loading options\n   * @param onProgress - Optional progress callback\n   * @returns Result containing loaded archive data\n   */\n  public async loadFromBuffer(\n    buffer: ArrayBuffer,\n    options: IZipArchiveLoadOptions = {},\n    onProgress?: ZipArchiveProgressCallback\n  ): Promise<Result<IZipArchiveLoadResult>> {\n    onProgress?.('parsing-zip', 0, 'Parsing ZIP archive');\n\n    const zipAccessorsResult = ZipFileTree.ZipFileTreeAccessors.fromBuffer(buffer);\n    if (zipAccessorsResult.isFailure()) {\n      return fail(`Failed to parse ZIP: ${zipAccessorsResult.message}`);\n    }\n\n    const zipAccessors = zipAccessorsResult.value;\n    onProgress?.('parsing-zip', 100, 'ZIP archive parsed');\n\n    // Load manifest\n    onProgress?.('loading-manifest', 0, 'Loading manifest');\n    const manifestResult = this._loadManifestFromAccessors(zipAccessors);\n    if (manifestResult.isFailure()) {\n      return fail(manifestResult.message);\n    }\n    const manifest = manifestResult.value;\n    onProgress?.('loading-manifest', 100, 'Manifest loaded');\n\n    // Load configuration\n    onProgress?.('loading-config', 0, 'Loading configuration');\n    const configResult = this._loadConfigurationFromAccessors(zipAccessors, manifest, options);\n    if (configResult.isFailure()) {\n      return fail(configResult.message);\n    }\n    const config = configResult.value;\n    onProgress?.('loading-config', 100, 'Configuration loaded');\n\n    // Extract files and directory structure\n    onProgress?.('extracting-files', 0, 'Extracting files');\n    const filesResult = await this._extractFilesFromAccessors(zipAccessors, onProgress);\n    /* c8 ignore next 3 - defense in depth against internal error */\n    if (filesResult.isFailure()) {\n      return fail(filesResult.message);\n    }\n\n    const { files, directory } = filesResult.value;\n    onProgress?.('extracting-files', 100, `Extracted ${files.length} files`);\n\n    onProgress?.('extracting-files', 100, 'ZIP loading complete');\n\n    return succeed({\n      manifest,\n      config,\n      files,\n      directory\n    });\n  }\n\n  /**\n   * Load manifest from ZIP using ZipFileTreeAccessors\n   * @param zipAccessors - ZIP file tree accessors\n   * @returns Result containing parsed manifest\n   */\n  private _loadManifestFromAccessors(\n    zipAccessors: ZipFileTree.ZipFileTreeAccessors\n  ): Result<Json.IZipArchiveManifest | undefined> {\n    const manifestResult = zipAccessors.getFileContents('manifest.json');\n    if (manifestResult.isFailure()) {\n      // Manifest is optional - return success with undefined\n      return succeed(undefined);\n    }\n\n    const parseResult = parseZipArchiveManifest(manifestResult.value);\n    if (parseResult.isFailure()) {\n      return fail(`Failed to parse manifest.json: ${parseResult.message}`);\n    }\n\n    return succeed(parseResult.value);\n  }\n\n  /**\n   * Load configuration from ZIP using ZipFileTreeAccessors\n   * @param zipAccessors - ZIP file tree accessors\n   * @param manifest - Parsed manifest (may be undefined)\n   * @param options - Loading options\n   * @returns Result containing parsed configuration\n   */\n  private _loadConfigurationFromAccessors(\n    zipAccessors: ZipFileTree.ZipFileTreeAccessors,\n    manifest: Json.IZipArchiveManifest | undefined,\n    options: IZipArchiveLoadOptions\n  ): Result<ConfigModel.ISystemConfiguration | undefined> {\n    // Check if manifest specifies a config file\n    const manifestSpecifiesConfig = manifest?.config !== undefined;\n\n    if (!manifestSpecifiesConfig) {\n      // If no config specified in manifest, config is optional\n      return succeed(undefined);\n    }\n\n    // Get the config path from the manifest\n    const configPath = manifest!.config!.archivePath;\n    return zipAccessors\n      .getFileContents(configPath)\n      .withErrorFormat(\n        () => `Manifest specifies config file at '${configPath}' but it was not found in archive`\n      )\n      .onSuccess((configContent) => parseZipArchiveConfiguration(configContent))\n      .withErrorFormat((e) => `Failed to parse config file '${configPath}': ${e}`);\n  }\n\n  /**\n   * Extract files and directory structure from ZIP\n   * @param zipAccessors - ZIP file tree accessors\n   * @param onProgress - Optional progress callback\n   * @returns Result containing files and directory structure\n   */\n  private async _extractFilesFromAccessors(\n    zipAccessors: ZipFileTree.ZipFileTreeAccessors,\n    onProgress?: ZipArchiveProgressCallback\n  ): Promise<Result<{ files: IImportedFile[]; directory: IImportedDirectory | undefined }>> {\n    try {\n      const files: IImportedFile[] = [];\n      const directories = new Map<string, IImportedDirectory>();\n\n      // Get all children from root\n      const rootChildrenResult = zipAccessors.getChildren('/');\n      /* c8 ignore next 3 - defense in depth against internal error */\n      if (rootChildrenResult.isFailure()) {\n        return fail(`Failed to read ZIP contents: ${rootChildrenResult.message}`);\n      }\n\n      // Process all items recursively\n      await this._processFileTreeItems(\n        zipAccessors,\n        '/',\n        rootChildrenResult.value,\n        files,\n        directories,\n        onProgress\n      );\n\n      // Build directory structure\n      const directory = this._buildDirectoryStructure(files, directories);\n\n      return succeed({ files, directory });\n      /* c8 ignore next 3 - defense in depth against internal error */\n    } catch (error) {\n      return fail(`Failed to extract files: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  /**\n   * Recursively process file tree items\n   * @param zipAccessors - ZIP file tree accessors\n   * @param currentPath - Current directory path\n   * @param items - Items to process\n   * @param files - Files collection\n   * @param directories - Directories collection\n   * @param onProgress - Optional progress callback\n   * @param processed - Processing counter\n   */\n  private async _processFileTreeItems(\n    zipAccessors: ZipFileTree.ZipFileTreeAccessors,\n    currentPath: string,\n    items: readonly FileTree.FileTreeItem[],\n    files: IImportedFile[],\n    directories: Map<string, IImportedDirectory>,\n    onProgress?: ZipArchiveProgressCallback,\n    processed: { count: number } = { count: 0 }\n  ): Promise<void> {\n    for (const item of items) {\n      /* c8 ignore next 1 - defense in depth */\n      const itemPath = item.absolutePath.startsWith('/') ? item.absolutePath.substring(1) : item.absolutePath;\n\n      if (item.type === 'directory') {\n        // Track directory\n        if (!directories.has(itemPath)) {\n          directories.set(itemPath, {\n            name: item.name,\n            files: [],\n            subdirectories: []\n          });\n        }\n\n        // Recursively process children\n        const childrenResult = zipAccessors.getChildren(item.absolutePath);\n        if (childrenResult.isSuccess()) {\n          await this._processFileTreeItems(\n            zipAccessors,\n            item.absolutePath,\n            childrenResult.value,\n            files,\n            directories,\n            onProgress,\n            processed\n          );\n        }\n      } else if (item.type === 'file') {\n        // Get file content\n        const contentResult = item.getRawContents();\n        const content = contentResult.orDefault('');\n\n        files.push({\n          name: item.name,\n          path: itemPath,\n          content,\n          type: this._getFileType(item.name)\n        });\n      }\n\n      processed.count++;\n      onProgress?.('extracting-files', 0, `Processing ${itemPath}`);\n    }\n  }\n\n  /**\n   * Build directory structure from files\n   * @param files - Extracted files\n   * @param directories - Directories map\n   * @returns Root directory structure or null\n   */\n  private _buildDirectoryStructure(\n    files: IImportedFile[],\n    directories: Map<string, IImportedDirectory>\n  ): IImportedDirectory | undefined {\n    /* c8 ignore next 3 - should never happen with fflate */\n    if (files.length === 0) {\n      return undefined;\n    }\n\n    const rootDir: IImportedDirectory = {\n      name: 'root',\n      files: [],\n      subdirectories: []\n    };\n\n    // Process files to build directory structure\n    for (const file of files) {\n      const pathParts = file.path.split('/').filter((part: string) => part.length > 0);\n\n      /* c8 ignore next 1 - defense in depth should never happen */\n      if (pathParts.length === 0) continue;\n\n      // Ensure all parent directories exist\n      let currentDir = rootDir;\n      for (let i = 0; i < pathParts.length - 1; i++) {\n        const dirName = pathParts[i];\n        let foundDir = currentDir.subdirectories.find((d) => d.name === dirName);\n\n        if (!foundDir) {\n          foundDir = {\n            name: dirName,\n            files: [],\n            subdirectories: []\n          };\n          currentDir.subdirectories.push(foundDir);\n        }\n\n        currentDir = foundDir;\n      }\n\n      // Add file to its parent directory\n      currentDir.files.push(file);\n    }\n\n    return rootDir;\n  }\n\n  /**\n   * Get file MIME type based on extension\n   * @param filename - Filename\n   * @returns MIME type\n   */\n  private _getFileType(filename: string): string {\n    const ext = filename.toLowerCase().split('.').pop();\n    /* c8 ignore next 20 - no need to test every one */\n    switch (ext) {\n      case 'json':\n        return 'application/json';\n      case 'yaml':\n      case 'yml':\n        return 'application/yaml';\n      case 'xml':\n        return 'application/xml';\n      case 'txt':\n        return 'text/plain';\n      case 'md':\n        return 'text/markdown';\n      case 'js':\n        return 'application/javascript';\n      case 'ts':\n        return 'application/typescript';\n      default:\n        return 'application/octet-stream';\n    }\n  }\n}\n"]}