@libar-dev/architect 1.0.0-pre.3

package/dist/config/defaults.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @architect
+ * @architect-core @architect-config
+ * @architect-pattern ConfigurationDefaults
+ * @architect-status completed
+ * @architect-arch-layer domain
+ * @architect-arch-context config
+ * @architect-used-by ArchitectFactory, PatternScanner, LintRules, DetectChanges, AntiPatternDetector
+ *
+ * ## Configuration Defaults
+ *
+ * Centralized default constants for the Architect package.
+ * These defaults are used when no custom configuration or registry is provided.
+ *
+ * ### Why Centralize?
+ *
+ * Previously, the default tag prefix string `"@architect-"` appeared in 6+ files.
+ * Centralizing eliminates duplication and provides a single source of truth.
+ *
+ * ### When to Use
+ *
+ * - Import these defaults when implementing functions that need fallback values
+ * - Use `DEFAULT_REGEX_BUILDERS` for opt-in detection when no registry is provided
+ * - Use `DEFAULT_TAG_PREFIX` in error messages when no registry context exists
+ * - Use `DEFAULT_CONTEXT_INFERENCE_RULES` to auto-infer bounded contexts from paths
+ */
+import { type RegexBuilders } from './regex-builders.js';
+import type { ContextInferenceRule } from '../generators/pipeline/context-inference.js';
+/**
+ * Default tag prefix for @architect-* annotations.
+ *
+ * This is the prefix used when:
+ * - No `TagRegistry` is provided to a function
+ * - Error messages need to reference the tag format
+ *
+ * @example
+ * ```typescript
+ * const tagPrefix = registry?.tagPrefix ?? DEFAULT_TAG_PREFIX;
+ * ```
+ */
+export declare const DEFAULT_TAG_PREFIX = "@architect-";
+/**
+ * Default file opt-in tag (without suffix).
+ *
+ * Files must contain this exact tag (in a JSDoc comment) to be included
+ * in documentation generation. This is distinct from directive tags
+ * which have suffixes like `@architect-pattern`.
+ *
+ * @example
+ * ```typescript
+ * // File with opt-in:
+ * /** @architect This file is documented *\/
+ * ```
+ */
+export declare const DEFAULT_FILE_OPT_IN_TAG = "@architect";
+/**
+ * Pre-built regex builders using default prefix and opt-in tag.
+ * The builders are created once at module load time for efficiency.
+ *
+ * @example
+ * ```typescript
+ * const builders = registry
+ *   ? createRegexBuilders(registry.tagPrefix, registry.fileOptInTag)
+ *   : DEFAULT_REGEX_BUILDERS;
+ * return builders.hasFileOptIn(content);
+ * ```
+ */
+export declare const DEFAULT_REGEX_BUILDERS: RegexBuilders;
+/**
+ * Default context inference rules for auto-inferring bounded context from file paths.
+ *
+ * These rules map directory paths to bounded context names. When a pattern has
+ * an `@architect-arch-layer` but no explicit `@architect-arch-context`, the
+ * context is inferred from the file path using these rules.
+ *
+ * **Why This Exists:**
+ * In most codebases, directory structure already implies bounded context:
+ * - `src/validation/` → validation context
+ * - `src/lint/` → lint context
+ * - `src/generators/` → generator context
+ *
+ * Auto-inference eliminates redundant annotations while preserving the ability
+ * to override with explicit `@architect-arch-context` when needed.
+ *
+ * @example
+ * ```typescript
+ * // Pattern at src/validation/rules.ts with @architect-arch-layer:application
+ * // will automatically get archContext='validation' without explicit annotation
+ * ```
+ */
+export declare const DEFAULT_CONTEXT_INFERENCE_RULES: readonly ContextInferenceRule[];
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAExF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAGpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,+BAA+B,EAAE,SAAS,oBAAoB,EAYjE,CAAC"}

package/dist/config/defaults.js

