polen 0.11.0-next.24 → 0.11.0-next.26

package/build/api/reference/config.js

@@ -0,0 +1,162 @@
+import { Diagnostic } from '#lib/diagnostic/$';
+import { S } from '#lib/kit-temp/effect';
+// ============================================================================
+// Schema - Reference Diagnostics
+// ============================================================================
+/**
+ * Diagnostic controls for reference documentation.
+ */
+export const ReferenceDiagnostics = S.Struct({
+    /**
+     * Control diagnostics for missing or invalid reference content.
+     *
+     * @default true (info in dev, warning in build)
+     */
+    validation: S.optional(S.Union(S.Boolean, Diagnostic.Control)),
+}).annotations({
+    identifier: 'ReferenceDiagnostics',
+    description: 'Diagnostic controls for reference documentation',
+});
+// ============================================================================
+// Schema - Descriptions View
+// ============================================================================
+/**
+ * Configuration for how descriptions are displayed in reference documentation.
+ */
+export const DescriptionsView = S.Struct({
+    /**
+     * Default view mode for descriptions.
+     * - 'expanded': Show full descriptions (default)
+     * - 'compact': Show condensed view
+     *
+     * @default 'expanded'
+     */
+    defaultMode: S.optional(S.Literal('compact', 'expanded')),
+    /**
+     * Whether to show the view mode toggle control.
+     * Allows users to switch between compact and expanded views.
+     *
+     * @default true
+     */
+    showControl: S.optional(S.Boolean),
+}).annotations({
+    identifier: 'DescriptionsView',
+    description: 'Configuration for descriptions display in reference documentation',
+});
+// ============================================================================
+// Schema - Reference Config
+// ============================================================================
+export const ReferenceConfigObject = S.Struct({
+    /**
+     * Control whether the reference documentation is enabled.
+     * - true: Always enabled (show in nav even if no schema exists)
+     * - false: Always disabled (hide even if schema exists)
+     * - undefined: Auto-detect based on schema presence (default behavior)
+     *
+     * @default undefined (auto-detect based on schema presence)
+     * @example
+     * // Always show reference section
+     * reference: { enabled: true }
+     *
+     * @example
+     * // Never show reference
+     * reference: { enabled: false }
+     *
+     * @example
+     * // Auto-detect based on schema (default)
+     * reference: { }
+     */
+    enabled: S.optional(S.Boolean),
+    /**
+     * Configuration for how descriptions are displayed.
+     *
+     * @example
+     * // Use compact mode by default
+     * descriptionsView: {
+     *   defaultMode: 'compact'
+     * }
+     *
+     * @example
+     * // Hide the view mode toggle
+     * descriptionsView: {
+     *   showControl: false
+     * }
+     */
+    descriptionsView: S.optional(DescriptionsView),
+    /**
+     * Configuration for how field nullability is rendered.
+     * - 'bangMark': Show '!' after non-nullable types (GraphQL style)
+     * - 'questionMark': Show '?' after nullable field names (TypeScript style)
+     *
+     * @default 'bangMark'
+     * @example
+     * // Use TypeScript-style nullability rendering
+     * nullabilityRendering: 'questionMark'
+     */
+    nullabilityRendering: S.optional(S.Literal('questionMark', 'bangMark')),
+    /**
+     * Diagnostic controls for reference documentation.
+     *
+     * @example
+     * // Enable all diagnostics with defaults
+     * diagnostics: {
+     *   validation: true
+     * }
+     *
+     * @example
+     * // Fine-grained control
+     * diagnostics: {
+     *   validation: {
+     *     enabled: true,
+     *     dev: { severity: 'error' },
+     *     build: { severity: 'warning' }
+     *   }
+     * }
+     */
+    diagnostics: S.optional(ReferenceDiagnostics),
+}).annotations({
+    identifier: 'ReferenceConfigObject',
+    title: 'Reference Configuration',
+    description: 'Configuration for reference documentation feature',
+});
+/**
+ * Reference configuration with boolean shorthand support.
+ * - true: Enable with defaults
+ * - false: Disable completely
+ * - object: Fine-grained control
+ */
+export const ReferenceConfig = S.transform(S.Union(S.Boolean, ReferenceConfigObject), ReferenceConfigObject, {
+    strict: false,
+    decode: (input) => {
+        if (typeof input === 'boolean') {
+            return {
+                enabled: input,
+                descriptionsView: {},
+                nullabilityRendering: undefined,
+                diagnostics: {},
+            };
+        }
+        return input;
+    },
+    encode: (config) => config,
+}).annotations({
+    identifier: 'ReferenceConfig',
+    title: 'Reference Configuration',
+    description: 'Reference documentation configuration with boolean shortcuts',
+});
+// ============================================================================
+// Constructors
+// ============================================================================
+export const make = ReferenceConfigObject.make;
+// ============================================================================
+// Type Guards
+// ============================================================================
+export const is = S.is(ReferenceConfig);
+// ============================================================================
+// Codecs
+// ============================================================================
+export const decode = S.decode(ReferenceConfig);
+export const decodeSync = S.decodeSync(ReferenceConfig);
+export const encode = S.encode(ReferenceConfig);
+export const encodeSync = S.encodeSync(ReferenceConfig);
+//# sourceMappingURL=config.js.map

