polen 0.11.0-next.14 → 0.11.0-next.16

package/build/api/examples/scanner.js

@@ -0,0 +1,264 @@
+import { Catalog as SchemaCatalog } from '#lib/catalog/$';
+import { Document } from '#lib/document/$';
+import { EffectGlob } from '#lib/effect-glob/$';
+import { VersionCoverage } from '#lib/version-selection/$';
+import { Version } from '#lib/version/$';
+import { FileSystem } from '@effect/platform';
+import { Str } from '@wollybeard/kit';
+import { Effect, HashMap, HashSet, Match } from 'effect';
+import * as Path from 'node:path';
+import { makeDiagnosticDuplicateContent, makeDiagnosticMissingVersions, makeDiagnosticUnknownVersion, makeDiagnosticUnusedDefault, } from './diagnostic/diagnostic.js';
+import { validateExamples } from './diagnostic/validator.js';
+import { Catalog } from './schemas/catalog.js';
+import { Example } from './schemas/example/$.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_EXTENSIONS = ['graphql', 'gql'];
+// Pattern for versioned files: <name>.<version>.graphql
+const VERSIONED_FILE_PATTERN = Str.pattern(/^(?<name>.+?)\.(?<version>.+)$/);
+// ============================================================================
+// Helpers
+// ============================================================================
+const parseExampleFilename = (filename) => {
+    const parsed = Path.parse(filename);
+    const base = parsed.name;
+    // Try to match versioned pattern: <name>.<version>
+    const match = Str.match(base, VERSIONED_FILE_PATTERN);
+    if (match) {
+        const { name, version: versionStr } = match.groups;
+        // Handle special 'default' keyword
+        if (versionStr === 'default') {
+            return { name, version: 'default' };
+        }
+        const decoded = Version.decodeSync(versionStr);
+        // Return canonical version string
+        return { name, version: Version.encodeSync(decoded) };
+    }
+    // No version found - this is an unversioned example
+    return { name: base, version: null };
+};
+const groupExampleFiles = (files) => {
+    const grouped = new Map();
+    for (const file of files) {
+        const { name, version } = parseExampleFilename(file);
+        if (!grouped.has(name)) {
+            grouped.set(name, new Map());
+        }
+        grouped.get(name).set(version, file);
+    }
+    return grouped;
+};
+const lintFileLayout = (example, schemaCatalog) => {
+    // Extract schema versions from catalog if provided
+    const schemaVersions = schemaCatalog
+        ? SchemaCatalog.fold((versioned) => versioned.entries.map(entry => Version.encodeSync(entry.version)), (unversioned) => unversioned.schema.revisions?.map(r => r.date) ?? [])(schemaCatalog)
+        : [];
+    const diagnostics = [];
+    Match.value(example.document).pipe(Match.tagsExhaustive({
+        DocumentVersioned: (doc) => {
+            // Get all versions covered by this document
+            const coveredVersions = Document.Versioned.getAllVersions(doc);
+            const coveredVersionStrings = coveredVersions.map(Version.encodeSync);
+            const missingVersions = schemaVersions.filter(sv => !coveredVersionStrings.includes(sv));
+            if (missingVersions.length > 0) {
+                diagnostics.push(makeDiagnosticMissingVersions({
+                    message: `Versioned example must provide documents for all schema versions`,
+                    example: { name: example.name, path: example.path },
+                    providedVersions: coveredVersionStrings,
+                    missingVersions,
+                }));
+            }
+            // Check for duplicate content between selections
+            const entries = Array.from(HashMap.entries(doc.versionDocuments));
+            const duplicates = [];
+            for (let i = 0; i < entries.length; i++) {
+                for (let j = i + 1; j < entries.length; j++) {
+                    const [sel1, content1] = entries[i];
+                    const [sel2, content2] = entries[j];
+                    if (content1 === content2) {
+                        duplicates.push({
+                            version1: VersionCoverage.toLabel(sel1),
+                            version2: VersionCoverage.toLabel(sel2),
+                        });
+                    }
+                }
+            }
+            if (duplicates.length > 0) {
+                diagnostics.push(makeDiagnosticDuplicateContent({
+                    message: `Multiple version selections have identical content, consider combining them`,
+                    example: { name: example.name, path: example.path },
+                    duplicates,
+                }));
+            }
+        },
+        DocumentUnversioned: () => {
+            // DocumentUnversioned doesn't have version-related diagnostics
+        },
+    }));
+    return diagnostics;
+};
+// ============================================================================
+// Scanner
+// ============================================================================
+export const scan = (options) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+    const pattern = `**/*.{${extensions.join(',')}}`;
+    const files = options.files ?? (yield* EffectGlob.glob(pattern, { cwd: options.dir }));
+    // Group files by example
+    const groupedFiles = groupExampleFiles(files);
+    // Process each example group
+    const examples = [];
+    const diagnostics = [];
+    for (const [name, versions] of groupedFiles) {
+        // Check if this is a versioned or unversioned example
+        const hasMultipleVersions = versions.size > 1;
+        const hasUnversionedFile = versions.has(null);
+        const hasDefaultFile = versions.has('default');
+        const hasOnlyDefaultFile = hasDefaultFile && versions.size === 1;
+        // Determine the base path for this example
+        const firstFilePath = Array.from(versions.values())[0];
+        const basePath = versions.size === 1
+            ? firstFilePath
+            : Path.dirname(firstFilePath);
+        let example;
+        if (hasUnversionedFile && versions.size === 1) {
+            // Unversioned example - single file with no version
+            const filePath = versions.get(null);
+            const fullPath = Path.join(options.dir, filePath);
+            const document = yield* fs.readFileString(fullPath);
+            example = Example.make({
+                name,
+                path: basePath,
+                document: Document.Unversioned.make({
+                    document,
+                }),
+            });
+        }
+        else if (hasOnlyDefaultFile) {
+            // Only default file - create versioned document with all schema versions as a set
+            const filePath = versions.get('default');
+            const fullPath = Path.join(options.dir, filePath);
+            const documentContent = yield* fs.readFileString(fullPath);
+            // Get all schema versions to map to this default document
+            const schemaVersions = options.schemaCatalog
+                ? SchemaCatalog.fold((versioned) => versioned.entries.map(entry => entry.version), () => [])(options.schemaCatalog)
+                : [];
+            if (schemaVersions.length > 0) {
+                // Create a version set for all schema versions
+                const versionSet = HashSet.fromIterable(schemaVersions);
+                let versionDocuments = HashMap.empty();
+                versionDocuments = HashMap.set(versionDocuments, versionSet, documentContent);
+                example = Example.make({
+                    name,
+                    path: basePath,
+                    document: Document.Versioned.make({
+                        versionDocuments,
+                    }),
+                });
+            }
+            else {
+                // No schema versions, treat as unversioned
+                example = Example.make({
+                    name,
+                    path: basePath,
+                    document: Document.Unversioned.make({
+                        document: documentContent,
+                    }),
+                });
+            }
+        }
+        else {
+            // Versioned example - multiple files or versioned files
+            let versionDocuments = HashMap.empty();
+            let defaultDocument;
+            const explicitVersions = new Set(); // Track which versions have explicit files
+            const unknownVersions = [];
+            // Get available schema versions if catalog is provided
+            const schemaVersions = options.schemaCatalog
+                ? SchemaCatalog.fold((versioned) => versioned.entries.map(entry => Version.encodeSync(entry.version)), () => [])(options.schemaCatalog)
+                : [];
+            // Read content for each version
+            for (const [version, filePath] of versions) {
+                const fullPath = Path.join(options.dir, filePath);
+                const fileContent = yield* fs.readFileString(fullPath);
+                if (version === 'default') {
+                    defaultDocument = fileContent;
+                }
+                else if (version !== null) {
+                    // Check if this version exists in the schema
+                    if (options.schemaCatalog && schemaVersions.length > 0 && !schemaVersions.includes(version)) {
+                        unknownVersions.push(version);
+                        // Create diagnostic for unknown version
+                        diagnostics.push(makeDiagnosticUnknownVersion({
+                            message: `Example "${name}" specifies version "${version}" which does not exist in the schema`,
+                            example: { name, path: basePath },
+                            version,
+                            availableVersions: schemaVersions,
+                        }));
+                        // Skip this version - don't include it in the example
+                        continue;
+                    }
+                    const versionObj = Version.decodeSync(version);
+                    versionDocuments = HashMap.set(versionDocuments, versionObj, fileContent);
+                    explicitVersions.add(version);
+                }
+            }
+            if (defaultDocument) {
+                // If we have a default, determine which versions it applies to
+                const defaultVersions = schemaVersions.filter(v => !explicitVersions.has(v));
+                if (defaultVersions.length > 0) {
+                    // Create a version set for the default document
+                    const defaultVersionSet = defaultVersions.length === 1
+                        ? Version.decodeSync(defaultVersions[0]) // Single version
+                        : HashSet.fromIterable(defaultVersions.map(_ => Version.decodeSync(_))); // Version set
+                    versionDocuments = HashMap.set(versionDocuments, defaultVersionSet, defaultDocument);
+                }
+            }
+            if (HashMap.size(versionDocuments) > 0) {
+                // Create versioned document
+                example = Example.make({
+                    name,
+                    path: basePath,
+                    document: Document.Versioned.make({
+                        versionDocuments,
+                    }),
+                });
+            }
+            else if (unknownVersions.length > 0) {
+                // All versions were unknown, skip this example entirely
+                continue;
+            }
+            else {
+                // No versions at all - shouldn't happen
+                continue;
+            }
+        }
+        if (example) {
+            examples.push(example);
+            // Generate diagnostics for this example
+            diagnostics.push(...lintFileLayout(example, options.schemaCatalog));
+        }
+    }
+    // Perform validation if catalog is provided
+    if (options.schemaCatalog) {
+        diagnostics.push(...validateExamples(examples, options.schemaCatalog));
+    }
+    // @claude create a utility for reading a file at variable paths
+    // Check for index.md or index.mdx file
+    const indexMdPath = Path.join(options.dir, 'index.md');
+    const indexMdxPath = Path.join(options.dir, '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({
+        examples,
+        index: indexPath ? { path: indexPath } : undefined,
+    });
+    return { catalog, diagnostics };
+});
+//# sourceMappingURL=scanner.js.map

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

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

