@baseplate-dev/project-builder-lib 0.4.4 → 0.5.1

package/dist/plugins/spec/auth-models-spec.js

@@ -0,0 +1,16 @@
+import { createFieldMapSpec } from '../utils/create-field-map-spec.js';
+export const authModelsSpec = createFieldMapSpec('core/auth-models', (t) => ({
+    getAuthModels: t.scalar(),
+}), {
+    use: (values) => ({
+        getAuthModels: (definition) => values.getAuthModels?.(definition),
+        getAuthModelsOrThrow: (definition) => {
+            const authModels = values.getAuthModels?.(definition);
+            if (!authModels) {
+                throw new Error('Auth models not found');
+            }
+            return authModels;
+        },
+    }),
+});
+//# sourceMappingURL=auth-models-spec.js.map

package/dist/plugins/spec/auth-models-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-models-spec.js","sourceRoot":"","sources":["../../../src/plugins/spec/auth-models-spec.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAMvE,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAC9C,kBAAkB,EAClB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACN,aAAa,EAAE,CAAC,CAAC,MAAM,EAAoB;CAC5C,CAAC,EACF;IACE,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChB,aAAa,EAAE,CAAC,UAA6B,EAAE,EAAE,CAC/C,MAAM,CAAC,aAAa,EAAE,CAAC,UAAU,CAAC;QACpC,oBAAoB,EAAE,CAAC,UAA6B,EAAE,EAAE;YACtD,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC,UAAU,CAAC,CAAC;YACtD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC3C,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC;KACF,CAAC;CACH,CACF,CAAC"}

package/dist/plugins/spec/config-spec.d.ts

@@ -1,5 +1,4 @@
 import type { DefinitionSchemaCreator } from '#src/schema/index.js';