package/build/api/reference/config.js.map

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

package/build/api/reference/scanner.d.ts

@@ -0,0 +1,26 @@
+import { Diagnostic } from '#lib/diagnostic/$';
+import { FileSystem } from '@effect/platform';
+import { Effect } from 'effect';
+import * as Catalog from './catalog.js';
+export interface ScanOptions {
+    /**
+     * The directory to scan for reference content
+     */
+    dir: string;
+}
+export interface ScanResult {
+    /**
+     * The reference catalog with index metadata
+     */
+    catalog: Catalog.Catalog;
+    /**
+     * Any diagnostics generated during scanning
+     */
+    diagnostics: Diagnostic.Diagnostic[];
+}
+/**
+ * Scan for reference documentation content.
+ * Currently looks for index.md or index.mdx files for custom landing pages.
+ */
+export declare const scan: (options: ScanOptions) => Effect.Effect<ScanResult, Error, FileSystem.FileSystem>;
+//# sourceMappingURL=scanner.d.ts.map

package/build/api/reference/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/api/reference/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC,OAAO,CAAA;IACxB;;OAEG;IACH,WAAW,EAAE,UAAU,CAAC,UAAU,EAAE,CAAA;CACrC;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,GACf,SAAS,WAAW,KACnB,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAsBrD,CAAA"}

package/build/api/reference/scanner.js

@@ -0,0 +1,27 @@
+import { Diagnostic } from '#lib/diagnostic/$';
+import { FileSystem } from '@effect/platform';
+import { Effect } from 'effect';
+import * as Path from 'node:path';
+import * as Catalog from './catalog.js';
+/**
+ * Scan for reference documentation content.
+ * Currently looks for index.md or index.mdx files for custom landing pages.
+ */
+export const scan = (options) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const diagnostics = [];
+    // Check for index.md or index.mdx file
+    const indexMdPath = Path.join(options.dir, 'reference', 'index.md');
+    const indexMdxPath = Path.join(options.dir, 'reference', 'index.mdx');
+    // Try index.md first, then index.mdx
+    const indexPath = (yield* fs.exists(indexMdPath))
+        ? indexMdPath
+        : (yield* fs.exists(indexMdxPath))
+            ? indexMdxPath
+            : null;
+    const catalog = Catalog.make({
+        index: indexPath ? { path: indexPath } : undefined,
+    });
+    return { catalog, diagnostics };
+});
+//# sourceMappingURL=scanner.js.map

package/build/api/reference/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../../src/api/reference/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAoBvC;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,OAAoB,EACqC,EAAE,CAC3D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAA;IAEvC,MAAM,WAAW,GAA4B,EAAE,CAAA;IAE/C,uCAAuC;IACvC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,UAAU,CAAC,CAAA;IACnE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;IAErE,qCAAqC;IACrC,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC/C,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAClC,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,IAAI,CAAA;IAER,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;QAC3B,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;KACnD,CAAC,CAAA;IAEF,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAA;AACjC,CAAC,CAAC,CAAA"}

