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

package/package.json

@@ -1,76 +1,77 @@
 {
-	"name": "@fgv/ts-res",
-	"version": "4.5.0-3",
-	"description": "Multi-dimensional Resource Runtime",
-	"main": "lib/index.js",
-	"types": "dist/ts-res.d.ts",
-	"keywords": [
-		"resource",
-		"internationalization",
-		"globalization",
-		"i18n"
-	],
-	"author": "Erik Fortune",
-	"license": "MIT",
-	"bugs": {
-		"url": "https://github.com/ErikFortune/fgv/issues"
-	},
-	"homepage": "https://github.com/ErikFortune/fgv/tree/main/libraries/ts-res#readme",
-	"sideEffects": false,
-	"devDependencies": {
-		"@fgv/ts-utils": "4.5.0-3",
-		"@fgv/ts-utils-jest": "4.5.0-3",
-		"@fgv/ts-extras": "4.5.0-3",
-		"@fgv/ts-json-base": "4.5.0-3",
-		"@microsoft/api-documenter": "^7.26.17",
-		"@microsoft/api-extractor": "^7.52.1",
-		"@types/jest": "^29.5.14",
-		"@types/luxon": "^3.4.2",
-		"@types/node": "^22.13.11",
-		"@typescript-eslint/eslint-plugin": "^8.27.0",
-		"@typescript-eslint/parser": "^8.27.0",
-		"eslint": "^8.57.0",
-		"eslint-config-prettier": "^10.1.1",
-		"eslint-plugin-import": "^2.31.0",
-		"eslint-plugin-node": "^11.1.0",
-		"eslint-plugin-prettier": "^5.2.3",
-		"eslint-plugin-promise": "^7.2.1",
-		"jest": "^29.7.0",
-		"prettier": "^3.5.3",
-		"rimraf": "^6.0.1",
-		"ts-jest": "^29.2.6",
-		"ts-node": "^10.9.2",
-		"typescript": "^5.8.2",
-		"eslint-plugin-n": "^17.16.2",
-		"@rushstack/eslint-config": "~4.3.0",
-		"@rushstack/heft": "~0.71.0",
-		"@rushstack/heft-jest-plugin": "~0.15.2",
-		"@rushstack/heft-node-rig": "~2.8.2",
-		"@types/heft-jest": "1.0.6",
-		"eslint-plugin-tsdoc": "~0.4.0",
-		"@fgv/ts-bcp47": "4.5.0-3",
-		"@fgv/ts-json": "4.5.0-3"
-	},
-	"dependencies": {
-		"luxon": "^3.5.0"
-	},
-	"peerDependencies": {
-		"@fgv/ts-utils": "4.5.0-3",
-		"@fgv/ts-extras": "4.5.0-3",
-		"@fgv/ts-json-base": "4.5.0-3",
-		"@fgv/ts-bcp47": "4.5.0-3",
-		"@fgv/ts-json": "4.5.0-3"
-	},
-	"scripts": {
-		"build": "heft build --clean",
-		"clean": "heft clean",
-		"test": "heft test --clean",
-		"build-docs": "api-documenter markdown --input-folder ./temp --output-folder docs",
-		"build-all": "rushx build; rushx build-docs",
-		"test-handles": "jest --runInBand --detectOpenHandles",
-		"clean-jest": "jest --clear-cache",
-		"coverage": "jest --coverage",
-		"lint": "eslint src --ext .ts",
-		"fixlint": "eslint src --ext .ts --fix"
-	}
-}
+  "name": "@fgv/ts-res",
+  "version": "5.0.0-0",
+  "description": "Multi-dimensional Resource Runtime",
+  "main": "lib/index.js",
+  "types": "dist/ts-res.d.ts",
+  "keywords": [
+    "resource",
+    "internationalization",
+    "globalization",
+    "i18n"
+  ],
+  "author": "Erik Fortune",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/ErikFortune/fgv/issues"
+  },
+  "homepage": "https://github.com/ErikFortune/fgv/tree/main/libraries/ts-res#readme",
+  "sideEffects": false,
+  "devDependencies": {
+    "@microsoft/api-documenter": "^7.26.29",
+    "@microsoft/api-extractor": "^7.49.1",
+    "@types/jest": "^29.5.14",
+    "@types/luxon": "^3.6.2",
+    "@types/node": "^20.14.9",
+    "@typescript-eslint/eslint-plugin": "^7.14.1",
+    "@typescript-eslint/parser": "^7.14.1",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-prettier": "^5.5.1",
+    "eslint-plugin-promise": "^6.2.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.6.2",
+    "rimraf": "^5.0.7",
+    "ts-jest": "^29.4.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.3",
+    "eslint-plugin-n": "^16.6.2",
+    "@rushstack/eslint-config": "~4.4.0",
+    "@rushstack/heft": "~0.74.0",
+    "@rushstack/heft-jest-plugin": "~0.16.9",
+    "@rushstack/heft-node-rig": "~2.9.0",
+    "@types/heft-jest": "1.0.6",
+    "eslint-plugin-tsdoc": "~0.4.0",
+    "@fgv/ts-utils": "5.0.0-0",
+    "@fgv/ts-utils-jest": "5.0.0-0",
+    "@fgv/ts-json-base": "5.0.0-0",
+    "@fgv/ts-bcp47": "5.0.0-0",
+    "@fgv/ts-extras": "5.0.0-0",
+    "@fgv/ts-json": "5.0.0-0"
+  },
+  "dependencies": {
+    "luxon": "^3.6.1"
+  },
+  "peerDependencies": {
+    "@fgv/ts-utils": "5.0.0-0",
+    "@fgv/ts-extras": "5.0.0-0",
+    "@fgv/ts-json": "5.0.0-0",
+    "@fgv/ts-json-base": "5.0.0-0",
+    "@fgv/ts-bcp47": "5.0.0-0"
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "clean": "heft clean",
+    "test": "heft test --clean",
+    "test-ts-res": "heft test --clean",
+    "build-docs": "api-documenter markdown --input-folder ./temp --output-folder docs",
+    "build-all": "rushx build; rushx build-docs",
+    "test-handles": "heft test --detect-open-handles",
+    "clean-jest": "heft test --clean",
+    "coverage": "heft test --clean --max-workers 1 --detect-open-handles",
+    "lint": "eslint src --ext .ts",
+    "fixlint": "eslint src --ext .ts --fix"
+  }
+}