@@ -0,0 +1,103 @@
+/**
+ * @architect
+ * @architect-core @architect-config
+ * @architect-pattern ConfigurationDefaults
+ * @architect-status completed
+ * @architect-arch-layer domain
+ * @architect-arch-context config
+ * @architect-used-by ArchitectFactory, PatternScanner, LintRules, DetectChanges, AntiPatternDetector
+ *
+ * ## Configuration Defaults
+ *
+ * Centralized default constants for the Architect package.
+ * These defaults are used when no custom configuration or registry is provided.
+ *
+ * ### Why Centralize?
+ *
+ * Previously, the default tag prefix string `"@architect-"` appeared in 6+ files.
+ * Centralizing eliminates duplication and provides a single source of truth.
+ *
+ * ### When to Use
+ *
+ * - Import these defaults when implementing functions that need fallback values
+ * - Use `DEFAULT_REGEX_BUILDERS` for opt-in detection when no registry is provided
+ * - Use `DEFAULT_TAG_PREFIX` in error messages when no registry context exists
+ * - Use `DEFAULT_CONTEXT_INFERENCE_RULES` to auto-infer bounded contexts from paths
+ */
+import { createRegexBuilders } from './regex-builders.js';
+/**
+ * Default tag prefix for @architect-* annotations.
+ *
+ * This is the prefix used when:
+ * - No `TagRegistry` is provided to a function
+ * - Error messages need to reference the tag format
+ *
+ * @example
+ * ```typescript
+ * const tagPrefix = registry?.tagPrefix ?? DEFAULT_TAG_PREFIX;
+ * ```
+ */
+export const DEFAULT_TAG_PREFIX = '@architect-';
+/**
+ * Default file opt-in tag (without suffix).
+ *
+ * Files must contain this exact tag (in a JSDoc comment) to be included
+ * in documentation generation. This is distinct from directive tags
+ * which have suffixes like `@architect-pattern`.
+ *
+ * @example
+ * ```typescript
+ * // File with opt-in:
+ * /** @architect This file is documented *\/
+ * ```
+ */
+export const DEFAULT_FILE_OPT_IN_TAG = '@architect';
+/**
+ * Pre-built regex builders using default prefix and opt-in tag.
+ * The builders are created once at module load time for efficiency.
+ *
+ * @example
+ * ```typescript
+ * const builders = registry
+ *   ? createRegexBuilders(registry.tagPrefix, registry.fileOptInTag)
+ *   : DEFAULT_REGEX_BUILDERS;
+ * return builders.hasFileOptIn(content);
+ * ```
+ */
+export const DEFAULT_REGEX_BUILDERS = createRegexBuilders(DEFAULT_TAG_PREFIX, DEFAULT_FILE_OPT_IN_TAG);
+/**
+ * Default context inference rules for auto-inferring bounded context from file paths.
+ *
+ * These rules map directory paths to bounded context names. When a pattern has
+ * an `@architect-arch-layer` but no explicit `@architect-arch-context`, the
+ * context is inferred from the file path using these rules.
+ *
+ * **Why This Exists:**
+ * In most codebases, directory structure already implies bounded context:
+ * - `src/validation/` → validation context
+ * - `src/lint/` → lint context
+ * - `src/generators/` → generator context
+ *
+ * Auto-inference eliminates redundant annotations while preserving the ability
+ * to override with explicit `@architect-arch-context` when needed.
+ *
+ * @example
+ * ```typescript
+ * // Pattern at src/validation/rules.ts with @architect-arch-layer:application
+ * // will automatically get archContext='validation' without explicit annotation
+ * ```
+ */
+export const DEFAULT_CONTEXT_INFERENCE_RULES = [
+    { pattern: 'src/validation/**', context: 'validation' },
+    { pattern: 'src/scanner/**', context: 'scanner' },
+    { pattern: 'src/lint/**', context: 'lint' },
+    { pattern: 'src/config/**', context: 'config' },
+    { pattern: 'src/taxonomy/**', context: 'taxonomy' },
+    { pattern: 'src/generators/**', context: 'generator' },
+    { pattern: 'src/renderable/**', context: 'renderer' },
+    { pattern: 'src/extractor/**', context: 'extractor' },
+    { pattern: 'src/api/**', context: 'api' },
+    { pattern: 'src/cli/**', context: 'cli' },
+    { pattern: 'src/types/**', context: 'types' },
+];
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,mBAAmB,EAAsB,MAAM,qBAAqB,CAAC;AAG9E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB,mBAAmB,CACtE,kBAAkB,EAClB,uBAAuB,CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAoC;IAC9E,EAAE,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,YAAY,EAAE;IACvD,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE;IACjD,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE;IAC3C,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE;IAC/C,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,UAAU,EAAE;IACnD,EAAE,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,WAAW,EAAE;IACtD,EAAE,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,UAAU,EAAE;IACrD,EAAE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,WAAW,EAAE;IACrD,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE;IACzC,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE;IACzC,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE;CACrC,CAAC"}