package/build/api/schema/augmentations/$$.d.ts

@@ -0,0 +1,7 @@
+export * from './apply.js';
+export * from './augmentation.js';
+export * from './config.js';
+export { Diagnostic } from './diagnostics/diagnostic.js';
+export * from './input.js';
+export * from './placement.js';
+//# sourceMappingURL=$$.d.ts.map

package/build/api/schema/augmentations/$$.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/augmentations/$$.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}

package/build/api/schema/augmentations/$$.js

@@ -0,0 +1,7 @@
+export * from './apply.js';
+export * from './augmentation.js';
+export * from './config.js';
+export { Diagnostic } from './diagnostics/diagnostic.js';
+export * from './input.js';
+export * from './placement.js';
+//# sourceMappingURL=$$.js.map

package/build/api/schema/augmentations/$$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.js","sourceRoot":"","sources":["../../../../src/api/schema/augmentations/$$.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}

package/build/api/schema/augmentations/$.d.ts

@@ -1,2 +1,2 @@
-export * as Augmentations from './schema-augmentation.js';
+export * as Augmentations from './$$.js';
 //# sourceMappingURL=$.d.ts.map

package/build/api/schema/augmentations/$.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/augmentations/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/augmentations/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,SAAS,CAAA"}

package/build/api/schema/augmentations/$.js

@@ -1,2 +1,2 @@
-export * as Augmentations from './schema-augmentation.js';
+export * as Augmentations from './$$.js';
 //# sourceMappingURL=$.js.map

package/build/api/schema/augmentations/$.js.map