package/lib/packlets/resources/resourceManager.d.ts

@@ -1,104 +0,0 @@
-import { Collections, DetailedResult, Result, ValidatingResultMap } from '@fgv/ts-utils';
-import { ConditionCollector, ConditionSetCollector, ReadOnlyConditionCollector, ReadOnlyConditionSetCollector } from '../conditions';
-import { AbstractDecisionCollector, ReadOnlyAbstractDecisionCollector } from '../decisions';
-import { IReadOnlyQualifierCollector } from '../qualifiers';
-import { ReadOnlyResourceTypeCollector } from '../resource-types';
-import { ResourceId } from '../common';
-import { ResourceBuilder, ResourceBuilderResultDetail } from './resourceBuilder';
-import { Resource } from './resource';
-import { ResourceCandidate } from './resourceCandidate';
-import * as ResourceJson from '../resource-json';
-/**
- * Interface for parameters to the {@link Resources.ResourceManager.create | ResourceManager create method}.
- * @public
- */
-export interface IResourceManagerCreateParams {
-    qualifiers: IReadOnlyQualifierCollector;
-    resourceTypes: ReadOnlyResourceTypeCollector;
-}
-/**
- * Error details that can be returned by a {@link Resources.ResourceManager | ResourceManager}.
- * @public
- */
-export type ResourceManagerResultDetail = Collections.ResultMapResultDetail | ResourceBuilderResultDetail;
-/**
- * Represents a manager for a collection of {@link Resources.Resource | resources}.  Collects
- * {@link Resources.ResourceCandidate | candidates} for each resource into a
- * {@link Resources.ResourceBuilder | ResourceBuilder} per resource, validates them against each other,
- * and builds a collection of {@link Resources.Resource | resources} once all candidates are collected.
- * @public
- */
-export declare class ResourceManager {
-    readonly qualifiers: IReadOnlyQualifierCollector;
-    readonly resourceTypes: ReadOnlyResourceTypeCollector;
-    protected readonly _conditions: ConditionCollector;
-    protected readonly _conditionSets: ConditionSetCollector;
-    protected readonly _decisions: AbstractDecisionCollector;
-    protected readonly _resources: ValidatingResultMap<ResourceId, ResourceBuilder>;
-    protected readonly _builtResources: ValidatingResultMap<ResourceId, Resource>;
-    protected _built: boolean;
-    /**
-     * A {@link Conditions.ConditionCollector | ConditionCollector} which
-     * contains the {@link Conditions.Condition | conditions} used so far by
-     * the {@link Resources.ResourceCandidate | resource candidates} in this manager.
-     */
-    get conditions(): ReadOnlyConditionCollector;
-    /**
-     * A {@link Conditions.ConditionSetCollector | ConditionSetCollector} which
-     * contains the {@link Conditions.ConditionSet | condition sets} used so far by
-     * the {@link Resources.ResourceCandidate | resource candidates} in this manager.
-     */
-    get conditionSets(): ReadOnlyConditionSetCollector;
-    /**
-     * A {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector} which
-     * contains the {@link Decisions.Decision | abstract decisions} used so far by
-     * the {@link Resources.ResourceCandidate | resource candidates} in this manager.
-     */
-    get decisions(): ReadOnlyAbstractDecisionCollector;
-    /**
-     * A read-only map of {@link Resources.ResourceBuilder | resource builders} used by the manager.
-     */
-    get resources(): Collections.IReadOnlyValidatingResultMap<ResourceId, ResourceBuilder>;
-    /**
-     * The number of {@link Resources.Resource | resources} contained by the manager.
-     */
-    get size(): number;
-    /**
-     * Constructor for a {@link Resources.ResourceManager | ResourceManager} object.
-     * @param params - Parameters to create a new {@link Resources.ResourceManager | ResourceManager}.
-     * @public
-     */
-    protected constructor(params: IResourceManagerCreateParams);
-    /**
-     * Creates a new {@link Resources.ResourceManager | ResourceManager} object.
-     * @param params - Parameters to create a new {@link Resources.ResourceManager | ResourceManager}.
-     * @returns `Success` with the new {@link Resources.ResourceManager | ResourceManager} object if successful,
-     * or `Failure` with an error message if not.
-     * @public
-     */
-    static create(params: IResourceManagerCreateParams): Result<ResourceManager>;
-    /**
-     * Given a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}, builds and adds
-     * a {@link Resources.ResourceCandidate | candidate} to the manager.
-     * @param candidate - The {@link Resources.ResourceCandidate | candidate} to add.
-     * @returns `Success` with the candidate if successful, or `Failure` with an error message if not.
-     * @public
-     */
-    addLooseCandidate(decl: ResourceJson.Json.ILooseResourceCandidateDecl): DetailedResult<ResourceCandidate, ResourceManagerResultDetail>;
-    addResource(decl: ResourceJson.Json.ILooseResourceDecl): DetailedResult<ResourceBuilder, ResourceManagerResultDetail>;
-    /**
-     * Gets an individual {@link Resources.Resource | built resource} from the manager.
-     * @param id - The {@link ResourceId | id} of the resource to get.
-     * @returns `Success` with the resource if successful, or `Failure` with an error message if not.
-     * @public
-     */
-    getBuiltResource(id: string): Result<Resource>;
-    /**
-     * Builds the {@link Resources.Resource | resources} from the collected {@link Resources.ResourceCandidate | candidates}.
-     * @returns `Success` with a read-only map of {@link Resources.Resource | resources} if successful,
-     * or `Failure` with an error message if not.
-     * @public
-     */
-    build(): Result<Collections.IReadOnlyValidatingResultMap<ResourceId, Resource>>;
-}
-//# sourceMappingURL=resourceManager.d.ts.map

