@hashicorp/kits 0.1.0

package/dist/resolution/primitives-registry.js

@@ -0,0 +1,295 @@
+/**
+ * Primitives registry loader and query interface.
+ *
+ * Provides functionality to load the primitives.json file and query
+ * primitives by type and name.
+ */
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+/**
+ * Error thrown when the primitives registry cannot be loaded.
+ */
+export class PrimitivesRegistryError extends Error {
+    errorCause;
+    constructor(message, cause) {
+        super(message);
+        this.name = "PrimitivesRegistryError";
+        this.errorCause = cause;
+    }
+}
+/**
+ * Wrapper class for querying the primitives registry.
+ */
+export class PrimitivesRegistryLoader {
+    registry = null;
+    basePath;
+    constructor(basePath) {
+        this.basePath = basePath;
+    }
+    /**
+     * Loads the primitives registry from the repository.
+     *
+     * @returns The loaded primitives registry
+     * @throws PrimitivesRegistryError if loading fails
+     */
+    async load() {
+        if (this.registry) {
+            return this.registry;
+        }
+        const registryPath = path.join(this.basePath, "primitives.json");
+        if (!existsSync(registryPath)) {
+            // Return empty registry if file doesn't exist
+            this.registry = {
+                schemaVersion: "1.0.0",
+                primitives: {},
+            };
+            return this.registry;
+        }
+        try {
+            const content = await readFile(registryPath, "utf-8");
+            this.registry = JSON.parse(content);
+            return this.registry;
+        }
+        catch (error) {
+            throw new PrimitivesRegistryError(`Failed to load primitives registry from ${registryPath}`, error);
+        }
+    }
+    /**
+     * Gets the loaded registry, loading it if necessary.
+     */
+    async getRegistry() {
+        if (!this.registry) {
+            return this.load();
+        }
+        return this.registry;
+    }
+    /**
+     * Checks if the registry has been loaded.
+     */
+    isLoaded() {
+        return this.registry !== null;
+    }
+    /**
+     * Gets the base path for resolving primitive paths.
+     */
+    getBasePath() {
+        return this.basePath;
+    }
+    /**
+     * Gets a primitive entry by type and name.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @returns The primitive entry or null if not found
+     */
+    async getPrimitive(type, name) {
+        const registry = await this.getRegistry();
+        const primitivesByType = registry.primitives[type];
+        if (!primitivesByType) {
+            return null;
+        }
+        return primitivesByType[name] || null;
+    }
+    /**
+     * Gets all available versions for a primitive.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @returns Array of version entries, sorted newest first
+     */
+    async getVersions(type, name) {
+        const entry = await this.getPrimitive(type, name);
+        if (!entry) {
+            return [];
+        }
+        // Return versions sorted by semver (newest first)
+        return [...entry.versions].sort((a, b) => {
+            return compareVersions(b.version, a.version);
+        });
+    }
+    /**
+     * Gets the version strings for a primitive.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @returns Array of version strings
+     */
+    async getVersionStrings(type, name) {
+        const versions = await this.getVersions(type, name);
+        return versions.map((v) => v.version);
+    }
+    /**
+     * Gets the latest version for a primitive.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @returns The latest version string or null if not found
+     */
+    async getLatestVersion(type, name) {
+        const entry = await this.getPrimitive(type, name);
+        return entry?.latest || null;
+    }
+    /**
+     * Gets a specific version entry for a primitive.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @param version - The exact version string
+     * @returns The version entry or null if not found
+     */
+    async getVersion(type, name, version) {
+        const entry = await this.getPrimitive(type, name);
+        if (!entry) {
+            return null;
+        }
+        return entry.versions.find((v) => v.version === version) || null;
+    }
+    /**
+     * Resolves the full path to a primitive version's content.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @param version - The version string
+     * @returns The absolute path to the primitive content or null if not found
+     */
+    async resolvePath(type, name, version) {
+        const entry = await this.getPrimitive(type, name);
+        if (!entry) {
+            return null;
+        }
+        const versionEntry = entry.versions.find((v) => v.version === version);
+        if (!versionEntry) {
+            return null;
+        }
+        // Combine base path + primitive path + version path
+        return path.join(this.basePath, entry.path, versionEntry.path);
+    }
+    /**
+     * Gets version resolution result with full path information.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @param version - The exact version string
+     * @returns The version resolution result or null if not found
+     */
+    async getVersionResolution(type, name, version) {
+        const entry = await this.getPrimitive(type, name);
+        if (!entry) {
+            return null;
+        }
+        const versionEntry = entry.versions.find((v) => v.version === version);
+        if (!versionEntry) {
+            return null;
+        }
+        return {
+            version: versionEntry.version,
+            path: path.join(this.basePath, entry.path, versionEntry.path),
+            released: versionEntry.released,
+            changelog: versionEntry.changelog,
+        };
+    }
+    /**
+     * Checks if a primitive exists in the registry.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @returns True if the primitive exists
+     */
+    async hasPrimitive(type, name) {
+        const entry = await this.getPrimitive(type, name);
+        return entry !== null;
+    }
+    /**
+     * Lists all primitives of a given type.
+     *
+     * @param type - The primitive type
+     * @returns Array of primitive names
+     */
+    async listPrimitives(type) {
+        const registry = await this.getRegistry();
+        const primitivesByType = registry.primitives[type];
+        if (!primitivesByType) {
+            return [];
+        }
+        return Object.keys(primitivesByType);
+    }
+    /**
+     * Lists all primitives across all types.
+     *
+     * @returns Map of type to primitive names
+     */
+    async listAllPrimitives() {
+        const registry = await this.getRegistry();
+        const result = new Map();
+        for (const [type, primitives] of Object.entries(registry.primitives)) {
+            if (primitives) {
+                result.set(type, Object.keys(primitives));
+            }
+        }
+        return result;
+    }
+}
+/**
+ * Compares two semver version strings.
+ *
+ * @returns Negative if a < b, positive if a > b, zero if equal
+ */
+function compareVersions(a, b) {
+    const partsA = parseVersionParts(a);
+    const partsB = parseVersionParts(b);
+    // Compare major, minor, patch
+    for (let i = 0; i < 3; i++) {
+        const partA = partsA[i];
+        const partB = partsB[i];
+        if (partA !== partB) {
+            return partA - partB;
+        }
+    }
+    // Handle prerelease comparison
+    const preA = partsA[3];
+    const preB = partsB[3];
+    // No prerelease > has prerelease
+    if (preA === "" && preB !== "")
+        return 1;
+    if (preA !== "" && preB === "")
+        return -1;
+    if (preA === preB)
+        return 0;
+    // Lexicographic comparison for prerelease
+    return preA.localeCompare(preB);
+}
+/**
+ * Parses version string into [major, minor, patch, prerelease] parts.
+ */
+function parseVersionParts(version) {
+    // Remove leading 'v' if present
+    const v = version.startsWith("v") ? version.slice(1) : version;
+    // Split on hyphen to separate prerelease
+    const splitResult = v.split("-", 2);
+    const mainPart = splitResult[0] ?? "";
+    const prerelease = splitResult[1] ?? "";
+    // Split main part into major.minor.patch
+    const parts = mainPart.split(".").map(Number);
+    return [parts[0] ?? 0, parts[1] ?? 0, parts[2] ?? 0, prerelease];
+}
+/**
+ * Creates a new primitives registry loader.
+ *
+ * @param basePath - The base path to the kit repository
+ * @returns A new PrimitivesRegistryLoader instance
+ */
+export function createPrimitivesRegistry(basePath) {
+    return new PrimitivesRegistryLoader(basePath);
+}
+/**
+ * Loads a primitives registry from a repository path.
+ *
+ * @param basePath - The base path to the kit repository
+ * @returns The loaded primitives registry
+ */
+export async function loadPrimitivesRegistry(basePath) {
+    const loader = createPrimitivesRegistry(basePath);
+    return loader.load();
+}
+//# sourceMappingURL=primitives-registry.js.map