package/dist/config/define-config.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @architect
+ * @architect-core @architect-config
+ * @architect-pattern DefineConfig
+ * @architect-status active
+ * @architect-arch-layer infrastructure
+ * @architect-arch-context config
+ * @architect-arch-role infrastructure
+ * @architect-include reference-sample
+ * @architect-uses ProjectConfigTypes
+ * @architect-used-by ConfigLoader
+ *
+ * ## Define Config
+ *
+ * Identity function for type-safe project configuration.
+ * Follows the Vite/Vitest `defineConfig()` convention:
+ * returns the input unchanged, providing only TypeScript type checking.
+ *
+ * Validation happens later at load time via Zod schema in `loadProjectConfig()`.
+ *
+ * ### When to Use
+ *
+ * - In `architect.config.ts` at project root to get type-safe configuration with autocompletion.
+ */
+import type { ArchitectProjectConfig } from './project-config.js';
+/**
+ * Type-safe identity function for Architect project configuration.
+ *
+ * Returns the config object unchanged. Provides TypeScript autocompletion
+ * and type checking without runtime overhead. Validation happens at
+ * config load time via `loadProjectConfig()`.
+ *
+ * @param config - The project configuration object
+ * @returns The same config object (identity)
+ */
+export declare function defineConfig(config: ArchitectProjectConfig): ArchitectProjectConfig;
+//# sourceMappingURL=define-config.d.ts.map

package/dist/config/define-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../../src/config/define-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,CAEnF"}

package/dist/config/define-config.js

@@ -0,0 +1,38 @@
+/**
+ * @architect
+ * @architect-core @architect-config
+ * @architect-pattern DefineConfig
+ * @architect-status active
+ * @architect-arch-layer infrastructure
+ * @architect-arch-context config
+ * @architect-arch-role infrastructure
+ * @architect-include reference-sample
+ * @architect-uses ProjectConfigTypes
+ * @architect-used-by ConfigLoader
+ *
+ * ## Define Config
+ *
+ * Identity function for type-safe project configuration.
+ * Follows the Vite/Vitest `defineConfig()` convention:
+ * returns the input unchanged, providing only TypeScript type checking.
+ *
+ * Validation happens later at load time via Zod schema in `loadProjectConfig()`.
+ *
+ * ### When to Use
+ *
+ * - In `architect.config.ts` at project root to get type-safe configuration with autocompletion.
+ */
+/**
+ * Type-safe identity function for Architect project configuration.
+ *
+ * Returns the config object unchanged. Provides TypeScript autocompletion
+ * and type checking without runtime overhead. Validation happens at
+ * config load time via `loadProjectConfig()`.
+ *
+ * @param config - The project configuration object
+ * @returns The same config object (identity)
+ */
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=define-config.js.map