package/lib/packlets/resources/resourceManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resourceManager.d.ts","sourceRoot":"","sources":["../../../src/packlets/resources/resourceManager.ts"],"names":[],"mappings":"AAsBA,OAAO,EAEL,WAAW,EACX,cAAc,EAKd,MAAM,EAGN,mBAAmB,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,0BAA0B,EAC1B,6BAA6B,EAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,yBAAyB,EAAE,iCAAiC,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAW,UAAU,EAAY,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,2BAA2B,CAAC;IACxC,aAAa,EAAE,6BAA6B,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG,WAAW,CAAC,qBAAqB,GAAG,2BAA2B,CAAC;AAE1G;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,SAAgB,UAAU,EAAE,2BAA2B,CAAC;IACxD,SAAgB,aAAa,EAAE,6BAA6B,CAAC;IAE7D,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACnD,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IACzD,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IACzD,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAChF,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9E,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC;IAE1B;;;;OAIG;IACH,IAAW,UAAU,IAAI,0BAA0B,CAElD;IAED;;;;OAIG;IACH,IAAW,aAAa,IAAI,6BAA6B,CAExD;IAED;;;;OAIG;IACH,IAAW,SAAS,IAAI,iCAAiC,CAExD;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,WAAW,CAAC,4BAA4B,CAAC,UAAU,EAAE,eAAe,CAAC,CAE5F;IAED;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;;OAIG;IACH,SAAS,aAAa,MAAM,EAAE,4BAA4B;IAwB1D;;;;;;OAMG;WACW,MAAM,CAAC,MAAM,EAAE,4BAA4B,GAAG,MAAM,CAAC,eAAe,CAAC;IAInF;;;;;;OAMG;IACI,iBAAiB,CACtB,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,2BAA2B,GAClD,cAAc,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;IA2B1D,WAAW,CAChB,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,kBAAkB,GACzC,cAAc,CAAC,eAAe,EAAE,2BAA2B,CAAC;IAsC/D;;;;;OAKG;IACI,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;IAMrD;;;;;OAKG;IACI,KAAK,IAAI,MAAM,CAAC,WAAW,CAAC,4BAA4B,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;CAcvF"}