package/dist/resolution/primitives-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives-registry.js","sourceRoot":"","sources":["../../src/resolution/primitives-registry.ts"],"names":[],"mappings":"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"}

package/dist/resolution/reference-parser.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Primitive reference parser.
+ *
+ * Parses primitive references in the format `name@version-spec` into
+ * structured components for version resolution.
+ */
+import type { ParsedReference, ParsedVersionSpec } from "./types.js";
+/**
+ * Error thrown when a primitive reference cannot be parsed.
+ */
+export declare class ReferenceParseError extends Error {
+    readonly reference: string;
+    constructor(reference: string, message: string);
+}
+/**
+ * Parses a primitive reference string into its components.
+ *
+ * Supported formats:
+ * - `name@1.2.3` - Exact version
+ * - `name@^1.2.3` - Caret range (compatible with)
+ * - `name@~1.2.3` - Tilde range (approximately)
+ * - `name@>=1.0.0 <2.0.0` - Range
+ * - `name@1.x` or `name@1` - Wildcard
+ * - `name@latest` - Latest version
+ *
+ * @param reference - The reference string to parse (e.g., "tf-plan@^1.0.0")
+ * @returns Parsed reference with name and version spec
+ * @throws ReferenceParseError if the reference format is invalid
+ */
+export declare function parseReference(reference: string): ParsedReference;
+/**
+ * Validates a primitive name follows naming conventions.
+ *
+ * Names must be:
+ * - Lowercase kebab-case
+ * - 3-50 characters
+ * - Start with a letter
+ * - Contain only letters, numbers, and hyphens
+ */
+export declare function isValidPrimitiveName(name: string): boolean;
+/**
+ * Validates a version specification string.
+ */
+export declare function isValidVersionSpec(spec: string): boolean;
+/**
+ * Parses a version specification into its type and raw value.
+ */
+export declare function parseVersionSpec(spec: string): ParsedVersionSpec;
+/**
+ * Formats a parsed reference back to string format.
+ */
+export declare function formatReference(parsed: ParsedReference): string;
+/**
+ * Extracts the primitive name from a reference string without full validation.
+ * Useful for quick lookups where full parsing isn't needed.
+ */
+export declare function extractName(reference: string): string | null;
+/**
+ * Extracts the version spec from a reference string without full validation.
+ */
+export declare function extractVersionSpec(reference: string): string | null;
+//# sourceMappingURL=reference-parser.d.ts.map