package/dist/config/define-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.js","sourceRoot":"","sources":["../../src/config/define-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,MAA8B;IACzD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/config/factory.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @architect
+ * @architect-core @architect-config
+ * @architect-pattern ArchitectFactory
+ * @architect-status completed
+ * @architect-arch-role service
+ * @architect-arch-context config
+ * @architect-arch-layer application
+ * @architect-include reference-sample
+ * @architect-uses ConfigurationTypes, ConfigurationPresets, RegexBuilders, TagRegistry
+ * @architect-used-by PublicAPI
+ * @architect-extract-shapes CreateArchitectOptions, createArchitect
+ *
+ * ## Architect Factory
+ *
+ * Main factory function for creating configured Architect instances.
+ * Supports presets, custom configuration, and configuration overrides.
+ *
+ * ### When to Use
+ *
+ * - At application startup to create a configured instance
+ * - When switching between different tag prefixes
+ * - When customizing the taxonomy for a specific project
+ */
+import type { ArchitectConfig, ArchitectInstance } from './types.js';
+import { type PresetName } from './presets.js';
+/**
+ * Options for creating an Architect instance
+ */
+export interface CreateArchitectOptions {
+    /** Use a preset configuration */
+    preset?: PresetName;
+    /** Custom tag prefix (overrides preset) */
+    tagPrefix?: string;
+    /** Custom file opt-in tag (overrides preset) */
+    fileOptInTag?: string;
+    /** Custom categories (replaces preset categories entirely) */
+    categories?: ArchitectConfig['categories'];
+}
+/**
+ * Creates a configured Architect instance.
+ *
+ * Configuration resolution order:
+ * 1. Start with preset (or libar-generic default)
+ * 2. Preset categories REPLACE base taxonomy categories (not merged)
+ * 3. Apply explicit overrides (tagPrefix, fileOptInTag, categories)
+ * 4. Create regex builders from final configuration
+ *
+ * Note: Presets define complete category sets. The libar-generic preset
+ * has 3 categories (core, api, infra), while ddd-es-cqrs has 21.
+ * Categories from the preset replace base categories entirely.
+ *
+ * @param options - Configuration options
+ * @returns Configured Architect instance
+ *
+ * @example
+ * ```typescript
+ * // Use the default preset
+ * const dp = createArchitect();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Custom prefix with DDD taxonomy
+ * const dp = createArchitect({
+ *   preset: "ddd-es-cqrs",
+ *   tagPrefix: "@my-project-",
+ *   fileOptInTag: "@my-project"
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Default (libar-generic preset with 3 categories)
+ * const dp = createArchitect();
+ * ```
+ */
+export declare function createArchitect(options?: CreateArchitectOptions): ArchitectInstance;
+//# sourceMappingURL=factory.d.ts.map

package/dist/config/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/config/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIrE,OAAO,EAAiC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,iBAAiB,CAwDvF"}

package/dist/config/factory.js