package/lib/packlets/resources/resourceManager.js

@@ -1,201 +0,0 @@
-"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.ResourceManager = void 0;
-const ts_utils_1 = require("@fgv/ts-utils");
-const conditions_1 = require("../conditions");
-const decisions_1 = require("../decisions");
-const common_1 = require("../common");
-const resourceBuilder_1 = require("./resourceBuilder");
-const resource_1 = require("./resource");
-/**
- * Represents a manager for a collection of {@link Resources.Resource | resources}.  Collects
- * {@link Resources.ResourceCandidate | candidates} for each resource into a
- * {@link Resources.ResourceBuilder | ResourceBuilder} per resource, validates them against each other,
- * and builds a collection of {@link Resources.Resource | resources} once all candidates are collected.
- * @public
- */
-class ResourceManager {
-    /**
-     * A {@link Conditions.ConditionCollector | ConditionCollector} which
-     * contains the {@link Conditions.Condition | conditions} used so far by
-     * the {@link Resources.ResourceCandidate | resource candidates} in this manager.
-     */
-    get conditions() {
-        return this._conditions;
-    }
-    /**
-     * A {@link Conditions.ConditionSetCollector | ConditionSetCollector} which
-     * contains the {@link Conditions.ConditionSet | condition sets} used so far by
-     * the {@link Resources.ResourceCandidate | resource candidates} in this manager.
-     */
-    get conditionSets() {
-        return this._conditionSets;
-    }
-    /**
-     * A {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector} which
-     * contains the {@link Decisions.Decision | abstract decisions} used so far by
-     * the {@link Resources.ResourceCandidate | resource candidates} in this manager.
-     */
-    get decisions() {
-        return this._decisions;
-    }
-    /**
-     * A read-only map of {@link Resources.ResourceBuilder | resource builders} used by the manager.
-     */
-    get resources() {
-        return this._resources;
-    }
-    /**
-     * The number of {@link Resources.Resource | resources} contained by the manager.
-     */
-    get size() {
-        return this._resources.size;
-    }
-    /**
-     * Constructor for a {@link Resources.ResourceManager | ResourceManager} object.
-     * @param params - Parameters to create a new {@link Resources.ResourceManager | ResourceManager}.
-     * @public
-     */
-    constructor(params) {
-        this.qualifiers = params.qualifiers;
-        this.resourceTypes = params.resourceTypes;
-        this._conditions = conditions_1.ConditionCollector.create({ qualifiers: params.qualifiers }).orThrow();
-        this._conditionSets = conditions_1.ConditionSetCollector.create({ conditions: this._conditions }).orThrow();
-        this._decisions = decisions_1.AbstractDecisionCollector.create({ conditionSets: this._conditionSets }).orThrow();
-        this._resources = new ts_utils_1.ValidatingResultMap({
-            converters: new ts_utils_1.Collections.KeyValueConverters({
-                key: common_1.Convert.resourceId,
-                /* c8 ignore next 2 - defense in depth against internal error */
-                value: (from) => from instanceof resourceBuilder_1.ResourceBuilder ? (0, ts_utils_1.succeed)(from) : (0, ts_utils_1.fail)('not a resource builder')
-            })
-        });
-        this._builtResources = new ts_utils_1.ValidatingResultMap({
-            converters: new ts_utils_1.Collections.KeyValueConverters({
-                key: common_1.Convert.resourceId,
-                /* c8 ignore next 1 - defense in depth against internal error */
-                value: (from) => (from instanceof resource_1.Resource ? (0, ts_utils_1.succeed)(from) : (0, ts_utils_1.fail)('not a resource'))
-            })
-        });
-        this._built = false;
-    }
-    /**
-     * Creates a new {@link Resources.ResourceManager | ResourceManager} object.
-     * @param params - Parameters to create a new {@link Resources.ResourceManager | ResourceManager}.
-     * @returns `Success` with the new {@link Resources.ResourceManager | ResourceManager} object if successful,
-     * or `Failure` with an error message if not.
-     * @public
-     */
-    static create(params) {
-        return (0, ts_utils_1.captureResult)(() => new ResourceManager(params));
-    }
-    /**
-     * Given a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}, builds and adds
-     * a {@link Resources.ResourceCandidate | candidate} to the manager.
-     * @param candidate - The {@link Resources.ResourceCandidate | candidate} to add.
-     * @returns `Success` with the candidate if successful, or `Failure` with an error message if not.
-     * @public
-     */
-    addLooseCandidate(decl) {
-        const { value: id, message } = common_1.Validate.toResourceId(decl.id);
-        if (message !== undefined) {
-            return (0, ts_utils_1.failWithDetail)(`${id}: invalid id - ${message}`, 'failure');
-        }
-        const builderResult = this._resources.getOrAdd(id, () => resourceBuilder_1.ResourceBuilder.create({
-            id,
-            resourceTypes: this.resourceTypes,
-            conditionSets: this._conditionSets
-        }));
-        /* c8 ignore next 6 - defense in depth against internal error */
-        if (builderResult.isFailure()) {
-            return (0, ts_utils_1.failWithDetail)(`${id}: unable to get or add resource\n${builderResult.message}`, builderResult.detail);
-        }
-        return builderResult.value.addLooseCandidate(decl).onSuccess((c, d) => {
-            this._builtResources.delete(id);
-            this._built = false;
-            return (0, ts_utils_1.succeedWithDetail)(c, d);
-        });
-    }
-    addResource(decl) {
-        var _a;
-        const { value: id, message } = common_1.Validate.toResourceId(decl.id);
-        if (message !== undefined) {
-            return (0, ts_utils_1.failWithDetail)(`${id}: invalid id - ${message}`, 'failure');
-        }
-        const { value: builder, message: getOrAddMessage, detail } = this._resources.getOrAdd(id, () => resourceBuilder_1.ResourceBuilder.create({
-            id,
-            typeName: decl.resourceTypeName,
-            resourceTypes: this.resourceTypes,
-            conditionSets: this._conditionSets
-        }));
-        /* c8 ignore next 3 - defense in depth against internal error */
-        if (getOrAddMessage !== undefined) {
-            return (0, ts_utils_1.failWithDetail)(`${id}: unable to get or add resource\n${getOrAddMessage}`, detail);
-        }
-        if (detail === 'exists') {
-            const { message } = builder.setResourceType(decl.resourceTypeName);
-            if (message !== undefined) {
-                return (0, ts_utils_1.failWithDetail)(`${id}: unable to set resource type\n${message}`, 'type-mismatch');
-            }
-        }
-        const candidates = (_a = decl.candidates) !== null && _a !== void 0 ? _a : [];
-        return (0, ts_utils_1.mapResults)(candidates.map((c) => builder.addChildCandidate(c)))
-            .onSuccess(() => {
-            return (0, ts_utils_1.succeed)(builder);
-        })
-            .withDetail('failure', detail);
-    }
-    /**
-     * Gets an individual {@link Resources.Resource | built resource} from the manager.
-     * @param id - The {@link ResourceId | id} of the resource to get.
-     * @returns `Success` with the resource if successful, or `Failure` with an error message if not.
-     * @public
-     */
-    getBuiltResource(id) {
-        return this._resources.validating
-            .get(id)
-            .onSuccess((builder) => this._builtResources.validating.getOrAdd(id, () => builder.build()));
-    }
-    /**
-     * Builds the {@link Resources.Resource | resources} from the collected {@link Resources.ResourceCandidate | candidates}.
-     * @returns `Success` with a read-only map of {@link Resources.Resource | resources} if successful,
-     * or `Failure` with an error message if not.
-     * @public
-     */
-    build() {
-        if (!this._built) {
-            const errors = new ts_utils_1.MessageAggregator();
-            this._resources.forEach((r, id) => {
-                this._builtResources.getOrAdd(id, () => r.build()).aggregateError(errors);
-            });
-            /* c8 ignore next 3 - defense in depth against internal error */
-            if (errors.hasMessages) {
-                return (0, ts_utils_1.fail)(`build failed: ${errors.toString()}`);
-            }
-            this._built = true;
-        }
-        return (0, ts_utils_1.succeed)(this._builtResources);
-    }
-}
-exports.ResourceManager = ResourceManager;
-//# sourceMappingURL=resourceManager.js.map