package/build/api/examples/schemas/catalog.d.ts

@@ -0,0 +1,248 @@
+import { S } from '#lib/kit-temp/effect';
+export declare const Catalog: S.Struct<{
+    /**
+     * Array of GraphQL examples in the catalog.
+     */
+    examples: S.Array$<S.Struct<{
+        name: typeof S.String;
+        path: typeof S.String;
+        document: S.Union<[S.TaggedStruct<"DocumentUnversioned", {
+            document: typeof S.String;
+        }>, S.TaggedStruct<"DocumentVersioned", {
+            versionDocuments: S.HashMap<S.Union<[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>>]>, typeof S.String>;
+        }>]>;
+    }>>;
+    /**
+     * Optional index file metadata.
+     */
+    index: S.optional<S.Struct<{
+        path: typeof S.String;
+    }>>;
+    /**
+     * Index mapping GraphQL types to examples that use them.
+     * Structure: VersionKey → TypeName → Example[]
+     */
+    typeUsageIndex: S.optional<S.transform<S.Array$<S.Tuple2<S.Union<[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.TaggedStruct<"UnversionedKey", {}>]>, S.HashMap<typeof S.String, S.HashSet<typeof import("./type-usage-index.js").ExampleReference>>>>, S.HashMapFromSelf<S.SchemaClass<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | {
+        readonly _tag: "UnversionedKey";
+    }, import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | {
+        readonly _tag: "UnversionedKey";
+    }, never>, S.SchemaClass<import("effect/HashMap").HashMap<string, import("effect/HashSet").HashSet<import("./type-usage-index.js").ExampleReference>>, import("effect/HashMap").HashMap<string, import("effect/HashSet").HashSet<import("./type-usage-index.js").ExampleReference>>, never>>>>;
+}>;
+export type Catalog = S.Schema.Type<typeof Catalog>;
+export declare const make: (props: {
+    readonly examples: readonly {
+        readonly path: string;
+        readonly name: string;
+        readonly document: {
+            readonly _tag: "DocumentUnversioned";
+            readonly document: string;
+        } | {
+            readonly _tag: "DocumentVersioned";
+            readonly versionDocuments: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | import("effect/HashSet").HashSet<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver>, string>;
+        };
+    }[];
+    readonly index?: {
+        readonly path: string;
+    } | undefined;
+    readonly typeUsageIndex?: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | {
+        readonly _tag: "UnversionedKey";
+    }, import("effect/HashMap").HashMap<string, import("effect/HashSet").HashSet<import("./type-usage-index.js").ExampleReference>>> | undefined;
+}, options?: S.MakeOptions) => {
+    readonly examples: readonly {
+        readonly path: string;
+        readonly name: string;
+        readonly document: {
+            readonly _tag: "DocumentUnversioned";
+            readonly document: string;
+        } | {
+            readonly _tag: "DocumentVersioned";
+            readonly versionDocuments: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | import("effect/HashSet").HashSet<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver>, string>;
+        };
+    }[];
+    readonly index?: {
+        readonly path: string;
+    } | undefined;
+    readonly typeUsageIndex?: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | {
+        readonly _tag: "UnversionedKey";
+    }, import("effect/HashMap").HashMap<string, import("effect/HashSet").HashSet<import("./type-usage-index.js").ExampleReference>>> | undefined;
+};
+export declare const is: (u: unknown, overrideOptions?: import("effect/SchemaAST").ParseOptions | number) => u is {
+    readonly examples: readonly {
+        readonly path: string;
+        readonly name: string;
+        readonly document: {
+            readonly _tag: "DocumentUnversioned";
+            readonly document: string;
+        } | {
+            readonly _tag: "DocumentVersioned";
+            readonly versionDocuments: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | import("effect/HashSet").HashSet<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver>, string>;
+        };
+    }[];
+    readonly index?: {
+        readonly path: string;
+    } | undefined;
+    readonly typeUsageIndex?: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | {
+        readonly _tag: "UnversionedKey";
+    }, import("effect/HashMap").HashMap<string, import("effect/HashSet").HashSet<import("./type-usage-index.js").ExampleReference>>> | undefined;
+};
+export declare const decode: (i: {
+    readonly examples: readonly {
+        readonly path: string;
+        readonly name: string;
+        readonly document: {
+            readonly _tag: "DocumentUnversioned";
+            readonly document: string;
+        } | {
+            readonly _tag: "DocumentVersioned";
+            readonly versionDocuments: readonly (readonly [string | number | readonly (string | number)[], string])[];
+        };
+    }[];
+    readonly index?: {
+        readonly path: string;
+    } | undefined;
+    readonly typeUsageIndex?: readonly (readonly [string | number | {
+        readonly _tag: "UnversionedKey";
+    }, readonly (readonly [string, readonly {
+        readonly name: string;
+        readonly version: string | number;
+    }[]])[]])[] | undefined;
+}, overrideOptions?: import("effect/SchemaAST").ParseOptions) => import("effect/Effect").Effect<{
+    readonly examples: readonly {
+        readonly path: string;
+        readonly name: string;
+        readonly document: {
+            readonly _tag: "DocumentUnversioned";
+            readonly document: string;
+        } | {
+            readonly _tag: "DocumentVersioned";
+            readonly versionDocuments: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | import("effect/HashSet").HashSet<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver>, string>;
+        };
+    }[];
+    readonly index?: {
+        readonly path: string;
+    } | undefined;
+    readonly typeUsageIndex?: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | {
+        readonly _tag: "UnversionedKey";
+    }, import("effect/HashMap").HashMap<string, import("effect/HashSet").HashSet<import("./type-usage-index.js").ExampleReference>>> | undefined;
+}, import("effect/ParseResult").ParseError, never>;
+export declare const decodeSync: (i: {
+    readonly examples: readonly {
+        readonly path: string;
+        readonly name: string;
+        readonly document: {
+            readonly _tag: "DocumentUnversioned";
+            readonly document: string;
+        } | {
+            readonly _tag: "DocumentVersioned";
+            readonly versionDocuments: readonly (readonly [string | number | readonly (string | number)[], string])[];
+        };
+    }[];
+    readonly index?: {
+        readonly path: string;
+    } | undefined;
+    readonly typeUsageIndex?: readonly (readonly [string | number | {
+        readonly _tag: "UnversionedKey";
+    }, readonly (readonly [string, readonly {
+        readonly name: string;
+        readonly version: string | number;
+    }[]])[]])[] | undefined;
+}, overrideOptions?: import("effect/SchemaAST").ParseOptions) => {
+    readonly examples: readonly {
+        readonly path: string;
+        readonly name: string;
+        readonly document: {
+            readonly _tag: "DocumentUnversioned";
+            readonly document: string;
+        } | {
+            readonly _tag: "DocumentVersioned";
+            readonly versionDocuments: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | import("effect/HashSet").HashSet<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver>, string>;
+        };
+    }[];
+    readonly index?: {
+        readonly path: string;
+    } | undefined;
+    readonly typeUsageIndex?: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | {
+        readonly _tag: "UnversionedKey";
+    }, import("effect/HashMap").HashMap<string, import("effect/HashSet").HashSet<import("./type-usage-index.js").ExampleReference>>> | undefined;
+};
+export declare const encode: (a: {
+    readonly examples: readonly {
+        readonly path: string;
+        readonly name: string;
+        readonly document: {
+            readonly _tag: "DocumentUnversioned";
+            readonly document: string;
+        } | {
+            readonly _tag: "DocumentVersioned";
+            readonly versionDocuments: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | import("effect/HashSet").HashSet<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver>, string>;
+        };
+    }[];
+    readonly index?: {
+        readonly path: string;
+    } | undefined;
+    readonly typeUsageIndex?: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | {
+        readonly _tag: "UnversionedKey";
+    }, import("effect/HashMap").HashMap<string, import("effect/HashSet").HashSet<import("./type-usage-index.js").ExampleReference>>> | undefined;
+}, overrideOptions?: import("effect/SchemaAST").ParseOptions) => import("effect/Effect").Effect<{
+    readonly examples: readonly {
+        readonly path: string;
+        readonly name: string;
+        readonly document: {
+            readonly _tag: "DocumentUnversioned";
+            readonly document: string;
+        } | {
+            readonly _tag: "DocumentVersioned";
+            readonly versionDocuments: readonly (readonly [string | number | readonly (string | number)[], string])[];
+        };
+    }[];
+    readonly index?: {
+        readonly path: string;
+    } | undefined;
+    readonly typeUsageIndex?: readonly (readonly [string | number | {
+        readonly _tag: "UnversionedKey";
+    }, readonly (readonly [string, readonly {
+        readonly name: string;
+        readonly version: string | number;
+    }[]])[]])[] | undefined;
+}, import("effect/ParseResult").ParseError, never>;
+export declare const encodeSync: (a: {
+    readonly examples: readonly {
+        readonly path: string;
+        readonly name: string;
+        readonly document: {
+            readonly _tag: "DocumentUnversioned";
+            readonly document: string;
+        } | {
+            readonly _tag: "DocumentVersioned";
+            readonly versionDocuments: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | import("effect/HashSet").HashSet<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver>, string>;
+        };
+    }[];
+    readonly index?: {
+        readonly path: string;
+    } | undefined;
+    readonly typeUsageIndex?: import("effect/HashMap").HashMap<import("../../../lib/version/custom.js").Custom | import("../../../lib/version/date.js").Date | import("../../../lib/version/integer.js").Integer | import("../../../lib/version/semver.js").Semver | {
+        readonly _tag: "UnversionedKey";
+    }, import("effect/HashMap").HashMap<string, import("effect/HashSet").HashSet<import("./type-usage-index.js").ExampleReference>>> | undefined;
+}, overrideOptions?: import("effect/SchemaAST").ParseOptions) => {
+    readonly examples: readonly {
+        readonly path: string;
+        readonly name: string;
+        readonly document: {
+            readonly _tag: "DocumentUnversioned";
+            readonly document: string;
+        } | {
+            readonly _tag: "DocumentVersioned";
+            readonly versionDocuments: readonly (readonly [string | number | readonly (string | number)[], string])[];
+        };
+    }[];
+    readonly index?: {
+        readonly path: string;
+    } | undefined;
+    readonly typeUsageIndex?: readonly (readonly [string | number | {
+        readonly _tag: "UnversionedKey";
+    }, readonly (readonly [string, readonly {
+        readonly name: string;
+        readonly version: string | number;
+    }[]])[]])[] | undefined;
+};
+//# sourceMappingURL=catalog.d.ts.map