@@ -0,0 +1,116 @@
+/**
+ * @architect
+ * @architect-core @architect-config
+ * @architect-pattern ArchitectFactory
+ * @architect-status completed
+ * @architect-arch-role service
+ * @architect-arch-context config
+ * @architect-arch-layer application
+ * @architect-include reference-sample
+ * @architect-uses ConfigurationTypes, ConfigurationPresets, RegexBuilders, TagRegistry
+ * @architect-used-by PublicAPI
+ * @architect-extract-shapes CreateArchitectOptions, createArchitect
+ *
+ * ## Architect Factory
+ *
+ * Main factory function for creating configured Architect instances.
+ * Supports presets, custom configuration, and configuration overrides.
+ *
+ * ### When to Use
+ *
+ * - At application startup to create a configured instance
+ * - When switching between different tag prefixes
+ * - When customizing the taxonomy for a specific project
+ */
+import { buildRegistry } from '../taxonomy/registry-builder.js';
+import { createRegexBuilders } from './regex-builders.js';
+import { LIBAR_GENERIC_PRESET, PRESETS } from './presets.js';
+/**
+ * Creates a configured Architect instance.
+ *
+ * Configuration resolution order:
+ * 1. Start with preset (or libar-generic default)
+ * 2. Preset categories REPLACE base taxonomy categories (not merged)
+ * 3. Apply explicit overrides (tagPrefix, fileOptInTag, categories)
+ * 4. Create regex builders from final configuration
+ *
+ * Note: Presets define complete category sets. The libar-generic preset
+ * has 3 categories (core, api, infra), while ddd-es-cqrs has 21.
+ * Categories from the preset replace base categories entirely.
+ *
+ * @param options - Configuration options
+ * @returns Configured Architect instance
+ *
+ * @example
+ * ```typescript
+ * // Use the default preset
+ * const dp = createArchitect();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Custom prefix with DDD taxonomy
+ * const dp = createArchitect({
+ *   preset: "ddd-es-cqrs",
+ *   tagPrefix: "@my-project-",
+ *   fileOptInTag: "@my-project"
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Default (libar-generic preset with 3 categories)
+ * const dp = createArchitect();
+ * ```
+ */
+export function createArchitect(options = {}) {
+    // Start with preset or default to libar-generic
+    const baseConfig = options.preset ? PRESETS[options.preset] : LIBAR_GENERIC_PRESET;
+    // Apply overrides
+    const tagPrefix = options.tagPrefix ?? baseConfig.tagPrefix;
+    const fileOptInTag = options.fileOptInTag ?? baseConfig.fileOptInTag;
+    const categories = options.categories ?? baseConfig.categories;
+    // Build the base registry from taxonomy constants (readonly)
+    const baseRegistry = buildRegistry();
+    // Convert readonly arrays to mutable (buildRegistry returns readonly `as const` arrays)
+    const mutableBaseRegistry = {
+        version: baseRegistry.version,
+        categories: [...baseRegistry.categories].map((c) => ({
+            ...c,
+            aliases: [...c.aliases],
+        })),
+        metadataTags: [...baseRegistry.metadataTags].map((t) => ({
+            ...t,
+            values: t.values ? [...t.values] : undefined,
+            required: t.required ?? false,
+            repeatable: t.repeatable ?? false,
+        })),
+        aggregationTags: [...baseRegistry.aggregationTags],
+        formatOptions: [...baseRegistry.formatOptions],
+        tagPrefix: baseRegistry.tagPrefix,
+        fileOptInTag: baseRegistry.fileOptInTag,
+    };
+    // Create mutable categories from preset
+    const mutableCategories = [...categories].map((c) => ({
+        tag: c.tag,
+        domain: c.domain,
+        priority: c.priority,
+        description: c.description,
+        aliases: [...c.aliases],
+    }));
+    // Create registry with preset categories REPLACING base categories (not merging).
+    // This ensures libar-generic preset gets only 3 categories, not all 21 DDD categories.
+    const registry = {
+        ...mutableBaseRegistry,
+        tagPrefix,
+        fileOptInTag,
+        categories: mutableCategories,
+    };
+    // Create regex builders
+    const regexBuilders = createRegexBuilders(tagPrefix, fileOptInTag);
+    return {
+        registry,
+        regexBuilders,
+    };
+}
+//# sourceMappingURL=factory.js.map