-import type { PluginSpecImplementation } from './types.js';
 export interface PluginMigrationResult {
     updatedConfig?: unknown;
     updateProjectDefinition?: (draft: unknown) => void;
@@ -16,17 +15,6 @@ export interface PluginConfigMigration {
      */
     migrate: (config: unknown, projectDefinition: unknown) => PluginMigrationResult;
 }
-/**
- * Spec for registering plugin config schema
- */
-export interface PluginConfigSpec extends PluginSpecImplementation {
-    registerSchemaCreator: (pluginKey: string, schemaCreator: DefinitionSchemaCreator) => void;
-    registerMigrations: (pluginKey: string, migrations: PluginConfigMigration[]) => void;
-    getSchemaCreator(pluginKey: string): DefinitionSchemaCreator | undefined;
-    getMigrations(pluginKey: string): PluginConfigMigration[] | undefined;
-    getLastMigrationVersion(pluginKey: string): number | undefined;
-}
-export declare function createPluginConfigImplementation(): PluginConfigSpec;
 /**
  * Spec for adding config for the plugin in the core plugin e.g.
  * {
@@ -38,5 +26,12 @@ export declare function createPluginConfigImplementation(): PluginConfigSpec;
  *  }]
  * }
  */
-export declare const pluginConfigSpec: import("./types.js").PluginSpecWithInitializer<PluginConfigSpec>;
+export declare const pluginConfigSpec: import("./types.js").PluginSpec<{
+    schemas: import("@baseplate-dev/utils").MapContainer<string, DefinitionSchemaCreator>;
+    migrations: import("@baseplate-dev/utils").MapContainer<string, PluginConfigMigration[]>;
+}, {
+    getSchemaCreator: (pluginKey: string) => DefinitionSchemaCreator | undefined;
+    getMigrations: (pluginKey: string) => PluginConfigMigration[] | undefined;
+    getLastMigrationVersion: (pluginKey: string) => number | undefined;
+}>;
 //# sourceMappingURL=config-spec.d.ts.map

package/dist/plugins/spec/config-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-spec.d.ts","sourceRoot":"","sources":["../../../src/plugins/spec/config-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAI3D,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,OAAO,EAAE,CACP,MAAM,EAAE,OAAO,EACf,iBAAiB,EAAE,OAAO,KACvB,qBAAqB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,wBAAwB;IAChE,qBAAqB,EAAE,CACrB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,uBAAuB,KACnC,IAAI,CAAC;IACV,kBAAkB,EAAE,CAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,qBAAqB,EAAE,KAChC,IAAI,CAAC;IACV,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAAC;IACzE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,EAAE,GAAG,SAAS,CAAC;IACtE,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAChE;AAoBD,wBAAgB,gCAAgC,IAAI,gBAAgB,CA+BnE;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,kEAE3B,CAAC"}
+{"version":3,"file":"config-spec.d.ts","sourceRoot":"","sources":["../../../src/plugins/spec/config-spec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAIpE,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,OAAO,EAAE,CACP,MAAM,EAAE,OAAO,EACf,iBAAiB,EAAE,OAAO,KACvB,qBAAqB,CAAC;CAC5B;AAyBD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB;;;;kCAcS,MAAM;+BACT,MAAM;yCAEI,MAAM;EAOlD,CAAC"}

package/dist/plugins/spec/config-spec.js

@@ -1,46 +1,18 @@
-import { createPluginSpec } from './types.js';
-function sortAndValidateMigrations(migrations) {
+import { mapValuesOfMap } from '@baseplate-dev/utils';
+import { createFieldMapSpec } from '../utils/create-field-map-spec.js';
+function sortAndValidateMigrations(migrations, pluginKey) {
     // make sure migrations are sorted by version and they are all unique
     const sortedMigrations = [...migrations].sort((a, b) => a.version - b.version);
     if (sortedMigrations.some((m) => m.version <= 0)) {
-        throw new Error(`Migration version must be a positive integer`);
+        throw new Error(`All migrations for plugin ${pluginKey} must have a positive version`);
     }
     for (let i = 0; i < sortedMigrations.length - 1; i++) {
         if (sortedMigrations[i].version === sortedMigrations[i + 1].version) {
-            throw new Error(`Migration versions must be unique`);
+            throw new Error(`All migrations for plugin ${pluginKey} must have a unique version`);
         }
     }
     return sortedMigrations;
 }
-export function createPluginConfigImplementation() {
-    const schemas = new Map();
-    const migrationsMap = new Map();
-    return {
-        registerSchemaCreator(pluginKey, schemaCreator) {
-            if (schemas.has(pluginKey)) {
-                throw new Error(`Schema for plugin ${pluginKey} is already registered`);
-            }
-            schemas.set(pluginKey, schemaCreator);
-        },
-        registerMigrations(pluginKey, migrations) {
-            if (migrationsMap.has(pluginKey)) {
-                throw new Error(`Migrations for plugin ${pluginKey} are already registered`);
-            }
-            const sortedMigrations = sortAndValidateMigrations(migrations);
-            migrationsMap.set(pluginKey, sortedMigrations);
-        },
-        getSchemaCreator(pluginKey) {
-            return schemas.get(pluginKey);
-        },
-        getMigrations(pluginKey) {
-            return migrationsMap.get(pluginKey);
-        },
-        getLastMigrationVersion(pluginKey) {
-            const migrations = migrationsMap.get(pluginKey);
-            return migrations?.[migrations.length - 1]?.version;
-        },
-    };
-}
 /**
  * Spec for adding config for the plugin in the core plugin e.g.
  * {
@@ -52,7 +24,20 @@ export function createPluginConfigImplementation() {
  *  }]
  * }
  */
-export const pluginConfigSpec = createPluginSpec('core/plugin-config', {
-    defaultInitializer: createPluginConfigImplementation,
+export const pluginConfigSpec = createFieldMapSpec('core/plugin-config', (t) => ({
+    schemas: t.map(),
+    migrations: t.map(),
+}), {
+    use: (values) => {
+        const validatedMigrations = mapValuesOfMap(values.migrations, (migrations, pluginKey) => sortAndValidateMigrations(migrations, pluginKey));
+        return {
+            getSchemaCreator: (pluginKey) => values.schemas.get(pluginKey),
+            getMigrations: (pluginKey) => validatedMigrations.get(pluginKey),
+            getLastMigrationVersion: (pluginKey) => {
+                const migrations = values.migrations.get(pluginKey);
+                return migrations?.[migrations.length - 1]?.version;
+            },
+        };
+    },
 });
 //# sourceMappingURL=config-spec.js.map

package/dist/plugins/spec/config-spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-spec.js","sourceRoot":"","sources":["../../../src/plugins/spec/config-spec.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAwC9C,SAAS,yBAAyB,CAChC,UAAmC;IAEnC,qEAAqE;IACrE,MAAM,gBAAgB,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAC3C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAChC,CAAC;IACF,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACrD,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gCAAgC;IAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmC,CAAC;IAC3D,MAAM,aAAa,GAAG,IAAI,GAAG,EAAmC,CAAC;IAEjE,OAAO;QACL,qBAAqB,CAAC,SAAS,EAAE,aAAa;YAC5C,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,qBAAqB,SAAS,wBAAwB,CAAC,CAAC;YAC1E,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACxC,CAAC;QACD,kBAAkB,CAAC,SAAS,EAAE,UAAU;YACtC,IAAI,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CACb,yBAAyB,SAAS,yBAAyB,CAC5D,CAAC;YACJ,CAAC;YACD,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;YAC/D,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;QACjD,CAAC;QACD,gBAAgB,CAAC,SAAS;YACxB,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;QACD,aAAa,CAAC,SAAS;YACrB,OAAO,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;QACD,uBAAuB,CAAC,SAAS;YAC/B,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAChD,OAAO,UAAU,EAAE,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC;QACtD,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,oBAAoB,EAAE;IACrE,kBAAkB,EAAE,gCAAgC;CACrD,CAAC,CAAC"}
+{"version":3,"file":"config-spec.js","sourceRoot":"","sources":["../../../src/plugins/spec/config-spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAItD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAuBvE,SAAS,yBAAyB,CAChC,UAAmC,EACnC,SAAiB;IAEjB,qEAAqE;IACrE,MAAM,gBAAgB,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAC3C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAChC,CAAC;IACF,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,6BAA6B,SAAS,+BAA+B,CACtE,CAAC;IACJ,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACrD,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CACb,6BAA6B,SAAS,6BAA6B,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAChD,oBAAoB,EACpB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,GAAG,EAAmC;IACjD,UAAU,EAAE,CAAC,CAAC,GAAG,EAAmC;CACrD,CAAC,EACF;IACE,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE;QACd,MAAM,mBAAmB,GAAG,cAAc,CACxC,MAAM,CAAC,UAAU,EACjB,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,CACxB,yBAAyB,CAAC,UAAU,EAAE,SAAS,CAAC,CACnD,CAAC;QACF,OAAO;YACL,gBAAgB,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;YACtE,aAAa,EAAE,CAAC,SAAiB,EAAE,EAAE,CACnC,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC;YACpC,uBAAuB,EAAE,CAAC,SAAiB,EAAE,EAAE;gBAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACpD,OAAO,UAAU,EAAE,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC;YACtD,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CACF,CAAC"}

package/dist/plugins/spec/index.d.ts

@@ -1,5 +1,5 @@
 export * from './auth-config-spec.js';
-export * from './auth-model-config-spec.js';
+export * from './auth-models-spec.js';
 export * from './config-spec.js';
 export * from './types.js';
 export * from './web-config-spec.js';

package/dist/plugins/spec/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/spec/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/spec/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC"}

package/dist/plugins/spec/index.js

@@ -1,5 +1,5 @@
 export * from './auth-config-spec.js';
-export * from './auth-model-config-spec.js';
+export * from './auth-models-spec.js';
 export * from './config-spec.js';
 export * from './types.js';
 export * from './web-config-spec.js';

package/dist/plugins/spec/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/spec/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/spec/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC"}

package/dist/plugins/spec/types.d.ts

@@ -1,29 +1,70 @@
-type PluginSpecPlatform = 'web' | 'node';
-export type PluginSpecImplementation = Record<string, unknown>;
-export interface PluginSpec<T = PluginSpecImplementation> {
-    readonly type: 'plugin-spec';
-    readonly name: string;
-    readonly platforms?: PluginSpecPlatform[];
-    readonly placeholderType?: T;
-    readonly isOptional: boolean;
-    optional(): PluginSpec<T | undefined>;
-    defaultInitializer?: () => T;
+export type PluginSpecPlatform = 'web' | 'node';
+/**
+ * Result returned by a plugin spec initializer.
+ * Contains separate interfaces for init (mutable) and use (read-only) phases.
+ */
+export interface PluginSpecInitializerResult<TInit extends object = object, TUse extends object = object> {
+    /** Init interface - mutable methods for registration during plugin initialization */
+    init: TInit;
+    /** Use interface - read-only methods for consumption after initialization */
+    use: () => TUse;
 }
-export interface PluginSpecWithInitializer<T = PluginSpecImplementation> extends PluginSpec<T> {
-    defaultInitializer: () => T;
+/**
+ * Options for creating a plugin spec.
+ */
+export interface PluginSpecOptions<TInit extends object, TUse extends object> {
+    /** Initializer function that creates the init and use interfaces */
+    initializer: () => PluginSpecInitializerResult<TInit, TUse>;
 }
-export interface InitializedPluginSpec<T = PluginSpecImplementation> {
-    spec: PluginSpec<T>;
-    implementation: T;
+/**
+ * A plugin spec defines a shared capability that can be registered to during
+ * plugin initialization and consumed afterwards.
+ *
+ * Specs use two separate interfaces:
+ * - `init`: Mutable interface used during plugin initialization for registration
+ * - `use`: Read-only interface used after initialization (compilation, UI, etc.)
+ *
+ * This separation is enforced by TypeScript - callers must explicitly choose
+ * which interface to use, preventing accidental mutations after initialization.
+ */
+export interface PluginSpec<TInit extends object = object, TUse extends object = object> {
+    readonly type: 'plugin-spec';
+    readonly name: string;
+    /** Initializer function that creates the init and use interfaces */
+    readonly initializer: () => PluginSpecInitializerResult<TInit, TUse>;
 }
-export declare function createInitializedPluginSpec<T = PluginSpecImplementation>(spec: PluginSpec<T>, implementation: T): InitializedPluginSpec<T>;
-export type PluginSpecImplementationFromSpec<T extends PluginSpec> = T extends PluginSpec<infer TImplementation> ? TImplementation : never;
-export declare function createPluginSpec<T = PluginSpecImplementation>(name: string, options: {
-    platforms?: PluginSpecPlatform | PluginSpecPlatform[];
-    defaultInitializer: () => T;
-}): PluginSpecWithInitializer<T>;
-export declare function createPluginSpec<T = PluginSpecImplementation>(name: string, options?: {
-    platforms?: PluginSpecPlatform | PluginSpecPlatform[];
-}): PluginSpec<T>;
-export {};
+/**
+ * Extracts the init type from a PluginSpec.
+ */
+export type InferPluginSpecInit<T> = T extends PluginSpec<infer I> ? I : never;
+/**
+ * Extracts the use type from a PluginSpec.
+ */
+export type InferPluginSpecUse<T> = T extends PluginSpec<object, infer U> ? U : never;
+/**
+ * Creates a plugin spec with init and use phases.
+ *
+ * @example
+ * ```typescript
+ * const mySpec = createPluginSpec('core/my-spec', {
+ *   initializer: () => {
+ *     const items = new Map<string, Item>();
+ *     return {
+ *       init: {
+ *         register: (item: Item) => items.set(item.name, item),
+ *       },
+ *       use: () => ({
+ *         get: (name: string) => items.get(name),
+ *         getAll: () => [...items.values()],
+ *       }),
+ *     };
+ *   },
+ * });
+ * ```
+ *
+ * @param name - Unique identifier for the spec (e.g., 'core/my-spec')
+ * @param options - Options including the initializer function
+ * @returns A plugin spec that can be used with SpecStore
+ */
+export declare function createPluginSpec<TInit extends object, TUse extends object>(name: string, options: PluginSpecOptions<TInit, TUse>): PluginSpec<TInit, TUse>;
 //# sourceMappingURL=types.d.ts.map

package/dist/plugins/spec/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/spec/types.ts"],"names":[],"mappings":"AAAA,KAAK,kBAAkB,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzC,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/D,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,wBAAwB;IACtD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAE1C,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAE7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B,QAAQ,IAAI,UAAU,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAEtC,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,GAAG,wBAAwB,CACrE,SAAQ,UAAU,CAAC,CAAC,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,wBAAwB;IACjE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACpB,cAAc,EAAE,CAAC,CAAC;CACnB;AAED,wBAAgB,2BAA2B,CAAC,CAAC,GAAG,wBAAwB,EACtE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EACnB,cAAc,EAAE,CAAC,GAChB,qBAAqB,CAAC,CAAC,CAAC,CAE1B;AAED,MAAM,MAAM,gCAAgC,CAAC,CAAC,SAAS,UAAU,IAC/D,CAAC,SAAS,UAAU,CAAC,MAAM,eAAe,CAAC,GAAG,eAAe,GAAG,KAAK,CAAC;AAExE,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,wBAAwB,EAC3D,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,SAAS,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;IACtD,kBAAkB,EAAE,MAAM,CAAC,CAAC;CAC7B,GACA,yBAAyB,CAAC,CAAC,CAAC,CAAC;AAChC,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,wBAAwB,EAC3D,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;CACvD,GACA,UAAU,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/spec/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,2BAA2B,CAC1C,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,IAAI,SAAS,MAAM,GAAG,MAAM;IAE5B,qFAAqF;IACrF,IAAI,EAAE,KAAK,CAAC;IACZ,6EAA6E;IAC7E,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,KAAK,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM;IAC1E,oEAAoE;IACpE,WAAW,EAAE,MAAM,2BAA2B,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;CAC7D;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU,CACzB,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,IAAI,SAAS,MAAM,GAAG,MAAM;IAE5B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,MAAM,2BAA2B,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAC9B,CAAC,SAAS,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM,EACxE,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,GACtC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAOzB"}

package/dist/plugins/spec/types.js

@@ -1,17 +1,34 @@
-export function createInitializedPluginSpec(spec, implementation) {
-    return { spec, implementation };
-}
+/**
+ * Creates a plugin spec with init and use phases.
+ *
+ * @example
+ * ```typescript
+ * const mySpec = createPluginSpec('core/my-spec', {
+ *   initializer: () => {
+ *     const items = new Map<string, Item>();
+ *     return {
+ *       init: {
+ *         register: (item: Item) => items.set(item.name, item),
+ *       },
+ *       use: () => ({
+ *         get: (name: string) => items.get(name),
+ *         getAll: () => [...items.values()],
+ *       }),
+ *     };
+ *   },
+ * });
+ * ```
+ *
+ * @param name - Unique identifier for the spec (e.g., 'core/my-spec')
+ * @param options - Options including the initializer function
+ * @returns A plugin spec that can be used with SpecStore
+ */
 export function createPluginSpec(name, options) {
-    const { platforms, defaultInitializer } = options ?? {};
+    const { initializer } = options;
     return {
         type: 'plugin-spec',
         name,
-        platforms: platforms && (Array.isArray(platforms) ? platforms : [platforms]),
-        isOptional: false,
-        optional() {
-            return { ...this, isOptional: true };
-        },
-        defaultInitializer,
+        initializer,
     };
 }
 //# sourceMappingURL=types.js.map

package/dist/plugins/spec/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/spec/types.ts"],"names":[],"mappings":"AA6BA,MAAM,UAAU,2BAA2B,CACzC,IAAmB,EACnB,cAAiB;IAEjB,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;AAClC,CAAC;AAkBD,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,OAGC;IAED,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACxD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,IAAI;QACJ,SAAS,EACP,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACnE,UAAU,EAAE,KAAK;QACjB,QAAQ;YACN,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACvC,CAAC;QACD,kBAAkB;KACnB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/spec/types.ts"],"names":[],"mappings":"AAwDA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,OAAuC;IAEvC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAChC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,IAAI;QACJ,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/plugins/spec/web-config-spec.d.ts

@@ -1,22 +1,19 @@
 import type React from 'react';
 import type { BasePluginDefinition } from '#src/schema/index.js';
 import type { PluginMetadataWithPaths } from '../metadata/types.js';
-import type { PluginSpecImplementation } from './types.js';
 export interface WebConfigProps {
     definition: BasePluginDefinition | undefined;
     metadata: PluginMetadataWithPaths;
     onSave: () => void;
 }
-/**
- * Spec for allowing the plugin to be configured from the plugins page
- */
-export interface WebConfigSpec extends PluginSpecImplementation {
-    registerWebConfigComponent: (pluginKey: string, ConfigComponent: React.FC<WebConfigProps>) => void;
-    getWebConfigComponent: (pluginKey: string) => React.FC<WebConfigProps> | undefined;
-}
-export declare function createWebConfigImplementation(): WebConfigSpec;
 /**
  * Spec for adding config component for plugin
+ *
+ * Keyed by plugin key, value is the config component.
  */
-export declare const webConfigSpec: import("./types.js").PluginSpecWithInitializer<WebConfigSpec>;
+export declare const webConfigSpec: import("./types.js").PluginSpec<{
+    components: import("@baseplate-dev/utils").MapContainer<string, React.FC<WebConfigProps>>;
+}, import("@baseplate-dev/utils").FieldMapValues<{
+    components: import("@baseplate-dev/utils").MapContainer<string, React.FC<WebConfigProps>>;
+}>>;
 //# sourceMappingURL=web-config-spec.d.ts.map

package/dist/plugins/spec/web-config-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-config-spec.d.ts","sourceRoot":"","sources":["../../../src/plugins/spec/web-config-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAI3D,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAC7C,QAAQ,EAAE,uBAAuB,CAAC;IAClC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,wBAAwB;IAC7D,0BAA0B,EAAE,CAC1B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAAC,KACtC,IAAI,CAAC;IACV,qBAAqB,EAAE,CACrB,SAAS,EAAE,MAAM,KACd,KAAK,CAAC,EAAE,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC;CAC3C;AAED,wBAAgB,6BAA6B,IAAI,aAAa,CAgB7D;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,+DAGxB,CAAC"}
+{"version":3,"file":"web-config-spec.d.ts","sourceRoot":"","sources":["../../../src/plugins/spec/web-config-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAIpE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAC7C,QAAQ,EAAE,uBAAuB,CAAC;IAClC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;GAEvB,CAAC"}

package/dist/plugins/spec/web-config-spec.js

@@ -1,23 +1,10 @@
-import { createPluginSpec } from './types.js';
-export function createWebConfigImplementation() {
-    const components = new Map();
-    return {
-        registerWebConfigComponent(pluginKey, ConfigComponent) {
-            if (components.has(pluginKey)) {
-                throw new Error(`Web config component for plugin ${pluginKey} is already registered`);
-            }
-            components.set(pluginKey, ConfigComponent);
-        },
-        getWebConfigComponent(pluginKey) {
-            return components.get(pluginKey);
-        },
-    };
-}
+import { createFieldMapSpec } from '../utils/create-field-map-spec.js';
 /**
  * Spec for adding config component for plugin
+ *
+ * Keyed by plugin key, value is the config component.
  */
-export const webConfigSpec = createPluginSpec('core/web-config', {
-    platforms: 'web',
-    defaultInitializer: createWebConfigImplementation,
-});
+export const webConfigSpec = createFieldMapSpec('core/web-config', (t) => ({
+    components: t.map(),
+}));
 //# sourceMappingURL=web-config-spec.js.map

package/dist/plugins/spec/web-config-spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-config-spec.js","sourceRoot":"","sources":["../../../src/plugins/spec/web-config-spec.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAqB9C,MAAM,UAAU,6BAA6B;IAC3C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAoC,CAAC;IAE/D,OAAO;QACL,0BAA0B,CAAC,SAAS,EAAE,eAAe;YACnD,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CACb,mCAAmC,SAAS,wBAAwB,CACrE,CAAC;YACJ,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QAC7C,CAAC;QACD,qBAAqB,CAAC,SAAS;YAC7B,OAAO,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC,iBAAiB,EAAE;IAC/D,SAAS,EAAE,KAAK;IAChB,kBAAkB,EAAE,6BAA6B;CAClD,CAAC,CAAC"}
+{"version":3,"file":"web-config-spec.js","sourceRoot":"","sources":["../../../src/plugins/spec/web-config-spec.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAQvE;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzE,UAAU,EAAE,CAAC,CAAC,GAAG,EAAoC;CACtD,CAAC,CAAC,CAAC"}

package/dist/plugins/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/plugins/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/plugins/store/store.d.ts

@@ -0,0 +1,23 @@
+import type { PluginSpec, PluginSpecInitializerResult } from '../spec/types.js';
+/**
+ * Store for managing plugin spec instances with lazy initialization.
+ *
+ * Each spec is initialized once on first access, and both its init and use
+ * interfaces are cached for subsequent access.
+ */
+export declare class PluginSpecStore {
+    private instances;
+    private useInstances;
+    constructor(instances?: Map<string, PluginSpecInitializerResult<object, object>>);
+    /**
+     * Gets the use interface for a spec.
+     *
+     * Use this after initialization to access registered items.
+     * The use interface provides read-only methods for consumption.
+     *
+     * @param spec - The plugin spec to get the use interface for
+     * @returns The use interface for the spec
+     */
+    use<TUse extends object, TInit extends object>(spec: PluginSpec<TInit, TUse>): TUse;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/plugins/store/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/plugins/store/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAEhF;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAA2C;IAC5D,OAAO,CAAC,YAAY,CAA6B;gBAErC,SAAS,2DAAiD;IAItE;;;;;;;;OAQG;IACH,GAAG,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,EAC3C,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,GAC5B,IAAI;CAiBR"}

package/dist/plugins/store/store.js

@@ -0,0 +1,36 @@
+/**
+ * Store for managing plugin spec instances with lazy initialization.
+ *
+ * Each spec is initialized once on first access, and both its init and use
+ * interfaces are cached for subsequent access.
+ */
+export class PluginSpecStore {
+    instances;
+    useInstances = new Map();
+    constructor(instances = new Map()) {
+        this.instances = instances;
+    }
+    /**
+     * Gets the use interface for a spec.
+     *
+     * Use this after initialization to access registered items.
+     * The use interface provides read-only methods for consumption.
+     *
+     * @param spec - The plugin spec to get the use interface for
+     * @returns The use interface for the spec
+     */
+    use(spec) {
+        let specInstance = this.instances.get(spec.name);
+        if (!specInstance) {
+            specInstance = spec.initializer();
+            this.instances.set(spec.name, specInstance);
+        }
+        let useInstance = this.useInstances.get(spec.name);
+        if (!useInstance) {
+            useInstance = specInstance.use();
+            this.useInstances.set(spec.name, useInstance);
+        }
+        return useInstance;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/plugins/store/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/plugins/store/store.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAClB,SAAS,CAA2C;IACpD,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEjD,YAAY,YAAY,IAAI,GAAG,EAAuC;QACpE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;;;;;;;OAQG;IACH,GAAG,CACD,IAA6B;QAE7B,IAAI,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAElC,CAAC;QACd,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,GAAG,YAAY,CAAC,GAAG,EAAE,CAAC;YACjC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,WAAmB,CAAC;IAC7B,CAAC;CACF"}

package/dist/plugins/utils/create-field-map-spec.d.ts

@@ -0,0 +1,17 @@
+import type { FieldMapSchema, FieldMapSchemaBuilder, FieldMapValues } from '@baseplate-dev/utils';
+import type { PluginSpec } from '../spec/types.js';
+/**
+ * Creates a plugin spec backed by a FieldMap for automatic source tracking.
+ *
+ * @param name - Unique identifier for the spec
+ * @param schemaBuilder - Function that builds the field map schema
+ * @param options - Optional configuration including custom use interface
+ */
+export declare function createFieldMapSpec<T extends FieldMapSchema, TUse extends object = FieldMapValues<T>>(name: string, schemaBuilder: (t: FieldMapSchemaBuilder) => T, options?: {
+    /**
+     * Custom use interface builder. Receives the field map values and returns
+     * the use interface. If not provided, returns the raw field map values.
+     */
+    use?: (values: FieldMapValues<T>) => TUse;
+}): PluginSpec<T, TUse>;
+//# sourceMappingURL=create-field-map-spec.d.ts.map

package/dist/plugins/utils/create-field-map-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-field-map-spec.d.ts","sourceRoot":"","sources":["../../../src/plugins/utils/create-field-map-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,SAAS,cAAc,EACxB,IAAI,SAAS,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,EAEvC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,CAAC,EAC9C,OAAO,CAAC,EAAE;IACR;;;OAGG;IACH,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CAC3C,GACA,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAgBrB"}

package/dist/plugins/utils/create-field-map-spec.js

@@ -0,0 +1,27 @@
+import { createPluginSpec } from '../spec/types.js';
+import { createPluginFieldMap } from './create-plugin-field-map.js';
+/**
+ * Creates a plugin spec backed by a FieldMap for automatic source tracking.
+ *
+ * @param name - Unique identifier for the spec
+ * @param schemaBuilder - Function that builds the field map schema
+ * @param options - Optional configuration including custom use interface
+ */
+export function createFieldMapSpec(name, schemaBuilder, options) {
+    return createPluginSpec(name, {
+        initializer: () => {
+            const fieldMap = createPluginFieldMap(schemaBuilder);
+            return {
+                init: fieldMap,
+                use: () => {
+                    const values = fieldMap.getValues();
+                    if (options?.use) {
+                        return options.use(values);
+                    }
+                    return values;
+                },
+            };
+        },
+    });
+}
+//# sourceMappingURL=create-field-map-spec.js.map

package/dist/plugins/utils/create-field-map-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-field-map-spec.js","sourceRoot":"","sources":["../../../src/plugins/utils/create-field-map-spec.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAIhC,IAAY,EACZ,aAA8C,EAC9C,OAMC;IAED,OAAO,gBAAgB,CAAC,IAAI,EAAE;QAC5B,WAAW,EAAE,GAAG,EAAE;YAChB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;YACrD,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,GAAG,EAAE,GAAG,EAAE;oBACR,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;oBACpC,IAAI,OAAO,EAAE,GAAG,EAAE,CAAC;wBACjB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC7B,CAAC;oBACD,OAAO,MAAc,CAAC;gBACxB,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/plugins/utils/create-plugin-field-map.d.ts

@@ -0,0 +1,24 @@
+import type { FieldMap, FieldMapSchema, FieldMapSchemaBuilder } from '@baseplate-dev/utils';
+/**
+ * Creates a field map that automatically tracks which plugin registered each value.
+ *
+ * Similar to `createConfigFieldMap` in the sync package, this utility uses the
+ * current plugin context to track the source of registrations. This enables
+ * clear error messages when registration conflicts occur.
+ *
+ * @example
+ * ```typescript
+ * const fieldMap = createPluginFieldMap((t) => ({
+ *   transformers: t.map<string, Transformer>(),
+ * }));
+ *
+ * // When a plugin tries to overwrite a value:
+ * // Error: Value for key 'myTransformer' has already been set by plugin-auth
+ * //        and cannot be overwritten by plugin-storage
+ * ```
+ *
+ * @param schemaBuilder - A function that builds the field map schema
+ * @returns A field map with automatic source tracking
+ */
+export declare function createPluginFieldMap<S extends FieldMapSchema>(schemaBuilder: (t: FieldMapSchemaBuilder) => S): FieldMap<S>;
+//# sourceMappingURL=create-plugin-field-map.d.ts.map

package/dist/plugins/utils/create-plugin-field-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-plugin-field-map.d.ts","sourceRoot":"","sources":["../../../src/plugins/utils/create-plugin-field-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAM9B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,cAAc,EAC3D,aAAa,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,CAAC,GAC7C,QAAQ,CAAC,CAAC,CAAC,CAIb"}

package/dist/plugins/utils/create-plugin-field-map.js

@@ -0,0 +1,29 @@
+import { createFieldMap } from '@baseplate-dev/utils';
+import { getPluginContext } from '../context/plugin-context.js';
+/**
+ * Creates a field map that automatically tracks which plugin registered each value.
+ *
+ * Similar to `createConfigFieldMap` in the sync package, this utility uses the
+ * current plugin context to track the source of registrations. This enables
+ * clear error messages when registration conflicts occur.
+ *
+ * @example
+ * ```typescript
+ * const fieldMap = createPluginFieldMap((t) => ({
+ *   transformers: t.map<string, Transformer>(),
+ * }));
+ *
+ * // When a plugin tries to overwrite a value:
+ * // Error: Value for key 'myTransformer' has already been set by plugin-auth
+ * //        and cannot be overwritten by plugin-storage
+ * ```
+ *
+ * @param schemaBuilder - A function that builds the field map schema
+ * @returns A field map with automatic source tracking
+ */
+export function createPluginFieldMap(schemaBuilder) {
+    return createFieldMap(schemaBuilder, {
+        getDynamicSource: () => getPluginContext()?.pluginKey,
+    });
+}
+//# sourceMappingURL=create-plugin-field-map.js.map

package/dist/plugins/utils/create-plugin-field-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-plugin-field-map.js","sourceRoot":"","sources":["../../../src/plugins/utils/create-plugin-field-map.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,oBAAoB,CAClC,aAA8C;IAE9C,OAAO,cAAc,CAAC,aAAa,EAAE;QACnC,gBAAgB,EAAE,GAAG,EAAE,CAAC,gBAAgB,EAAE,EAAE,SAAS;KACtD,CAAC,CAAC;AACL,CAAC"}

package/dist/plugins/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './create-field-map-spec.js';
+export * from './create-plugin-field-map.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC"}