package/build/api/examples/schemas/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/api/examples/schemas/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAQxC,eAAO,MAAM,OAAO;IAClB;;OAEG;;;;;;;;;;IAEH;;OAEG;;;;IAIH;;;OAGG;;;;;;EAKH,CAAA;AAEF,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,CAAA;AAMnD,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAe,CAAA;AAMhC,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;CAAgB,CAAA;AAM/B,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kDAAoB,CAAA;AACvC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAwB,CAAA;AAC/C,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kDAAoB,CAAA;AACvC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAwB,CAAA"}

package/build/api/examples/schemas/catalog.js

@@ -0,0 +1,42 @@
+import { S } from '#lib/kit-temp/effect';
+import { Example } from './example/$.js';
+import { TypeUsageIndex } from './type-usage-index.js';
+// ============================================================================
+// Schema and Type
+// ============================================================================
+export const Catalog = S.Struct({
+    /**
+     * Array of GraphQL examples in the catalog.
+     */
+    examples: S.Array(Example.Example),
+    /**
+     * Optional index file metadata.
+     */
+    index: S.optional(S.Struct({
+        path: S.String,
+    })),
+    /**
+     * Index mapping GraphQL types to examples that use them.
+     * Structure: VersionKey → TypeName → Example[]
+     */
+    typeUsageIndex: S.optional(TypeUsageIndex),
+}).annotations({
+    identifier: 'ExamplesCatalog',
+    description: 'A catalog of GraphQL examples with optional index file and type usage index',
+});
+// ============================================================================
+// Constructors
+// ============================================================================
+export const make = Catalog.make;
+// ============================================================================
+// Type Guards
+// ============================================================================
+export const is = S.is(Catalog);
+// ============================================================================
+// Codec
+// ============================================================================
+export const decode = S.decode(Catalog);
+export const decodeSync = S.decodeSync(Catalog);
+export const encode = S.encode(Catalog);
+export const encodeSync = S.encodeSync(Catalog);
+//# sourceMappingURL=catalog.js.map

