@fgv/ts-res 4.5.0-3 → 5.0.0-10

package/lib/packlets/runtime/context/validatingSimpleContextQualifierProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validatingSimpleContextQualifierProvider.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/validatingSimpleContextQualifierProvider.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EAEL,0CAA0C,EAC3C,MAAM,qCAAqC,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,qDAAqD;IACpE;;OAEG;IACH,UAAU,EAAE,2BAA2B,CAAC;IAExC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,qBAAa,wCAAyC,SAAQ,8BAA8B;IAC1F;;;OAGG;IACH,SAAgB,UAAU,EAAE,0CAA0C,CAAC;IAEvE;;;OAGG;IACH,SAAS,aAAa,MAAM,EAAE,qDAAqD;IAiBnF;;;;;;OAMG;WACW,MAAM,CAClB,MAAM,EAAE,qDAAqD,GAC5D,MAAM,CAAC,wCAAwC,CAAC;CAGpD"}

package/lib/packlets/runtime/context/validatingSimpleContextQualifierProvider.js

@@ -0,0 +1,64 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidatingSimpleContextQualifierProvider = void 0;
+const ts_utils_1 = require("@fgv/ts-utils");
+const simpleContextQualifierProvider_1 = require("./simpleContextQualifierProvider");
+const contextQualifierProviderValidator_1 = require("./contextQualifierProviderValidator");
+/**
+ * A {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} with a
+ * {@link Runtime.Context.ContextQualifierProviderValidator | validator} property that enables
+ * validated use of the underlying provider with string keys and values.
+ * This eliminates the need for type casting in consumer code.
+ * @public
+ */
+class ValidatingSimpleContextQualifierProvider extends simpleContextQualifierProvider_1.SimpleContextQualifierProvider {
+    /**
+     * Constructor for a {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object.
+     * @param params - {@link Runtime.IValidatingSimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.
+     */
+    constructor(params) {
+        // Convert string values to QualifierContextValue for the base class
+        /* c8 ignore next 5 - functional code path tested but coverage intermittently missed */
+        const convertedValues = params.qualifierValues
+            ? Object.fromEntries(Object.entries(params.qualifierValues).map(([key, value]) => [key, value]))
+            : undefined;
+        super({
+            qualifiers: params.qualifiers,
+            qualifierValues: convertedValues
+        });
+        this.validating = new contextQualifierProviderValidator_1.ContextQualifierProviderValidator({ provider: this });
+    }
+    /**
+     * Creates a new {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object.
+     * @param params - {@link Runtime.IValidatingSimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.
+     * @returns `Success` with the new {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object if successful,
+     * or `Failure` with an error message if not.
+     * @public
+     */
+    static create(params) {
+        return (0, ts_utils_1.captureResult)(() => new ValidatingSimpleContextQualifierProvider(params));
+    }
+}
+exports.ValidatingSimpleContextQualifierProvider = ValidatingSimpleContextQualifierProvider;
+//# sourceMappingURL=validatingSimpleContextQualifierProvider.js.map