package/dist/config/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/config/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAmB,MAAM,cAAc,CAAC;AAgB9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkC,EAAE;IAClE,gDAAgD;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC;IAEnF,kBAAkB;IAClB,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC,SAAS,CAAC;IAC5D,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,UAAU,CAAC,YAAY,CAAC;IACrE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC;IAE/D,6DAA6D;IAC7D,MAAM,YAAY,GAAG,aAAa,EAAE,CAAC;IAErC,wFAAwF;IACxF,MAAM,mBAAmB,GAAgB;QACvC,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,UAAU,EAAE,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnD,GAAG,CAAC;YACJ,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;SACxB,CAAC,CAAC;QACH,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvD,GAAG,CAAC;YACJ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5C,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,KAAK;YAC7B,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,KAAK;SAClC,CAAC,CAAC;QACH,eAAe,EAAE,CAAC,GAAG,YAAY,CAAC,eAAe,CAAC;QAClD,aAAa,EAAE,CAAC,GAAG,YAAY,CAAC,aAAa,CAAC;QAC9C,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,YAAY,EAAE,YAAY,CAAC,YAAY;KACxC,CAAC;IAEF,wCAAwC;IACxC,MAAM,iBAAiB,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;KACxB,CAAC,CAAC,CAAC;IAEJ,kFAAkF;IAClF,uFAAuF;IACvF,MAAM,QAAQ,GAAgB;QAC5B,GAAG,mBAAmB;QACtB,SAAS;QACT,YAAY;QACZ,UAAU,EAAE,iBAAiB;KAC9B,CAAC;IAEF,wBAAwB;IACxB,MAAM,aAAa,GAAG,mBAAmB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEnE,OAAO;QACL,QAAQ;QACR,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Configuration Module
+ *
+ * Unified project configuration for Architect. Use `defineConfig()` in
+ * `architect.config.ts` or `architect.config.js` to centralize taxonomy, sources, output, and
+ * generator overrides.
+ *
+ * @example
+ * ```typescript
+ * import { defineConfig } from '@libar-dev/architect/config';
+ *
+ * // Unified config file
+ * export default defineConfig({
+ *   preset: 'ddd-es-cqrs',
+ *   sources: { typescript: ['src/** /*.ts'] },
+ *   output: { directory: 'docs-generated', overwrite: true },
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { loadProjectConfig } from '@libar-dev/architect/config';
+ *
+ * // Programmatic loading
+ * const result = await loadProjectConfig(process.cwd());
+ * if (result.ok) {
+ *   const { instance, project } = result.value;
+ * }
+ * ```
+ */
+export { createArchitect, type CreateArchitectOptions } from './factory.js';
+export type { ArchitectConfig, ArchitectInstance, RegexBuilders } from './types.js';
+export { createRegexBuilders } from './regex-builders.js';
+export { DEFAULT_TAG_PREFIX, DEFAULT_FILE_OPT_IN_TAG, DEFAULT_REGEX_BUILDERS } from './defaults.js';
+export { LIBAR_GENERIC_PRESET, DDD_ES_CQRS_PRESET, PRESETS, type PresetName } from './presets.js';
+export { loadConfig, loadProjectConfig, applyProjectSourceDefaults, findConfigFile, formatConfigError, type ConfigDiscoveryResult, type ConfigLoadError, type ConfigLoadResult, type ProjectConfigLoadResult, } from './config-loader.js';
+export { loadWorkflowFromPath, loadDefaultWorkflow, formatWorkflowLoadError, type WorkflowLoadError, type LoadedWorkflow, type WorkflowConfig, } from './workflow-loader.js';
+export { defineConfig } from './define-config.js';
+export type { ArchitectProjectConfig, SourcesConfig, OutputConfig, GeneratorSourceOverride, ResolvedConfig, ResolvedProjectConfig, ResolvedSourcesConfig, } from './project-config.js';
+export { ArchitectProjectConfigSchema, SourcesConfigSchema, OutputConfigSchema, GeneratorSourceOverrideSchema, isProjectConfig, } from './project-config-schema.js';
+export { resolveProjectConfig, createDefaultResolvedConfig } from './resolve-config.js';
+export { mergeSourcesForGenerator } from './merge-sources.js';
+export type { ReferenceDocConfig, DiagramScope } from '../renderable/codecs/reference.js';
+export type { ShapeSelector } from '../renderable/codecs/shape-matcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAG5E,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAGpG,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAGlG,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,EACd,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAC1F,YAAY,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,48 @@
+/**
+ * Configuration Module
+ *
+ * Unified project configuration for Architect. Use `defineConfig()` in
+ * `architect.config.ts` or `architect.config.js` to centralize taxonomy, sources, output, and
+ * generator overrides.
+ *
+ * @example
+ * ```typescript
+ * import { defineConfig } from '@libar-dev/architect/config';
+ *
+ * // Unified config file
+ * export default defineConfig({
+ *   preset: 'ddd-es-cqrs',
+ *   sources: { typescript: ['src/** /*.ts'] },
+ *   output: { directory: 'docs-generated', overwrite: true },
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { loadProjectConfig } from '@libar-dev/architect/config';
+ *
+ * // Programmatic loading
+ * const result = await loadProjectConfig(process.cwd());
+ * if (result.ok) {
+ *   const { instance, project } = result.value;
+ * }
+ * ```
+ */
+// Factory function
+export { createArchitect } from './factory.js';
+// Regex builders (for advanced use cases)
+export { createRegexBuilders } from './regex-builders.js';
+// Default constants (for internal use)
+export { DEFAULT_TAG_PREFIX, DEFAULT_FILE_OPT_IN_TAG, DEFAULT_REGEX_BUILDERS } from './defaults.js';
+// Presets
+export { LIBAR_GENERIC_PRESET, DDD_ES_CQRS_PRESET, PRESETS } from './presets.js';
+// Config file discovery and loading
+export { loadConfig, loadProjectConfig, applyProjectSourceDefaults, findConfigFile, formatConfigError, } from './config-loader.js';
+export { loadWorkflowFromPath, loadDefaultWorkflow, formatWorkflowLoadError, } from './workflow-loader.js';
+// Unified project configuration
+export { defineConfig } from './define-config.js';
+export { ArchitectProjectConfigSchema, SourcesConfigSchema, OutputConfigSchema, GeneratorSourceOverrideSchema, isProjectConfig, } from './project-config-schema.js';
+// Config resolution and source merging
+export { resolveProjectConfig, createDefaultResolvedConfig } from './resolve-config.js';
+export { mergeSourcesForGenerator } from './merge-sources.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAA+B,MAAM,cAAc,CAAC;AAK5E,0CAA0C;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,uCAAuC;AACvC,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEpG,UAAU;AACV,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,OAAO,EAAmB,MAAM,cAAc,CAAC;AAElG,oCAAoC;AACpC,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,EACd,iBAAiB,GAKlB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GAIxB,MAAM,sBAAsB,CAAC;AAE9B,gCAAgC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUlD,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,kBAAkB,EAClB,6BAA6B,EAC7B,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAEpC,uCAAuC;AACvC,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/config/merge-sources.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @architect
+ * @architect-core @architect-config
+ * @architect-pattern SourceMerger
+ * @architect-status active
+ * @architect-arch-layer application
+ * @architect-arch-context config
+ * @architect-arch-role service
+ * @architect-uses ProjectConfigTypes
+ * @architect-used-by ConfigResolver
+ *
+ * ## Source Merging
+ *
+ * Computes effective sources for a specific generator by applying
+ * per-generator overrides to the base resolved sources.
+ *
+ * ### Override Semantics
+ *
+ * - `replaceFeatures` (non-empty): Used INSTEAD of base features
+ * - `additionalFeatures`: Appended to base features (ignored if `replaceFeatures` is set)
+ * - `additionalInput`: Appended to base TypeScript sources
+ * - `exclude`: Always inherited from base (no override mechanism)
+ *
+ * ### When to Use
+ *
+ * - Called by the orchestrator before invoking each generator to apply per-generator source overrides.
+ */
+import type { GeneratorSourceOverride, ResolvedSourcesConfig } from './project-config.js';
+/**
+ * Computes effective sources for a specific generator by merging
+ * base sources with any per-generator overrides.
+ *
+ * If no override exists for the given generator, the base sources
+ * are returned unchanged. When an override is found:
+ *
+ * - `replaceFeatures` (non-empty array) replaces base features entirely
+ * - Otherwise, `additionalFeatures` are appended to base features
+ * - `additionalInput` is always appended to base TypeScript sources
+ * - `exclude` is always inherited from base (never overridden)
+ *
+ * @param base - The resolved base sources from project config
+ * @param generatorName - The name of the generator to resolve sources for
+ * @param overrides - Per-generator source override map
+ * @returns The effective sources for the specified generator
+ */
+export declare function mergeSourcesForGenerator(base: ResolvedSourcesConfig, generatorName: string, overrides: Readonly<Record<string, GeneratorSourceOverride>>): ResolvedSourcesConfig;
+//# sourceMappingURL=merge-sources.d.ts.map

package/dist/config/merge-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-sources.d.ts","sourceRoot":"","sources":["../../src/config/merge-sources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE1F;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,qBAAqB,EAC3B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,GAC3D,qBAAqB,CAoBvB"}