package/build/api/examples/schemas/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../../src/api/examples/schemas/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B;;OAEG;IACH,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;IAClC;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QACzB,IAAI,EAAE,CAAC,CAAC,MAAM;KACf,CAAC,CAAC;IACH;;;OAGG;IACH,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;CAC3C,CAAC,CAAC,WAAW,CAAC;IACb,UAAU,EAAE,iBAAiB;IAC7B,WAAW,EAAE,6EAA6E;CAC3F,CAAC,CAAA;AAIF,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;AAEhC,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAA;AAE/B,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AACvC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;AAC/C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AACvC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA"}

package/build/api/examples/schemas/example/$$.d.ts

@@ -0,0 +1,2 @@
+export * from './example.js';
+//# sourceMappingURL=$$.d.ts.map

package/build/api/examples/schemas/example/$$.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../../../src/api/examples/schemas/example/$$.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA"}

package/build/api/examples/schemas/example/$$.js

@@ -0,0 +1,2 @@
+export * from './example.js';
+//# sourceMappingURL=$$.js.map

package/build/api/examples/schemas/example/$$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.js","sourceRoot":"","sources":["../../../../../src/api/examples/schemas/example/$$.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA"}

package/build/api/examples/schemas/example/$.d.ts

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

package/build/api/examples/schemas/example/$.d.ts.map

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

package/build/api/examples/schemas/example/$.js

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

package/build/api/examples/schemas/example/$.js.map

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