package/lib/packlets/resources/resourceManager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resourceManager.js","sourceRoot":"","sources":["../../../src/packlets/resources/resourceManager.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport {\n  captureResult,\n  Collections,\n  DetailedResult,\n  fail,\n  failWithDetail,\n  mapResults,\n  MessageAggregator,\n  Result,\n  succeed,\n  succeedWithDetail,\n  ValidatingResultMap\n} from '@fgv/ts-utils';\nimport {\n  ConditionCollector,\n  ConditionSetCollector,\n  ReadOnlyConditionCollector,\n  ReadOnlyConditionSetCollector\n} from '../conditions';\nimport { AbstractDecisionCollector, ReadOnlyAbstractDecisionCollector } from '../decisions';\nimport { IReadOnlyQualifierCollector } from '../qualifiers';\nimport { ReadOnlyResourceTypeCollector } from '../resource-types';\nimport { Convert, ResourceId, Validate } from '../common';\nimport { ResourceBuilder, ResourceBuilderResultDetail } from './resourceBuilder';\nimport { Resource } from './resource';\nimport { ResourceCandidate } from './resourceCandidate';\nimport * as ResourceJson from '../resource-json';\n\n/**\n * Interface for parameters to the {@link Resources.ResourceManager.create | ResourceManager create method}.\n * @public\n */\nexport interface IResourceManagerCreateParams {\n  qualifiers: IReadOnlyQualifierCollector;\n  resourceTypes: ReadOnlyResourceTypeCollector;\n}\n\n/**\n * Error details that can be returned by a {@link Resources.ResourceManager | ResourceManager}.\n * @public\n */\nexport type ResourceManagerResultDetail = Collections.ResultMapResultDetail | ResourceBuilderResultDetail;\n\n/**\n * Represents a manager for a collection of {@link Resources.Resource | resources}.  Collects\n * {@link Resources.ResourceCandidate | candidates} for each resource into a\n * {@link Resources.ResourceBuilder | ResourceBuilder} per resource, validates them against each other,\n * and builds a collection of {@link Resources.Resource | resources} once all candidates are collected.\n * @public\n */\nexport class ResourceManager {\n  public readonly qualifiers: IReadOnlyQualifierCollector;\n  public readonly resourceTypes: ReadOnlyResourceTypeCollector;\n\n  protected readonly _conditions: ConditionCollector;\n  protected readonly _conditionSets: ConditionSetCollector;\n  protected readonly _decisions: AbstractDecisionCollector;\n  protected readonly _resources: ValidatingResultMap<ResourceId, ResourceBuilder>;\n  protected readonly _builtResources: ValidatingResultMap<ResourceId, Resource>;\n  protected _built: boolean;\n\n  /**\n   * A {@link Conditions.ConditionCollector | ConditionCollector} which\n   * contains the {@link Conditions.Condition | conditions} used so far by\n   * the {@link Resources.ResourceCandidate | resource candidates} in this manager.\n   */\n  public get conditions(): ReadOnlyConditionCollector {\n    return this._conditions;\n  }\n\n  /**\n   * A {@link Conditions.ConditionSetCollector | ConditionSetCollector} which\n   * contains the {@link Conditions.ConditionSet | condition sets} used so far by\n   * the {@link Resources.ResourceCandidate | resource candidates} in this manager.\n   */\n  public get conditionSets(): ReadOnlyConditionSetCollector {\n    return this._conditionSets;\n  }\n\n  /**\n   * A {@link Decisions.AbstractDecisionCollector | AbstractDecisionCollector} which\n   * contains the {@link Decisions.Decision | abstract decisions} used so far by\n   * the {@link Resources.ResourceCandidate | resource candidates} in this manager.\n   */\n  public get decisions(): ReadOnlyAbstractDecisionCollector {\n    return this._decisions;\n  }\n\n  /**\n   * A read-only map of {@link Resources.ResourceBuilder | resource builders} used by the manager.\n   */\n  public get resources(): Collections.IReadOnlyValidatingResultMap<ResourceId, ResourceBuilder> {\n    return this._resources;\n  }\n\n  /**\n   * The number of {@link Resources.Resource | resources} contained by the manager.\n   */\n  public get size(): number {\n    return this._resources.size;\n  }\n\n  /**\n   * Constructor for a {@link Resources.ResourceManager | ResourceManager} object.\n   * @param params - Parameters to create a new {@link Resources.ResourceManager | ResourceManager}.\n   * @public\n   */\n  protected constructor(params: IResourceManagerCreateParams) {\n    this.qualifiers = params.qualifiers;\n    this.resourceTypes = params.resourceTypes;\n    this._conditions = ConditionCollector.create({ qualifiers: params.qualifiers }).orThrow();\n    this._conditionSets = ConditionSetCollector.create({ conditions: this._conditions }).orThrow();\n    this._decisions = AbstractDecisionCollector.create({ conditionSets: this._conditionSets }).orThrow();\n    this._resources = new ValidatingResultMap({\n      converters: new Collections.KeyValueConverters<ResourceId, ResourceBuilder>({\n        key: Convert.resourceId,\n        /* c8 ignore next 2 - defense in depth against internal error */\n        value: (from: unknown) =>\n          from instanceof ResourceBuilder ? succeed(from) : fail('not a resource builder')\n      })\n    });\n    this._builtResources = new ValidatingResultMap({\n      converters: new Collections.KeyValueConverters<ResourceId, Resource>({\n        key: Convert.resourceId,\n        /* c8 ignore next 1 - defense in depth against internal error */\n        value: (from: unknown) => (from instanceof Resource ? succeed(from) : fail('not a resource'))\n      })\n    });\n    this._built = false;\n  }\n\n  /**\n   * Creates a new {@link Resources.ResourceManager | ResourceManager} object.\n   * @param params - Parameters to create a new {@link Resources.ResourceManager | ResourceManager}.\n   * @returns `Success` with the new {@link Resources.ResourceManager | ResourceManager} object if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public static create(params: IResourceManagerCreateParams): Result<ResourceManager> {\n    return captureResult(() => new ResourceManager(params));\n  }\n\n  /**\n   * Given a {@link ResourceJson.Json.ILooseResourceCandidateDecl | resource candidate declaration}, builds and adds\n   * a {@link Resources.ResourceCandidate | candidate} to the manager.\n   * @param candidate - The {@link Resources.ResourceCandidate | candidate} to add.\n   * @returns `Success` with the candidate if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public addLooseCandidate(\n    decl: ResourceJson.Json.ILooseResourceCandidateDecl\n  ): DetailedResult<ResourceCandidate, ResourceManagerResultDetail> {\n    const { value: id, message } = Validate.toResourceId(decl.id);\n    if (message !== undefined) {\n      return failWithDetail(`${id}: invalid id - ${message}`, 'failure');\n    }\n\n    const builderResult = this._resources.getOrAdd(id, () =>\n      ResourceBuilder.create({\n        id,\n        resourceTypes: this.resourceTypes,\n        conditionSets: this._conditionSets\n      })\n    );\n    /* c8 ignore next 6 - defense in depth against internal error */\n    if (builderResult.isFailure()) {\n      return failWithDetail(\n        `${id}: unable to get or add resource\\n${builderResult.message}`,\n        builderResult.detail\n      );\n    }\n    return builderResult.value.addLooseCandidate(decl).onSuccess((c, d) => {\n      this._builtResources.delete(id);\n      this._built = false;\n      return succeedWithDetail(c, d);\n    });\n  }\n\n  public addResource(\n    decl: ResourceJson.Json.ILooseResourceDecl\n  ): DetailedResult<ResourceBuilder, ResourceManagerResultDetail> {\n    const { value: id, message } = Validate.toResourceId(decl.id);\n    if (message !== undefined) {\n      return failWithDetail(`${id}: invalid id - ${message}`, 'failure');\n    }\n\n    const {\n      value: builder,\n      message: getOrAddMessage,\n      detail\n    } = this._resources.getOrAdd(id, () =>\n      ResourceBuilder.create({\n        id,\n        typeName: decl.resourceTypeName,\n        resourceTypes: this.resourceTypes,\n        conditionSets: this._conditionSets\n      })\n    );\n    /* c8 ignore next 3 - defense in depth against internal error */\n    if (getOrAddMessage !== undefined) {\n      return failWithDetail(`${id}: unable to get or add resource\\n${getOrAddMessage}`, detail);\n    }\n\n    if (detail === 'exists') {\n      const { message } = builder.setResourceType(decl.resourceTypeName);\n      if (message !== undefined) {\n        return failWithDetail(`${id}: unable to set resource type\\n${message}`, 'type-mismatch');\n      }\n    }\n\n    const candidates = decl.candidates ?? [];\n    return mapResults(candidates.map((c) => builder.addChildCandidate(c)))\n      .onSuccess(() => {\n        return succeed(builder);\n      })\n      .withDetail('failure', detail);\n  }\n\n  /**\n   * Gets an individual {@link Resources.Resource | built resource} from the manager.\n   * @param id - The {@link ResourceId | id} of the resource to get.\n   * @returns `Success` with the resource if successful, or `Failure` with an error message if not.\n   * @public\n   */\n  public getBuiltResource(id: string): Result<Resource> {\n    return this._resources.validating\n      .get(id)\n      .onSuccess((builder) => this._builtResources.validating.getOrAdd(id, () => builder.build()));\n  }\n\n  /**\n   * Builds the {@link Resources.Resource | resources} from the collected {@link Resources.ResourceCandidate | candidates}.\n   * @returns `Success` with a read-only map of {@link Resources.Resource | resources} if successful,\n   * or `Failure` with an error message if not.\n   * @public\n   */\n  public build(): Result<Collections.IReadOnlyValidatingResultMap<ResourceId, Resource>> {\n    if (!this._built) {\n      const errors: MessageAggregator = new MessageAggregator();\n      this._resources.forEach((r, id) => {\n        this._builtResources.getOrAdd(id, () => r.build()).aggregateError(errors);\n      });\n      /* c8 ignore next 3 - defense in depth against internal error */\n      if (errors.hasMessages) {\n        return fail(`build failed: ${errors.toString()}`);\n      }\n      this._built = true;\n    }\n    return succeed(this._builtResources);\n  }\n}\n"]}