package/lib/packlets/runtime/context/validatingSimpleContextQualifierProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validatingSimpleContextQualifierProvider.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/context/validatingSimpleContextQualifierProvider.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,4CAAsD;AAGtD,qFAAkF;AAClF,2FAG6C;AAmB7C;;;;;;GAMG;AACH,MAAa,wCAAyC,SAAQ,+DAA8B;IAO1F;;;OAGG;IACH,YAAsB,MAA6D;QACjF,oEAAoE;QACpE,uFAAuF;QACvF,MAAM,eAAe,GAAsD,MAAM,CAAC,eAAe;YAC/F,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAA8B,CAAC,CAAC,CACpG;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,KAAK,CAAC;YACJ,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,eAAe,EAAE,eAAe;SACjC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,GAAG,IAAI,qEAAiC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAClB,MAA6D;QAE7D,OAAO,IAAA,wBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,wCAAwC,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,CAAC;CACF;AAxCD,4FAwCC","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 { QualifierContextValue } from '../../common';\nimport { IReadOnlyQualifierCollector } from '../../qualifiers';\nimport { SimpleContextQualifierProvider } from './simpleContextQualifierProvider';\nimport {\n  ContextQualifierProviderValidator,\n  IReadOnlyContextQualifierProviderValidator\n} from './contextQualifierProviderValidator';\n\n/**\n * Parameters for creating a {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider}.\n * @public\n */\nexport interface IValidatingSimpleContextQualifierProviderCreateParams {\n  /**\n   * The {@link Qualifiers.IReadOnlyQualifierCollector | readonly qualifier collector} that defines and validates qualifiers.\n   */\n  qualifiers: IReadOnlyQualifierCollector;\n\n  /**\n   * Optional record of initial qualifier name-value pairs to populate the provider.\n   * Accepts string keys and values which will be converted to strongly-typed values.\n   */\n  qualifierValues?: Record<string, string>;\n}\n\n/**\n * A {@link Runtime.SimpleContextQualifierProvider | SimpleContextQualifierProvider} with a\n * {@link Runtime.Context.ContextQualifierProviderValidator | validator} property that enables\n * validated use of the underlying provider with string keys and values.\n * This eliminates the need for type casting in consumer code.\n * @public\n */\nexport class ValidatingSimpleContextQualifierProvider extends SimpleContextQualifierProvider {\n  /**\n   * A {@link Runtime.Context.ContextQualifierProviderValidator | ContextQualifierProviderValidator} which validates\n   * string inputs before passing them to this provider.\n   */\n  public readonly validating: IReadOnlyContextQualifierProviderValidator;\n\n  /**\n   * Constructor for a {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.IValidatingSimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   */\n  protected constructor(params: IValidatingSimpleContextQualifierProviderCreateParams) {\n    // Convert string values to QualifierContextValue for the base class\n    /* c8 ignore next 5 - functional code path tested but coverage intermittently missed */\n    const convertedValues: Record<string, QualifierContextValue> | undefined = params.qualifierValues\n      ? Object.fromEntries(\n          Object.entries(params.qualifierValues).map(([key, value]) => [key, value as QualifierContextValue])\n        )\n      : undefined;\n\n    super({\n      qualifiers: params.qualifiers,\n      qualifierValues: convertedValues\n    });\n\n    this.validating = new ContextQualifierProviderValidator({ provider: this });\n  }\n\n  /**\n   * Creates a new {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object.\n   * @param params - {@link Runtime.IValidatingSimpleContextQualifierProviderCreateParams | Parameters} used to create the provider.\n   * @returns `Success` with the new {@link Runtime.ValidatingSimpleContextQualifierProvider | ValidatingSimpleContextQualifierProvider} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(\n    params: IValidatingSimpleContextQualifierProviderCreateParams\n  ): Result<ValidatingSimpleContextQualifierProvider> {\n    return captureResult(() => new ValidatingSimpleContextQualifierProvider(params));\n  }\n}\n"]}

package/lib/packlets/runtime/iResourceManager.d.ts

@@ -0,0 +1,94 @@
+import { Result, Collections } from '@fgv/ts-utils';
+import { JsonObject } from '@fgv/ts-json-base';
+import { ReadOnlyConditionCollector, ReadOnlyConditionSetCollector } from '../conditions';
+import { ReadOnlyAbstractDecisionCollector, ConcreteDecision } from '../decisions';
+import { ResourceId, ResourceValueMergeMethod } from '../common';
+import { ResourceType } from '../resource-types';
+import { IContextDecl, IValidatedContextDecl } from '../context';
+import { IReadOnlyResourceTreeRoot } from './resource-tree';
+/**
+ * Runtime representation of a resource candidate with the minimal data needed for resolution.
+ * @public
+ */
+export interface IResourceCandidate {
+    /** The JSON value for this candidate */
+    readonly json: JsonObject;
+    /**
+     * Indicates if this candidate is a partial resource.
+     */
+    readonly isPartial: boolean;
+    /**
+     * Specifies the resource type of this candidate.
+     */
+    readonly mergeMethod: ResourceValueMergeMethod;
+}
+/**
+ * Interface for a resource that can be used in the runtime layer.
+ * This provides the minimal properties needed from a resource without requiring
+ * the full Resources layer dependencies.
+ * @public
+ */
+export interface IResource {
+    /** The resource identifier */
+    readonly id: string;
+    /** The resource type */
+    readonly resourceType: ResourceType;
+    /** The decision used to select candidates */
+    readonly decision: ConcreteDecision;
+    /** The available candidates for this resource */
+    readonly candidates: ReadonlyArray<IResourceCandidate>;
+}
+/**
+ * Interface defining the read-only properties that the runtime resource resolver needs
+ * from a resource manager. This abstraction allows the runtime to work with different
+ * implementations without requiring the full ResourceManagerBuilder build mechanics.
+ * @public
+ */
+export interface IResourceManager<TR extends IResource = IResource> {
+    /**
+     * A {@link Conditions.ReadOnlyConditionCollector | ReadOnlyConditionCollector} which
+     * contains the {@link Conditions.Condition | conditions} used by resource candidates.
+     */
+    readonly conditions: ReadOnlyConditionCollector;
+    /**
+     * A {@link Conditions.ReadOnlyConditionSetCollector | ReadOnlyConditionSetCollector} which
+     * contains the {@link Conditions.ConditionSet | condition sets} used by resource candidates.
+     */
+    readonly conditionSets: ReadOnlyConditionSetCollector;
+    /**
+     * A {@link Decisions.ReadOnlyAbstractDecisionCollector | ReadOnlyAbstractDecisionCollector} which
+     * contains the {@link Decisions.Decision | abstract decisions} used by resource candidates.
+     */
+    readonly decisions: ReadOnlyAbstractDecisionCollector;
+    /**
+     * Gets a built resource by ID for runtime resolution.
+     * @param id - The resource identifier
+     * @returns Success with the runtime resource if found, Failure otherwise
+     */
+    getBuiltResource(id: string): Result<TR>;
+    /**
+     * Gets a resource tree built from the resources in this resource manager.
+     * @returns Result containing the resource tree root, or failure if tree construction fails
+     */
+    getBuiltResourceTree(): Result<IReadOnlyResourceTreeRoot<TR>>;
+    /**
+     * A read-only result map of all built resources, keyed by resource ID.
+     * Resources are built on-demand when accessed and returns Results for error handling.
+     */
+    readonly builtResources: Collections.IReadOnlyValidatingResultMap<ResourceId, TR>;
+    /**
+     * The number of resources in this resource manager.
+     */
+    readonly numResources: number;
+    /**
+     * The number of candidates in this resource manager.
+     */
+    readonly numCandidates: number;
+    /**
+     * Validates a context declaration against the qualifiers managed by this resource manager.
+     * @param context - The context declaration to validate
+     * @returns Success with the validated context if successful, Failure otherwise
+     */
+    validateContext(context: IContextDecl): Result<IValidatedContextDecl>;
+}
+//# sourceMappingURL=iResourceManager.d.ts.map

package/lib/packlets/runtime/iResourceManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iResourceManager.d.ts","sourceRoot":"","sources":["../../../src/packlets/runtime/iResourceManager.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,iCAAiC,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;CAChD;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;CACxD;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,EAAE,SAAS,SAAS,GAAG,SAAS;IAChE;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC;IAEhD;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,6BAA6B,CAAC;IAEtD;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,iCAAiC,CAAC;IAEtD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IAEzC;;;OAGG;IACH,oBAAoB,IAAI,MAAM,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9D;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,4BAA4B,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAElF;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;CACvE"}

package/lib/packlets/runtime/iResourceManager.js

@@ -0,0 +1,24 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=iResourceManager.js.map

package/lib/packlets/runtime/iResourceManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iResourceManager.js","sourceRoot":"","sources":["../../../src/packlets/runtime/iResourceManager.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\nimport { Result, Collections } from '@fgv/ts-utils';\nimport { JsonObject } from '@fgv/ts-json-base';\nimport { ReadOnlyConditionCollector, ReadOnlyConditionSetCollector } from '../conditions';\nimport { ReadOnlyAbstractDecisionCollector, ConcreteDecision } from '../decisions';\nimport { ResourceId, ResourceValueMergeMethod } from '../common';\nimport { ResourceType } from '../resource-types';\nimport { IContextDecl, IValidatedContextDecl } from '../context';\nimport { IReadOnlyResourceTreeRoot } from './resource-tree';\n\n/**\n * Runtime representation of a resource candidate with the minimal data needed for resolution.\n * @public\n */\nexport interface IResourceCandidate {\n  /** The JSON value for this candidate */\n  readonly json: JsonObject;\n\n  /**\n   * Indicates if this candidate is a partial resource.\n   */\n  readonly isPartial: boolean;\n\n  /**\n   * Specifies the resource type of this candidate.\n   */\n  readonly mergeMethod: ResourceValueMergeMethod;\n}\n\n/**\n * Interface for a resource that can be used in the runtime layer.\n * This provides the minimal properties needed from a resource without requiring\n * the full Resources layer dependencies.\n * @public\n */\nexport interface IResource {\n  /** The resource identifier */\n  readonly id: string;\n  /** The resource type */\n  readonly resourceType: ResourceType;\n  /** The decision used to select candidates */\n  readonly decision: ConcreteDecision;\n  /** The available candidates for this resource */\n  readonly candidates: ReadonlyArray<IResourceCandidate>;\n}\n\n/**\n * Interface defining the read-only properties that the runtime resource resolver needs\n * from a resource manager. This abstraction allows the runtime to work with different\n * implementations without requiring the full ResourceManagerBuilder build mechanics.\n * @public\n */\nexport interface IResourceManager<TR extends IResource = IResource> {\n  /**\n   * A {@link Conditions.ReadOnlyConditionCollector | ReadOnlyConditionCollector} which\n   * contains the {@link Conditions.Condition | conditions} used by resource candidates.\n   */\n  readonly conditions: ReadOnlyConditionCollector;\n\n  /**\n   * A {@link Conditions.ReadOnlyConditionSetCollector | ReadOnlyConditionSetCollector} which\n   * contains the {@link Conditions.ConditionSet | condition sets} used by resource candidates.\n   */\n  readonly conditionSets: ReadOnlyConditionSetCollector;\n\n  /**\n   * A {@link Decisions.ReadOnlyAbstractDecisionCollector | ReadOnlyAbstractDecisionCollector} which\n   * contains the {@link Decisions.Decision | abstract decisions} used by resource candidates.\n   */\n  readonly decisions: ReadOnlyAbstractDecisionCollector;\n\n  /**\n   * Gets a built resource by ID for runtime resolution.\n   * @param id - The resource identifier\n   * @returns Success with the runtime resource if found, Failure otherwise\n   */\n  getBuiltResource(id: string): Result<TR>;\n\n  /**\n   * Gets a resource tree built from the resources in this resource manager.\n   * @returns Result containing the resource tree root, or failure if tree construction fails\n   */\n  getBuiltResourceTree(): Result<IReadOnlyResourceTreeRoot<TR>>;\n\n  /**\n   * A read-only result map of all built resources, keyed by resource ID.\n   * Resources are built on-demand when accessed and returns Results for error handling.\n   */\n  readonly builtResources: Collections.IReadOnlyValidatingResultMap<ResourceId, TR>;\n\n  /**\n   * The number of resources in this resource manager.\n   */\n  readonly numResources: number;\n\n  /**\n   * The number of candidates in this resource manager.\n   */\n  readonly numCandidates: number;\n\n  /**\n   * Validates a context declaration against the qualifiers managed by this resource manager.\n   * @param context - The context declaration to validate\n   * @returns Success with the validated context if successful, Failure otherwise\n   */\n  validateContext(context: IContextDecl): Result<IValidatedContextDecl>;\n}\n"]}

package/lib/packlets/runtime/index.d.ts

@@ -0,0 +1,12 @@
+export * from './compiledResourceCollection';
+export * from './iResourceManager';
+export * from './context/simpleContextQualifierProvider';
+export * from './context/validatingSimpleContextQualifierProvider';
+export * from './resourceResolver';
+export * from './conditionSetResolutionResult';
+export * from './cacheListener';
+export * from './cacheMetrics';
+import * as Context from './context';
+import * as ResourceTree from './resource-tree';
+export { Context, ResourceTree };
+//# sourceMappingURL=index.d.ts.map

package/lib/packlets/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/packlets/runtime/index.ts"],"names":[],"mappings":"AAsBA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,0CAA0C,CAAC;AACzD,cAAc,oDAAoD,CAAC;AACnE,cAAc,oBAAoB,CAAC;AACnC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAE/B,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,YAAY,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/lib/packlets/runtime/index.js

@@ -0,0 +1,73 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceTree = exports.Context = void 0;
+__exportStar(require("./compiledResourceCollection"), exports);
+__exportStar(require("./iResourceManager"), exports);
+__exportStar(require("./context/simpleContextQualifierProvider"), exports);
+__exportStar(require("./context/validatingSimpleContextQualifierProvider"), exports);
+__exportStar(require("./resourceResolver"), exports);
+__exportStar(require("./conditionSetResolutionResult"), exports);
+__exportStar(require("./cacheListener"), exports);
+__exportStar(require("./cacheMetrics"), exports);
+const Context = __importStar(require("./context"));
+exports.Context = Context;
+const ResourceTree = __importStar(require("./resource-tree"));
+exports.ResourceTree = ResourceTree;
+//# sourceMappingURL=index.js.map

package/lib/packlets/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/runtime/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,+DAA6C;AAC7C,qDAAmC;AACnC,2EAAyD;AACzD,qFAAmE;AACnE,qDAAmC;AACnC,iEAA+C;AAC/C,kDAAgC;AAChC,iDAA+B;AAE/B,mDAAqC;AAG5B,0BAAO;AAFhB,8DAAgD;AAE9B,oCAAY","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\nexport * from './compiledResourceCollection';\nexport * from './iResourceManager';\nexport * from './context/simpleContextQualifierProvider';\nexport * from './context/validatingSimpleContextQualifierProvider';\nexport * from './resourceResolver';\nexport * from './conditionSetResolutionResult';\nexport * from './cacheListener';\nexport * from './cacheMetrics';\n\nimport * as Context from './context';\nimport * as ResourceTree from './resource-tree';\n\nexport { Context, ResourceTree };\n"]}

package/lib/packlets/runtime/resource-tree/common.d.ts

@@ -0,0 +1,91 @@
+import { IReadOnlyResultMap, Result } from '@fgv/ts-utils';
+import { ResourceId, ResourceName } from '../../common';
+/**
+ * Interface for leaf nodes in a resource tree.
+ * Leaf nodes contain resource values and cannot have child nodes.
+ * In a valid resource tree, if a path has child resources (e.g., 'app.messages.welcome'),
+ * then that path cannot itself be a resource (i.e., 'app' cannot be both a resource and have children).
+ * @public
+ */
+export interface IReadOnlyResourceTreeLeaf<T> {
+    readonly id: ResourceId;
+    readonly name: ResourceName;
+    readonly resource: T;
+    readonly isLeaf: true;
+    readonly isBranch: false;
+    readonly isRoot: false;
+}
+/**
+ * Interface for branch nodes in a resource tree that contain child nodes.
+ * Branch nodes organize the tree structure and cannot have resource values.
+ * If a path has child resources, it must be a branch and cannot itself be a resource.
+ * @public
+ */
+export interface IReadOnlyResourceTreeBranch<T> {
+    readonly id: ResourceId;
+    readonly name: ResourceName;
+    readonly children: IReadOnlyValidatingResourceTreeChildren<T>;
+    readonly isLeaf: false;
+    readonly isBranch: true;
+    readonly isRoot: false;
+}
+/**
+ * Interface for the root node of a resource tree.
+ * @public
+ */
+export interface IReadOnlyResourceTreeRoot<T> {
+    readonly children: IReadOnlyValidatingResourceTreeChildren<T>;
+    readonly isRoot: true;
+    readonly isLeaf: false;
+    readonly isBranch: false;
+}
+/**
+ * Union type representing any node in the resource tree, which can be a leaf or a branch.
+ * This allows for flexible handling of different node types in the tree structure.
+ * @public
+ */
+export type IReadOnlyResourceTreeNode<T> = IReadOnlyResourceTreeLeaf<T> | IReadOnlyResourceTreeBranch<T>;
+/**
+ * Interface for a read-only result-based resource tree with navigation methods.
+ * @public
+ */
+export interface IReadOnlyResourceTreeChildren<T, TID extends string = ResourceId, TNAME extends string = ResourceName> extends IReadOnlyResultMap<ResourceName, IReadOnlyResourceTreeNode<T>> {
+    /**
+     * Gets a tree node by its full ResourceId path.
+     * @param id - The ResourceId path to look up
+     * @returns Result containing the node if found, or failure if not found
+     */
+    getById(id: TID): Result<IReadOnlyResourceTreeNode<T>>;
+    /**
+     * Gets a resource node by its direct name (single component).
+     * @param name - The ResourceName to look up
+     * @returns Result containing the node if it's a resource, or failure if not found or not a resource
+     */
+    getResource(name: TNAME): Result<IReadOnlyResourceTreeNode<T>>;
+    /**
+     * Gets a branch node by its direct name (single component).
+     * @param name - The ResourceName to look up
+     * @returns Result containing the node if it's a branch, or failure if not found or not a branch
+     */
+    getBranch(name: TNAME): Result<IReadOnlyResourceTreeNode<T>>;
+    /**
+     * Gets a resource leaf node by its full ResourceId path.
+     * @param id - The ResourceId path to look up
+     * @returns Result containing the leaf if found and is a resource, or failure otherwise
+     */
+    getResourceById(id: TID): Result<IReadOnlyResourceTreeLeaf<T>>;
+    /**
+     * Gets a branch node by its full ResourceId path.
+     * @param id - The ResourceId path to look up
+     * @returns Result containing the branch if found and has children, or failure otherwise
+     */
+    getBranchById(id: TID): Result<IReadOnlyResourceTreeBranch<T>>;
+}
+/**
+ * A read-only interface for accessing resource tree children using weakly-typed string keys.
+ * @public
+ */
+export interface IReadOnlyValidatingResourceTreeChildren<T> extends IReadOnlyResourceTreeChildren<T> {
+    readonly validating: IReadOnlyResourceTreeChildren<T, string, string>;
+}
+//# sourceMappingURL=common.d.ts.map

package/lib/packlets/runtime/resource-tree/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/common.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,uCAAuC,CAAC,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,uCAAuC,CAAC,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI,yBAAyB,CAAC,CAAC,CAAC,GAAG,2BAA2B,CAAC,CAAC,CAAC,CAAC;AAEzG;;;GAGG;AACH,MAAM,WAAW,6BAA6B,CAC5C,CAAC,EACD,GAAG,SAAS,MAAM,GAAG,UAAU,EAC/B,KAAK,SAAS,MAAM,GAAG,YAAY,CACnC,SAAQ,kBAAkB,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC;IACtE;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvD;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/D;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7D;;;;OAIG;IACH,eAAe,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/D;;;;OAIG;IACH,aAAa,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC;CAChE;AAED;;;GAGG;AACH,MAAM,WAAW,uCAAuC,CAAC,CAAC,CAAE,SAAQ,6BAA6B,CAAC,CAAC,CAAC;IAClG,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACvE"}

package/lib/packlets/runtime/resource-tree/common.js

@@ -0,0 +1,24 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=common.js.map

package/lib/packlets/runtime/resource-tree/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/common.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\nimport { IReadOnlyResultMap, Result } from '@fgv/ts-utils';\nimport { ResourceId, ResourceName } from '../../common';\n\n/**\n * Interface for leaf nodes in a resource tree.\n * Leaf nodes contain resource values and cannot have child nodes.\n * In a valid resource tree, if a path has child resources (e.g., 'app.messages.welcome'),\n * then that path cannot itself be a resource (i.e., 'app' cannot be both a resource and have children).\n * @public\n */\nexport interface IReadOnlyResourceTreeLeaf<T> {\n  readonly id: ResourceId;\n  readonly name: ResourceName;\n  readonly resource: T;\n  readonly isLeaf: true;\n  readonly isBranch: false;\n  readonly isRoot: false;\n}\n\n/**\n * Interface for branch nodes in a resource tree that contain child nodes.\n * Branch nodes organize the tree structure and cannot have resource values.\n * If a path has child resources, it must be a branch and cannot itself be a resource.\n * @public\n */\nexport interface IReadOnlyResourceTreeBranch<T> {\n  readonly id: ResourceId;\n  readonly name: ResourceName;\n  readonly children: IReadOnlyValidatingResourceTreeChildren<T>;\n  readonly isLeaf: false;\n  readonly isBranch: true;\n  readonly isRoot: false;\n}\n\n/**\n * Interface for the root node of a resource tree.\n * @public\n */\nexport interface IReadOnlyResourceTreeRoot<T> {\n  readonly children: IReadOnlyValidatingResourceTreeChildren<T>;\n  readonly isRoot: true;\n  readonly isLeaf: false;\n  readonly isBranch: false;\n}\n\n/**\n * Union type representing any node in the resource tree, which can be a leaf or a branch.\n * This allows for flexible handling of different node types in the tree structure.\n * @public\n */\nexport type IReadOnlyResourceTreeNode<T> = IReadOnlyResourceTreeLeaf<T> | IReadOnlyResourceTreeBranch<T>;\n\n/**\n * Interface for a read-only result-based resource tree with navigation methods.\n * @public\n */\nexport interface IReadOnlyResourceTreeChildren<\n  T,\n  TID extends string = ResourceId,\n  TNAME extends string = ResourceName\n> extends IReadOnlyResultMap<ResourceName, IReadOnlyResourceTreeNode<T>> {\n  /**\n   * Gets a tree node by its full ResourceId path.\n   * @param id - The ResourceId path to look up\n   * @returns Result containing the node if found, or failure if not found\n   */\n  getById(id: TID): Result<IReadOnlyResourceTreeNode<T>>;\n\n  /**\n   * Gets a resource node by its direct name (single component).\n   * @param name - The ResourceName to look up\n   * @returns Result containing the node if it's a resource, or failure if not found or not a resource\n   */\n  getResource(name: TNAME): Result<IReadOnlyResourceTreeNode<T>>;\n\n  /**\n   * Gets a branch node by its direct name (single component).\n   * @param name - The ResourceName to look up\n   * @returns Result containing the node if it's a branch, or failure if not found or not a branch\n   */\n  getBranch(name: TNAME): Result<IReadOnlyResourceTreeNode<T>>;\n\n  /**\n   * Gets a resource leaf node by its full ResourceId path.\n   * @param id - The ResourceId path to look up\n   * @returns Result containing the leaf if found and is a resource, or failure otherwise\n   */\n  getResourceById(id: TID): Result<IReadOnlyResourceTreeLeaf<T>>;\n\n  /**\n   * Gets a branch node by its full ResourceId path.\n   * @param id - The ResourceId path to look up\n   * @returns Result containing the branch if found and has children, or failure otherwise\n   */\n  getBranchById(id: TID): Result<IReadOnlyResourceTreeBranch<T>>;\n}\n\n/**\n * A read-only interface for accessing resource tree children using weakly-typed string keys.\n * @public\n */\nexport interface IReadOnlyValidatingResourceTreeChildren<T> extends IReadOnlyResourceTreeChildren<T> {\n  readonly validating: IReadOnlyResourceTreeChildren<T, string, string>;\n}\n"]}

package/lib/packlets/runtime/resource-tree/index.d.ts

@@ -0,0 +1,5 @@
+export * from './common';
+export * from './resourceTreeChildren';
+export * from './resourceTreeChildrenValidator';
+export * from './readOnlyResourceTree';
+//# sourceMappingURL=index.d.ts.map

package/lib/packlets/runtime/resource-tree/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/index.ts"],"names":[],"mappings":"AAsBA,cAAc,UAAU,CAAC;AACzB,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC"}

package/lib/packlets/runtime/resource-tree/index.js

@@ -0,0 +1,42 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./common"), exports);
+__exportStar(require("./resourceTreeChildren"), exports);
+__exportStar(require("./resourceTreeChildrenValidator"), exports);
+__exportStar(require("./readOnlyResourceTree"), exports);
+//# sourceMappingURL=index.js.map

package/lib/packlets/runtime/resource-tree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,yDAAuC;AACvC,kEAAgD;AAChD,yDAAuC","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\nexport * from './common';\nexport * from './resourceTreeChildren';\nexport * from './resourceTreeChildrenValidator';\nexport * from './readOnlyResourceTree';\n"]}