@@ -1 +1 @@
-{"version":3,"file":"$.js","sourceRoot":"","sources":["../../../../src/api/schema/augmentations/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"$.js","sourceRoot":"","sources":["../../../../src/api/schema/augmentations/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,SAAS,CAAA"}

package/build/api/schema/augmentations/apply.d.ts

@@ -0,0 +1,29 @@
+import type { Augmentation } from '#api/schema/augmentations/augmentation';
+import type { AugmentationConfig } from '#api/schema/augmentations/config';
+import { Diagnostic } from '#api/schema/augmentations/diagnostics/diagnostic';
+import type { AugmentationInput } from '#api/schema/augmentations/input';
+import type { GrafaidOld } from '#lib/grafaid-old';
+import { Version } from '#lib/version/$';
+/**
+ * Apply version-aware augmentations to a schema.
+ *
+ * @param schema - The GraphQL schema to augment (mutated in place)
+ * @param augmentations - The input augmentations (may include version specifications)
+ * @param version - The specific version to apply augmentations for (null for unversioned)
+ * @returns Diagnostics generated during augmentation application
+ */
+export declare const applyAll: (schema: GrafaidOld.Schema.Schema, augmentations: readonly AugmentationInput[], version?: Version.Version | null) => {
+    diagnostics: Diagnostic[];
+};
+export declare const apply: (schema: GrafaidOld.Schema.Schema, augmentation: AugmentationConfig) => Diagnostic[];
+/**
+ * Apply a version-aware augmentation to a schema.
+ *
+ * @param schema - The GraphQL schema to augment
+ * @param augmentation - The normalized augmentation with version coverage
+ * @param version - The specific version to apply augmentations for (null for unversioned)
+ * @returns Diagnostics generated during augmentation application
+ */
+export declare const applyVersioned: (schema: GrafaidOld.Schema.Schema, augmentation: Augmentation, version: Version.Version | null) => Diagnostic[];
+export declare const mutateDescription: (type: GrafaidOld.Groups.Describable, augmentation: AugmentationConfig) => void;
+//# sourceMappingURL=apply.d.ts.map

package/build/api/schema/augmentations/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/augmentations/apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAA;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAC1E,OAAO,EACL,UAAU,EAIX,MAAM,kDAAkD,CAAA;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAExE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAGlD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAGxC;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GACnB,QAAQ,UAAU,CAAC,MAAM,CAAC,MAAM,EAChC,eAAe,SAAS,iBAAiB,EAAE,EAC3C,UAAS,OAAO,CAAC,OAAO,GAAG,IAAW,KACrC;IAAE,WAAW,EAAE,UAAU,EAAE,CAAA;CAqC7B,CAAA;AAED,eAAO,MAAM,KAAK,GAChB,QAAQ,UAAU,CAAC,MAAM,CAAC,MAAM,EAChC,cAAc,kBAAkB,KAC/B,UAAU,EA2DZ,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,UAAU,CAAC,MAAM,CAAC,MAAM,EAChC,cAAc,YAAY,EAC1B,SAAS,OAAO,CAAC,OAAO,GAAG,IAAI,KAC9B,UAAU,EAiHZ,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC5B,MAAM,UAAU,CAAC,MAAM,CAAC,WAAW,EACnC,cAAc,kBAAkB,SAgBjC,CAAA"}

package/build/api/schema/augmentations/apply.js

@@ -0,0 +1,181 @@
+import { Diagnostic, makeDiagnosticDuplicateVersion, makeDiagnosticInvalidPath, makeDiagnosticVersionMismatch, } from '#api/schema/augmentations/diagnostics/diagnostic';
+import { normalizeAugmentationInput } from '#api/schema/augmentations/input';
+import { GraphQLPath } from '#lib/graphql-path';
+import { VersionCoverage } from '#lib/version-coverage';
+import { Version } from '#lib/version/$';
+import { Either, HashMap, Match, Option, pipe } from 'effect';
+/**
+ * Apply version-aware augmentations to a schema.
+ *
+ * @param schema - The GraphQL schema to augment (mutated in place)
+ * @param augmentations - The input augmentations (may include version specifications)
+ * @param version - The specific version to apply augmentations for (null for unversioned)
+ * @returns Diagnostics generated during augmentation application
+ */
+export const applyAll = (schema, augmentations, version = null) => {
+    const diagnostics = [];
+    // Track versions to detect duplicates
+    const seenVersions = new Map();
+    for (const augmentationInput of augmentations) {
+        // Check for duplicate versions
+        const versionKey = augmentationInput.versions
+            ? Object.keys(augmentationInput.versions).sort().join(',')
+            : 'unversioned';
+        if (seenVersions.has(versionKey) && versionKey !== 'unversioned') {
+            const firstInput = seenVersions.get(versionKey);
+            diagnostics.push(makeDiagnosticDuplicateVersion({
+                message: `Duplicate version '${versionKey}' found in augmentation configuration`,
+                version: versionKey,
+                firstPath: firstInput.on ?? 'unknown',
+                duplicatePath: augmentationInput.on ?? 'unknown',
+            }));
+            continue;
+        }
+        seenVersions.set(versionKey, augmentationInput);
+        // Transform input to normalized format
+        const normalized = normalizeAugmentationInput(augmentationInput);
+        if (!normalized) {
+            console.warn('Skipping invalid augmentation configuration');
+            continue;
+        }
+        const applyDiagnostics = applyVersioned(schema, normalized, version);
+        diagnostics.push(...applyDiagnostics);
+    }
+    return { diagnostics };
+};
+export const apply = (schema, augmentation) => {
+    const diagnostics = [];
+    pipe(augmentation.on, Match.value, Match.when(GraphQLPath.Definition.isTypeDefinitionPath, (path) => {
+        pipe(GraphQLPath.Schema.locateType(schema, path), Either.match({
+            onLeft: (error) => {
+                diagnostics.push(makeDiagnosticInvalidPath({
+                    message: `Type '${error.typeName}' not found in schema`,
+                    path: error.path,
+                    version: null,
+                    error: `Type '${error.typeName}' not found`,
+                }));
+            },
+            onRight: (type) => {
+                mutateDescription(type, augmentation);
+            },
+        }));
+    }), Match.when(GraphQLPath.Definition.isFieldDefinitionPath, (path) => {
+        pipe(GraphQLPath.Schema.locateField(schema, path), Either.match({
+            onLeft: (error) => {
+                diagnostics.push(makeDiagnosticInvalidPath({
+                    message: `Field '${error.fieldName}' not found on type '${error.typeName}'`,
+                    path: error.path,
+                    version: null,
+                    error: `Field '${error.fieldName}' not found on type '${error.typeName}'`,
+                }));
+            },
+            onRight: (field) => {
+                mutateDescription(field, augmentation);
+            },
+        }));
+    }), Match.orElse(() => {
+        diagnostics.push(makeDiagnosticInvalidPath({
+            message: `Unsupported path type for augmentations: ${GraphQLPath.Definition.encodeSync(augmentation.on)}`,
+            path: GraphQLPath.Definition.encodeSync(augmentation.on),
+            version: null,
+            error: 'Unsupported path type for augmentations',
+        }));
+    }));
+    return diagnostics;
+};
+/**
+ * Apply a version-aware augmentation to a schema.
+ *
+ * @param schema - The GraphQL schema to augment
+ * @param augmentation - The normalized augmentation with version coverage
+ * @param version - The specific version to apply augmentations for (null for unversioned)
+ * @returns Diagnostics generated during augmentation application
+ */
+export const applyVersioned = (schema, augmentation, version) => {
+    const diagnostics = [];
+    // Try to find augmentation for this specific version
+    let config;
+    if (version) {
+        // First try exact version match
+        const versionCoverage = VersionCoverage.single(version);
+        const maybeConfig = HashMap.get(augmentation.versionAugmentations, versionCoverage);
+        if (Option.isSome(maybeConfig)) {
+            config = maybeConfig.value;
+        }
+        // If not found, check if any coverage matches this version
+        if (!config) {
+            for (const [coverage, cfg] of augmentation.versionAugmentations) {
+                if (VersionCoverage.matches(coverage, version)) {
+                    config = cfg;
+                    break;
+                }
+            }
+        }
+    }
+    else {
+        // For unversioned schemas, only apply unversioned augmentations
+        const unversionedCoverage = VersionCoverage.unversioned();
+        const maybeConfig = HashMap.get(augmentation.versionAugmentations, unversionedCoverage);
+        if (Option.isSome(maybeConfig)) {
+            config = maybeConfig.value;
+        }
+    }
+    // Apply the augmentation if found
+    if (config) {
+        pipe(config.on, Match.value, Match.when(GraphQLPath.Definition.isTypeDefinitionPath, (path) => {
+            pipe(GraphQLPath.Schema.locateType(schema, path), Either.match({
+                onLeft: (error) => {
+                    diagnostics.push(makeDiagnosticInvalidPath({
+                        message: `Type '${error.typeName}' not found in schema`,
+                        path: error.path,
+                        version: version,
+                        error: `Type '${error.typeName}' not found`,
+                    }));
+                },
+                onRight: (type) => {
+                    mutateDescription(type, config);
+                },
+            }));
+        }), Match.when(GraphQLPath.Definition.isFieldDefinitionPath, (path) => {
+            pipe(GraphQLPath.Schema.locateField(schema, path), Either.match({
+                onLeft: (error) => {
+                    diagnostics.push(makeDiagnosticInvalidPath({
+                        message: `Field '${error.fieldName}' not found on type '${error.typeName}'`,
+                        path: error.path,
+                        version: version,
+                        error: `Field '${error.fieldName}' not found on type '${error.typeName}'`,
+                    }));
+                },
+                onRight: (field) => {
+                    mutateDescription(field, config);
+                },
+            }));
+        }), Match.orElse(() => {
+            diagnostics.push(makeDiagnosticInvalidPath({
+                message: `Unsupported path type for augmentations: ${GraphQLPath.Definition.encodeSync(config.on)}`,
+                path: GraphQLPath.Definition.encodeSync(config.on),
+                version: version,
+                error: 'Unsupported path type for augmentations',
+            }));
+        }));
+    }
+    else if (version && HashMap.size(augmentation.versionAugmentations) > 0) {
+        // No matching version coverage found - generate version mismatch diagnostic
+        // Get first config from HashMap
+        const firstEntry = pipe(augmentation.versionAugmentations, HashMap.values, (iter) => Array.from(iter)[0]);
+        if (firstEntry) {
+            diagnostics.push(makeDiagnosticVersionMismatch({
+                message: `No augmentation found for version '${version}' on path '${GraphQLPath.Definition.encodeSync(firstEntry.on)}'`,
+                path: GraphQLPath.Definition.encodeSync(firstEntry.on),
+                requestedVersion: version,
+                availableVersions: pipe(augmentation.versionAugmentations, HashMap.keys, (iter) => Array.from(iter).map(VersionCoverage.toLabel)),
+            }));
+        }
+    }
+    return diagnostics;
+};
+export const mutateDescription = (type, augmentation) => {
+    const existingDescription = type.description?.trim() ?? '';
+    type.description = Match.value(augmentation.placement).pipe(Match.when('before', () => existingDescription ? `${augmentation.content}\n\n${existingDescription}` : augmentation.content), Match.when('after', () => existingDescription ? `${existingDescription}\n\n${augmentation.content}` : augmentation.content), Match.when('over', () => augmentation.content), Match.exhaustive);
+};
+//# sourceMappingURL=apply.js.map

package/build/api/schema/augmentations/apply.js.map

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

package/build/api/schema/augmentations/augmentation.d.ts

@@ -0,0 +1,31 @@
+import { S } from '#lib/kit-temp/effect';
+import { VersionCoverage } from '#lib/version-coverage';
+/**
+ * Internal normalized schema for description augmentations.
+ * Uses VersionCoverage as keys to support unversioned (all versions) and version-specific augmentations.
+ */
+export declare const Augmentation: S.Struct<{
+    versionAugmentations: S.HashMap<S.Union<[typeof VersionCoverage.VersionCoverageUnversioned, S.transformOrFail<S.Union<[typeof S.String, typeof S.Number]>, S.Union<[typeof import("../../../lib/version/integer.js").Integer, typeof import("../../../lib/version/semver.js").Semver, typeof import("../../../lib/version/date.js").Date, typeof import("../../../lib/version/custom.js").Custom]>, never>, S.HashSet<S.transformOrFail<S.Union<[typeof S.String, typeof S.Number]>, S.Union<[typeof import("../../../lib/version/integer.js").Integer, typeof import("../../../lib/version/semver.js").Semver, typeof import("../../../lib/version/date.js").Date, typeof import("../../../lib/version/custom.js").Custom]>, never>>]>, S.Struct<{
+        on: S.Union<[S.transformOrFail<typeof S.String, S.Tuple<[S.TaggedStruct<"TypeSegment", {
+            type: typeof S.String;
+        }>, S.TaggedStruct<"FieldSegment", {
+            field: typeof S.String;
+        }>, S.TaggedStruct<"ArgumentSegment", {
+            argument: typeof S.String;
+        }>]>, never>, S.transformOrFail<typeof S.String, S.Tuple2<S.TaggedStruct<"TypeSegment", {
+            type: typeof S.String;
+        }>, S.TaggedStruct<"FieldSegment", {
+            field: typeof S.String;
+        }>>, never>, S.transformOrFail<typeof S.String, S.Tuple<[S.TaggedStruct<"TypeSegment", {
+            type: typeof S.String;
+        }>]>, never>]>;
+        placement: S.Enums<{
+            readonly before: "before";
+            readonly after: "after";
+            readonly over: "over";
+        }>;
+        content: typeof S.String;
+    }>>;
+}>;
+export type Augmentation = S.Schema.Type<typeof Augmentation>;
+//# sourceMappingURL=augmentation.d.ts.map

package/build/api/schema/augmentations/augmentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"augmentation.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/augmentations/augmentation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;EAavB,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,YAAY,CAAC,CAAA"}

package/build/api/schema/augmentations/augmentation.js

@@ -0,0 +1,22 @@
+import { AugmentationConfig } from '#api/schema/augmentations/config';
+import { S } from '#lib/kit-temp/effect';
+import { VersionCoverage } from '#lib/version-coverage';
+/**
+ * Internal normalized schema for description augmentations.
+ * Uses VersionCoverage as keys to support unversioned (all versions) and version-specific augmentations.
+ */
+export const Augmentation = S.Struct({
+    // Map from VersionCoverage to augmentation config
+    // Key can be:
+    // - VersionCoverageUnversioned: applies to all versions
+    // - VersionCoverageOne: applies to a specific version
+    // - VersionCoverageSet: applies to a set of versions (future enhancement)
+    versionAugmentations: S.HashMap({
+        key: VersionCoverage.VersionCoverage,
+        value: AugmentationConfig,
+    }),
+}).annotations({
+    identifier: 'AugmentationNormalized',
+    description: 'Internal normalized description augmentation with version coverage support',
+});
+//# sourceMappingURL=augmentation.js.map

package/build/api/schema/augmentations/augmentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"augmentation.js","sourceRoot":"","sources":["../../../../src/api/schema/augmentations/augmentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AACrE,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,kDAAkD;IAClD,cAAc;IACd,wDAAwD;IACxD,sDAAsD;IACtD,0EAA0E;IAC1E,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC;QAC9B,GAAG,EAAE,eAAe,CAAC,eAAe;QACpC,KAAK,EAAE,kBAAkB;KAC1B,CAAC;CACH,CAAC,CAAC,WAAW,CAAC;IACb,UAAU,EAAE,wBAAwB;IACpC,WAAW,EAAE,4EAA4E;CAC1F,CAAC,CAAA"}

package/build/api/schema/augmentations/config.d.ts

@@ -0,0 +1,24 @@
+import { S } from '#lib/kit-temp/effect';
+export declare const AugmentationConfig: S.Struct<{
+    on: S.Union<[S.transformOrFail<typeof S.String, S.Tuple<[S.TaggedStruct<"TypeSegment", {
+        type: typeof S.String;
+    }>, S.TaggedStruct<"FieldSegment", {
+        field: typeof S.String;
+    }>, S.TaggedStruct<"ArgumentSegment", {
+        argument: typeof S.String;
+    }>]>, never>, S.transformOrFail<typeof S.String, S.Tuple2<S.TaggedStruct<"TypeSegment", {
+        type: typeof S.String;
+    }>, S.TaggedStruct<"FieldSegment", {
+        field: typeof S.String;
+    }>>, never>, S.transformOrFail<typeof S.String, S.Tuple<[S.TaggedStruct<"TypeSegment", {
+        type: typeof S.String;
+    }>]>, never>]>;
+    placement: S.Enums<{
+        readonly before: "before";
+        readonly after: "after";
+        readonly over: "over";
+    }>;
+    content: typeof S.String;
+}>;
+export type AugmentationConfig = S.Schema.Type<typeof AugmentationConfig>;
+//# sourceMappingURL=config.d.ts.map

package/build/api/schema/augmentations/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/api/schema/augmentations/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAExC,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;EAI7B,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,kBAAkB,CAAC,CAAA"}

package/build/api/schema/augmentations/config.js

@@ -0,0 +1,9 @@
+import { Placement } from '#api/schema/augmentations/placement';
+import { GraphQLPath } from '#lib/graphql-path';
+import { S } from '#lib/kit-temp/effect';
+export const AugmentationConfig = S.Struct({
+    on: GraphQLPath.Definition.DefinitionPath,
+    placement: Placement,
+    content: S.String,
+});
+//# sourceMappingURL=config.js.map

package/build/api/schema/augmentations/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/api/schema/augmentations/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAExC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,WAAW,CAAC,UAAU,CAAC,cAAc;IACzC,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM;CAClB,CAAC,CAAA"}