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

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

@@ -0,0 +1,88 @@
+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';
+/**
+ * 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 {
+    /**
+     * 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<IResource>;
+    /**
+     * 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, IResource>;
+    /**
+     * 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;AAEjE;;;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;IAC/B;;;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,SAAS,CAAC,CAAC;IAEhD;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,4BAA4B,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAEzF;;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';\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 {\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<IResource>;\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, IResource>;\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"]}

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

@@ -0,0 +1,141 @@
+import { Result } from '@fgv/ts-utils';
+import { ResourceId, ResourceName } from '../../common';
+import { IReadOnlyResourceTreeLeaf, IReadOnlyResourceTreeBranch, IReadOnlyResourceTreeRoot, IReadOnlyValidatingResourceTreeChildren } from './common';
+/**
+ * Interface for initializing a resource tree root with child nodes.
+ * @public
+ */
+export interface IResourceTreeRootInit<T> {
+    readonly children: Record<ResourceName, ResourceTreeNodeInit<T>>;
+}
+/**
+ * Interface for initializing a leaf node with a resource value.
+ * @public
+ */
+export interface IResourceTreeLeafInit<T> {
+    readonly resource: T;
+}
+/**
+ * Interface for initializing a branch node with child nodes.
+ * @public
+ */
+export interface IResourceTreeBranchInit<T> {
+    readonly children: Record<ResourceName, ResourceTreeNodeInit<T>>;
+}
+/**
+ * Union type for tree node initialization data.
+ * @public
+ */
+export type ResourceTreeNodeInit<T> = IResourceTreeLeafInit<T> | IResourceTreeBranchInit<T>;
+/**
+ * Type guard to determine if an init object represents a branch or root with children.
+ * @param init - The initialization object to test
+ * @returns True if the init object has children property
+ * @public
+ */
+export declare function isResourceTreeRootOrNodeInit<T>(init: ResourceTreeNodeInit<T> | IResourceTreeRootInit<T>): init is IResourceTreeBranchInit<T>;
+/**
+ * Type guard to determine if an init object represents a leaf node with a resource.
+ * @param init - The initialization object to test
+ * @returns True if the init object has a resource but no children
+ * @public
+ */
+export declare function isResourceTreeLeafInit<T>(init: ResourceTreeNodeInit<T>): init is IResourceTreeLeafInit<T>;
+/**
+ * Implementation of a read-only resource tree leaf node that contains a resource value.
+ * Leaf nodes represent the actual resources in the tree and cannot have children.
+ * @public
+ */
+export declare class ReadOnlyResourceTreeLeaf<T> implements IReadOnlyResourceTreeLeaf<T> {
+    readonly name: ResourceName;
+    readonly id: ResourceId;
+    readonly resource: T;
+    get isRoot(): false;
+    get isBranch(): false;
+    get isLeaf(): true;
+    /**
+     * Creates a new leaf node. Use the static create method instead.
+     * @param name - The name of this node (last segment of the path)
+     * @param parentPath - The path to the parent node (undefined for root-level nodes)
+     * @param resource - The resource value stored in this leaf
+     */
+    protected constructor(name: ResourceName, parentPath: ResourceId | undefined, resource: T);
+    /**
+     * Creates a new ReadOnlyResourceTreeLeaf instance.
+     * @param name - The name of this node (last segment of the path)
+     * @param parentPath - The path to the parent node (undefined for root-level nodes)
+     * @param resource - The resource value to store in this leaf
+     * @returns Result containing the new leaf node or failure if construction fails
+     */
+    static create<T>(name: ResourceName, parentPath: ResourceId | undefined, resource: T): Result<ReadOnlyResourceTreeLeaf<T>>;
+}
+/**
+ * Implementation of a read-only resource tree branch node that contains child nodes.
+ * Branch nodes organize other nodes in a hierarchical structure and may optionally contain a resource value.
+ * @public
+ */
+export declare class ReadOnlyResourceTreeBranch<T> implements IReadOnlyResourceTreeBranch<T> {
+    readonly children: IReadOnlyValidatingResourceTreeChildren<T>;
+    readonly name: ResourceName;
+    readonly id: ResourceId;
+    get isRoot(): false;
+    get isBranch(): true;
+    get isLeaf(): false;
+    /**
+     * Creates a new branch node. Use the static create method instead.
+     * @param name - The name of this node (last segment of the path)
+     * @param parentPath - The path to the parent node (undefined for root-level nodes)
+     * @param init - Initialization data containing child nodes
+     */
+    private constructor();
+    /**
+     * Creates a new ReadOnlyResourceTreeBranch instance.
+     * @param childName - The name of this node (last segment of the path)
+     * @param path - The path to the parent node (undefined for root-level nodes)
+     * @param childInit - Initialization data containing child nodes
+     * @returns Result containing the new branch node or failure if construction fails
+     */
+    static create<T>(childName: ResourceName, path: ResourceId | undefined, childInit: IResourceTreeBranchInit<T>): Result<ReadOnlyResourceTreeBranch<T>>;
+}
+/**
+ * Union type representing any node in a read-only resource tree.
+ * @public
+ */
+export type ReadOnlyResourceTreeNode<T> = ReadOnlyResourceTreeBranch<T> | ReadOnlyResourceTreeLeaf<T>;
+/**
+ * Implementation of a read-only resource tree root that organizes resources hierarchically.
+ * The root provides the entry point for tree navigation and resource access by ResourceId paths.
+ * @public
+ */
+export declare class ReadOnlyResourceTreeRoot<T> implements IReadOnlyResourceTreeRoot<T> {
+    readonly children: IReadOnlyValidatingResourceTreeChildren<T>;
+    get isRoot(): true;
+    get isBranch(): false;
+    get isLeaf(): false;
+    /**
+     * Creates a new root node. Use the static create method instead.
+     * @param init - Initialization data containing child nodes
+     */
+    protected constructor(init: IResourceTreeRootInit<T>);
+    /**
+     * Creates a new ReadOnlyResourceTreeRoot from an array of resources.
+     * @param resources - Array of [ResourceId, resource] pairs to build the tree from
+     * @returns Result containing the new root or failure if construction fails
+     */
+    static create<T>(resources: [ResourceId, T][]): Result<ReadOnlyResourceTreeRoot<T>>;
+    /**
+     * Creates a new ReadOnlyResourceTreeRoot from initialization data.
+     * @param init - Tree initialization structure
+     * @returns Result containing the new root or failure if construction fails
+     */
+    static create<T>(init: IResourceTreeRootInit<T>): Result<ReadOnlyResourceTreeRoot<T>>;
+    /**
+     * Converts an array of resources into tree initialization data.
+     * Validates that resource paths do not conflict - if a path has child resources,
+     * it cannot itself be a resource (e.g., if 'app.messages.welcome' exists, then 'app' cannot be a resource).
+     * @param resources - Array of [ResourceId, resource] pairs to convert
+     * @returns Result containing the initialization structure or failure if validation fails
+     */
+    static createResourceTreeInit<T>(resources: [ResourceId, T][]): Result<IResourceTreeRootInit<T>>;
+}
+//# sourceMappingURL=readOnlyResourceTree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readOnlyResourceTree.d.ts","sourceRoot":"","sources":["../../../../src/packlets/runtime/resource-tree/readOnlyResourceTree.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAqB,MAAM,EAAsC,MAAM,eAAe,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,YAAY,EAAW,MAAM,cAAc,CAAC;AACjE,OAAO,EAEL,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,uCAAuC,EACxC,MAAM,UAAU,CAAC;AAGlB;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;CAClE;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;CAClE;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC,CAAC,CAAC;AAG5F;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,EAC5C,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,GACvD,IAAI,IAAI,uBAAuB,CAAC,CAAC,CAAC,CAEpC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,qBAAqB,CAAC,CAAC,CAAC,CAEzG;AAED;;;;GAIG;AACH,qBAAa,wBAAwB,CAAC,CAAC,CAAE,YAAW,yBAAyB,CAAC,CAAC,CAAC;IAC9E,SAAgB,IAAI,EAAE,YAAY,CAAC;IACnC,SAAgB,EAAE,EAAE,UAAU,CAAC;IAC/B,SAAgB,QAAQ,EAAE,CAAC,CAAC;IAE5B,IAAW,MAAM,IAAI,KAAK,CAEzB;IAED,IAAW,QAAQ,IAAI,KAAK,CAE3B;IAED,IAAW,MAAM,IAAI,IAAI,CAExB;IAED;;;;;OAKG;IACH,SAAS,aAAa,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC;IAMzF;;;;;;OAMG;WACW,MAAM,CAAC,CAAC,EACpB,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,QAAQ,EAAE,CAAC,GACV,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC;CAGvC;AAED;;;;GAIG;AACH,qBAAa,0BAA0B,CAAC,CAAC,CAAE,YAAW,2BAA2B,CAAC,CAAC,CAAC;IAClF,SAAgB,QAAQ,EAAE,uCAAuC,CAAC,CAAC,CAAC,CAAC;IACrE,SAAgB,IAAI,EAAE,YAAY,CAAC;IACnC,SAAgB,EAAE,EAAE,UAAU,CAAC;IAE/B,IAAW,MAAM,IAAI,KAAK,CAEzB;IAED,IAAW,QAAQ,IAAI,IAAI,CAE1B;IAED,IAAW,MAAM,IAAI,KAAK,CAEzB;IAED;;;;;OAKG;IACH,OAAO;IA4BP;;;;;;OAMG;WACW,MAAM,CAAC,CAAC,EACpB,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,SAAS,EAAE,uBAAuB,CAAC,CAAC,CAAC,GACpC,MAAM,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC;CAGzC;AAED;;;GAGG;AACH,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI,0BAA0B,CAAC,CAAC,CAAC,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC;AAEtG;;;;GAIG;AACH,qBAAa,wBAAwB,CAAC,CAAC,CAAE,YAAW,yBAAyB,CAAC,CAAC,CAAC;IAC9E,SAAgB,QAAQ,EAAE,uCAAuC,CAAC,CAAC,CAAC,CAAC;IAErE,IAAW,MAAM,IAAI,IAAI,CAExB;IAED,IAAW,QAAQ,IAAI,KAAK,CAE3B;IAED,IAAW,MAAM,IAAI,KAAK,CAEzB;IAED;;;OAGG;IACH,SAAS,aAAa,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAqBpD;;;;OAIG;WACW,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAE1F;;;;OAIG;WACW,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAkB5F;;;;;;OAMG;WACW,sBAAsB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;CA6CxG"}