package/dist/resolution/reference-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-parser.d.ts","sourceRoot":"","sources":["../../src/resolution/reference-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErE;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM,EACjC,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CA0CjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAoCxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAwChE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWnE"}

package/dist/resolution/reference-parser.js

@@ -0,0 +1,182 @@
+/**
+ * Primitive reference parser.
+ *
+ * Parses primitive references in the format `name@version-spec` into
+ * structured components for version resolution.
+ */
+/**
+ * Error thrown when a primitive reference cannot be parsed.
+ */
+export class ReferenceParseError extends Error {
+    reference;
+    constructor(reference, message) {
+        super(message);
+        this.reference = reference;
+        this.name = "ReferenceParseError";
+    }
+}
+/**
+ * Parses a primitive reference string into its components.
+ *
+ * Supported formats:
+ * - `name@1.2.3` - Exact version
+ * - `name@^1.2.3` - Caret range (compatible with)
+ * - `name@~1.2.3` - Tilde range (approximately)
+ * - `name@>=1.0.0 <2.0.0` - Range
+ * - `name@1.x` or `name@1` - Wildcard
+ * - `name@latest` - Latest version
+ *
+ * @param reference - The reference string to parse (e.g., "tf-plan@^1.0.0")
+ * @returns Parsed reference with name and version spec
+ * @throws ReferenceParseError if the reference format is invalid
+ */
+export function parseReference(reference) {
+    if (!reference || typeof reference !== "string") {
+        throw new ReferenceParseError(reference, "Reference must be a non-empty string");
+    }
+    const trimmed = reference.trim();
+    // Find the @ separator (last occurrence to handle edge cases)
+    const atIndex = trimmed.lastIndexOf("@");
+    if (atIndex === -1) {
+        throw new ReferenceParseError(reference, `Invalid reference format: missing "@" separator. Expected format: name@version-spec`);
+    }
+    if (atIndex === 0) {
+        throw new ReferenceParseError(reference, `Invalid reference format: missing primitive name before "@"`);
+    }
+    if (atIndex === trimmed.length - 1) {
+        throw new ReferenceParseError(reference, `Invalid reference format: missing version spec after "@"`);
+    }
+    const name = trimmed.substring(0, atIndex).trim();
+    const versionSpec = trimmed.substring(atIndex + 1).trim();
+    // Validate name
+    if (!isValidPrimitiveName(name)) {
+        throw new ReferenceParseError(reference, `Invalid primitive name "${name}": must be lowercase kebab-case (3-50 characters, letters, numbers, hyphens)`);
+    }
+    // Validate version spec
+    if (!isValidVersionSpec(versionSpec)) {
+        throw new ReferenceParseError(reference, `Invalid version spec "${versionSpec}": unrecognized format`);
+    }
+    return { name, versionSpec };
+}
+/**
+ * Validates a primitive name follows naming conventions.
+ *
+ * Names must be:
+ * - Lowercase kebab-case
+ * - 3-50 characters
+ * - Start with a letter
+ * - Contain only letters, numbers, and hyphens
+ */
+export function isValidPrimitiveName(name) {
+    if (!name || name.length < 3 || name.length > 50) {
+        return false;
+    }
+    // Lowercase kebab-case: starts with letter, contains letters, numbers, hyphens
+    const pattern = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+    return pattern.test(name);
+}
+/**
+ * Validates a version specification string.
+ */
+export function isValidVersionSpec(spec) {
+    if (!spec)
+        return false;
+    // Check for known patterns
+    const patterns = [
+        /^latest$/i, // latest keyword
+        /^\d+\.\d+\.\d+$/, // exact: 1.2.3
+        /^\d+\.\d+\.\d+-[\w.]+$/, // exact with prerelease: 1.2.3-beta.1
+        /^\^[\d.]+/, // caret: ^1.2.3, ^1.2, ^1
+        /^~[\d.]+/, // tilde: ~1.2.3, ~1.2
+        /^>=?[\d.]+/, // range start: >=1.0.0, >1.0.0
+        /^<=?[\d.]+/, // range start: <=1.0.0, <1.0.0
+        /^\d+\.x$/, // wildcard: 1.x
+        /^\d+$/, // wildcard: 1
+        /^\d+\.\d+$/, // partial: 1.2
+        /^\*$/, // any version
+    ];
+    // Check if any pattern matches
+    if (patterns.some((p) => p.test(spec))) {
+        return true;
+    }
+    // Check for range expressions (>=1.0.0 <2.0.0)
+    if (spec.includes(" ")) {
+        const parts = spec.split(/\s+/);
+        return parts.every((part) => isValidVersionSpec(part));
+    }
+    // Check for || ranges
+    if (spec.includes("||")) {
+        const parts = spec.split(/\s*\|\|\s*/);
+        return parts.every((part) => isValidVersionSpec(part));
+    }
+    return false;
+}
+/**
+ * Parses a version specification into its type and raw value.
+ */
+export function parseVersionSpec(spec) {
+    const trimmed = spec.trim();
+    // Check for latest keyword
+    if (trimmed.toLowerCase() === "latest") {
+        return { type: "latest", raw: trimmed };
+    }
+    // Check for exact version (x.y.z or x.y.z-prerelease)
+    if (/^\d+\.\d+\.\d+(-[\w.]+)?$/.test(trimmed)) {
+        return { type: "exact", raw: trimmed };
+    }
+    // Check for caret range (^x.y.z)
+    if (trimmed.startsWith("^")) {
+        return { type: "caret", raw: trimmed };
+    }
+    // Check for tilde range (~x.y.z)
+    if (trimmed.startsWith("~")) {
+        return { type: "tilde", raw: trimmed };
+    }
+    // Check for range expressions (contains comparison operators or multiple parts)
+    if (trimmed.startsWith(">") ||
+        trimmed.startsWith("<") ||
+        trimmed.includes(" ") ||
+        trimmed.includes("||")) {
+        return { type: "range", raw: trimmed };
+    }
+    // Check for wildcard (1.x, 1, *, 1.2)
+    if (/^(\d+\.x|\d+|\*|\d+\.\d+)$/.test(trimmed)) {
+        return { type: "wildcard", raw: trimmed };
+    }
+    // Default to treating as a range
+    return { type: "range", raw: trimmed };
+}
+/**
+ * Formats a parsed reference back to string format.
+ */
+export function formatReference(parsed) {
+    return `${parsed.name}@${parsed.versionSpec}`;
+}
+/**
+ * Extracts the primitive name from a reference string without full validation.
+ * Useful for quick lookups where full parsing isn't needed.
+ */
+export function extractName(reference) {
+    if (!reference || typeof reference !== "string") {
+        return null;
+    }
+    const atIndex = reference.lastIndexOf("@");
+    if (atIndex <= 0) {
+        return null;
+    }
+    return reference.substring(0, atIndex).trim();
+}
+/**
+ * Extracts the version spec from a reference string without full validation.
+ */
+export function extractVersionSpec(reference) {
+    if (!reference || typeof reference !== "string") {
+        return null;
+    }
+    const atIndex = reference.lastIndexOf("@");
+    if (atIndex === -1 || atIndex === reference.length - 1) {
+        return null;
+    }
+    return reference.substring(atIndex + 1).trim();
+}
+//# sourceMappingURL=reference-parser.js.map

package/dist/resolution/reference-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-parser.js","sourceRoot":"","sources":["../../src/resolution/reference-parser.ts"],"names":[],"mappings":"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"}

package/dist/resolution/types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Primitive resolution type definitions.
+ *
+ * These types support resolving primitive references from kit manifests
+ * to concrete versions in the shared primitives library.
+ */
+import type { PrimitiveType, ResolvedPrimitive } from "../core/types.js";
+/**
+ * Parsed primitive reference.
+ */
+export interface ParsedReference {
+    name: string;
+    versionSpec: string;
+}
+/**
+ * Error during primitive resolution.
+ */
+export interface ResolutionError {
+    type: "not-found" | "no-matching-version" | "invalid-reference" | "invalid-hook-program" | "invalid-hook-binding";
+    primitive: string;
+    message: string;
+    available?: string[];
+}
+/**
+ * Result of resolving primitives for a single kit.
+ */
+export interface KitResolutionResult {
+    kit: string;
+    primitives: ResolvedPrimitive[];
+    errors: ResolutionError[];
+}
+/**
+ * Result of resolving primitives across multiple kits.
+ */
+export interface MultiKitResolutionResult {
+    /**
+     * All resolved primitives deduplicated by type:name.
+     */
+    allPrimitives: Map<string, ResolvedPrimitive>;
+    /**
+     * Primitives per kit (may reference same resolved primitives).
+     */
+    kitPrimitives: Map<string, ResolvedPrimitive[]>;
+    /**
+     * Primitives shared across multiple kits.
+     */
+    sharedPrimitives: Map<string, string[]>;
+    /**
+     * All resolution errors.
+     */
+    errors: ResolutionError[];
+}
+/**
+ * Version resolution result.
+ */
+export interface VersionResolutionResult {
+    version: string;
+    path: string;
+    released: string;
+    changelog: string;
+}
+/**
+ * Supported version spec formats.
+ */
+export type VersionSpecType = "exact" | "caret" | "tilde" | "range" | "wildcard" | "latest";
+/**
+ * Parsed version specification.
+ */
+export interface ParsedVersionSpec {
+    type: VersionSpecType;
+    raw: string;
+}
+/**
+ * Creates a primitive key for deduplication.
+ */
+export declare function createPrimitiveKey(type: PrimitiveType, name: string): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/resolution/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resolution/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EACA,WAAW,GACX,qBAAqB,GACrB,mBAAmB,GACnB,sBAAsB,GACtB,sBAAsB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAE9C;;OAEG;IACH,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAEhD;;OAEG;IACH,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAExC;;OAEG;IACH,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,UAAU,GACV,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5E"}

package/dist/resolution/types.js

@@ -0,0 +1,13 @@
+/**
+ * Primitive resolution type definitions.
+ *
+ * These types support resolving primitive references from kit manifests
+ * to concrete versions in the shared primitives library.
+ */
+/**
+ * Creates a primitive key for deduplication.
+ */
+export function createPrimitiveKey(type, name) {
+    return `${type}:${name}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/resolution/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/resolution/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0FH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAmB,EAAE,IAAY;IAClE,OAAO,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AAC3B,CAAC"}