polen 0.11.0-next.15 → 0.11.0-next.16

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

@@ -0,0 +1,134 @@
+import { S } from '#lib/kit-temp/effect';
+import { Order } from 'effect';
+/**
+ * An Example represents a GraphQL query/mutation example with metadata.
+ * The versioning complexity is handled by the Document type.
+ */
+export declare const Example: S.Struct<{
+    /**
+     * The name/identifier of the example (e.g., "get-pokemon", "list-users")
+     */
+    name: typeof S.String;
+    /**
+     * The file system path where this example was found.
+     * Used for diagnostic reporting and error messages.
+     */
+    path: typeof S.String;
+    /**
+     * The document content, which can be unversioned, versioned, or partially versioned.
+     */
+    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>;
+    }>]>;
+}>;
+export type Example = S.Schema.Type<typeof Example>;
+export declare const make: (props: {
+    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>;
+    };
+}, options?: S.MakeOptions) => {
+    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>;
+    };
+};
+export declare const order: Order.Order<Example>;
+export declare const equivalent: import("effect/Equivalence").Equivalence<{
+    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>;
+    };
+}>;
+export declare const is: (u: unknown, overrideOptions?: import("effect/SchemaAST").ParseOptions | number) => u is {
+    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>;
+    };
+};
+export declare const decode: (i: {
+    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])[];
+    };
+}, overrideOptions?: import("effect/SchemaAST").ParseOptions) => import("effect/Effect").Effect<{
+    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>;
+    };
+}, import("effect/ParseResult").ParseError, never>;
+export declare const decodeSync: (i: {
+    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])[];
+    };
+}, overrideOptions?: import("effect/SchemaAST").ParseOptions) => {
+    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>;
+    };
+};
+export declare const encode: (a: {
+    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>;
+    };
+}, overrideOptions?: import("effect/SchemaAST").ParseOptions) => import("effect/Effect").Effect<{
+    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])[];
+    };
+}, import("effect/ParseResult").ParseError, never>;
+//# sourceMappingURL=example.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../../../../src/api/examples/schemas/example/example.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAM9B;;;GAGG;AACH,eAAO,MAAM,OAAO;IAClB;;OAEG;;IAGH;;;OAGG;;IAGH;;OAEG;;;;;;EAKH,CAAA;AAMF,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,CAAA;AAMnD,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;CAAe,CAAA;AAMhC,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAGtC,CAAA;AAMD,eAAO,MAAM,UAAU;;;;;;;;;;EAAyB,CAAA;AAMhD,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"}

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

@@ -0,0 +1,51 @@
+import { Document } from '#lib/document/$';
+import { S } from '#lib/kit-temp/effect';
+import { Order } from 'effect';
+// ============================================================================
+// Schema
+// ============================================================================
+/**
+ * An Example represents a GraphQL query/mutation example with metadata.
+ * The versioning complexity is handled by the Document type.
+ */
+export const Example = S.Struct({
+    /**
+     * The name/identifier of the example (e.g., "get-pokemon", "list-users")
+     */
+    name: S.String,
+    /**
+     * The file system path where this example was found.
+     * Used for diagnostic reporting and error messages.
+     */
+    path: S.String,
+    /**
+     * The document content, which can be unversioned, versioned, or partially versioned.
+     */
+    document: Document.Document,
+}).annotations({
+    identifier: 'Example',
+    description: 'A GraphQL example that contains a document with optional versioning support',
+});
+// ============================================================================
+// Constructors
+// ============================================================================
+export const make = Example.make;
+// ============================================================================
+// Ordering
+// ============================================================================
+export const order = Order.mapInput(Order.string, (example) => example.name);
+// ============================================================================
+// Equivalence
+// ============================================================================
+export const equivalent = S.equivalence(Example);
+// ============================================================================
+// Type Guards
+// ============================================================================
+export const is = S.is(Example);
+// ============================================================================
+// Codec
+// ============================================================================
+export const decode = S.decode(Example);
+export const decodeSync = S.decodeSync(Example);
+export const encode = S.encode(Example);
+//# sourceMappingURL=example.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../../../../../src/api/examples/schemas/example/example.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAE9B,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM;IAEd;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM;IAEd;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC,QAAQ;CAC5B,CAAC,CAAC,WAAW,CAAC;IACb,UAAU,EAAE,SAAS;IACrB,WAAW,EAAE,6EAA6E;CAC3F,CAAC,CAAA;AAQF,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;AAEhC,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,KAAK,GAAyB,KAAK,CAAC,QAAQ,CACvD,KAAK,CAAC,MAAM,EACZ,CAAC,OAAgB,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CACnC,CAAA;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;AAEhD,+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"}

package/build/api/examples/schemas/type-usage-index.d.ts

@@ -0,0 +1,72 @@
+import { S } from '#lib/kit-temp/effect';
+import { Version } from '#lib/version/$';
+/**
+ * Sentinel type for unversioned schemas in the type usage index.
+ */
+export declare const UnversionedKey: S.TaggedStruct<"UnversionedKey", {}>;
+export type UnversionedKey = S.Schema.Type<typeof UnversionedKey>;
+/**
+ * Singleton instance for unversioned key.
+ */
+export declare const UNVERSIONED_KEY: {
+    readonly _tag: "UnversionedKey";
+};
+/**
+ * Union type for version keys in the index.
+ */
+export declare const VersionKey: S.Union<[S.transformOrFail<S.Union<[typeof S.String, typeof S.Number]>, S.Union<[typeof Version.IntegerVersion.Integer, typeof Version.SemverVersion.Semver, typeof Version.DateVersion.Date, typeof Version.CustomVersion.Custom]>, never>, S.TaggedStruct<"UnversionedKey", {}>]>;
+export type VersionKey = S.Schema.Type<typeof VersionKey>;
+declare const ExampleReference_base: S.Class<ExampleReference, {
+    /**
+     * The unique name of the example
+     */
+    name: typeof S.String;
+    /**
+     * The version this reference is for.
+     * Always included for consistent URL generation.
+     */
+    version: S.transformOrFail<S.Union<[typeof S.String, typeof S.Number]>, S.Union<[typeof Version.IntegerVersion.Integer, typeof Version.SemverVersion.Semver, typeof Version.DateVersion.Date, typeof Version.CustomVersion.Custom]>, never>;
+}, S.Struct.Encoded<{
+    /**
+     * The unique name of the example
+     */
+    name: typeof S.String;
+    /**
+     * The version this reference is for.
+     * Always included for consistent URL generation.
+     */
+    version: S.transformOrFail<S.Union<[typeof S.String, typeof S.Number]>, S.Union<[typeof Version.IntegerVersion.Integer, typeof Version.SemverVersion.Semver, typeof Version.DateVersion.Date, typeof Version.CustomVersion.Custom]>, never>;
+}>, never, {
+    readonly name: string;
+} & {
+    readonly version: Version.CustomVersion.Custom | Version.DateVersion.Date | Version.IntegerVersion.Integer | Version.SemverVersion.Semver;
+}, {}, {}>;
+/**
+ * Lightweight reference to an example with version.
+ * Uses Class for proper Equal and Hash support needed by HashSet,
+ * and provides a convenient make constructor.
+ */
+export declare class ExampleReference extends ExampleReference_base {
+}
+/**
+ * Schema for type usage index with proper HashMap transformation.
+ * Structure: VersionKey → TypeName → HashSet<ExampleReference>
+ *
+ * S.HashMap automatically handles transformation between:
+ * - Runtime: HashMap<K, V>
+ * - Encoded: Array<[K, V]> for JSON serialization
+ *
+ * S.HashSet automatically handles:
+ * - Runtime: HashSet<ExampleReference>
+ * - Encoded: Array<ExampleReference> for JSON serialization
+ * - Automatic deduplication based on ExampleReference's structural equality
+ */
+export declare const TypeUsageIndex: S.transform<S.Array$<S.Tuple2<S.Union<[S.transformOrFail<S.Union<[typeof S.String, typeof S.Number]>, S.Union<[typeof Version.IntegerVersion.Integer, typeof Version.SemverVersion.Semver, typeof Version.DateVersion.Date, typeof Version.CustomVersion.Custom]>, never>, S.TaggedStruct<"UnversionedKey", {}>]>, S.HashMap<typeof S.String, S.HashSet<typeof ExampleReference>>>>, S.HashMapFromSelf<S.SchemaClass<Version.CustomVersion.Custom | Version.DateVersion.Date | Version.IntegerVersion.Integer | Version.SemverVersion.Semver | {
+    readonly _tag: "UnversionedKey";
+}, Version.CustomVersion.Custom | Version.DateVersion.Date | Version.IntegerVersion.Integer | Version.SemverVersion.Semver | {
+    readonly _tag: "UnversionedKey";
+}, never>, S.SchemaClass<import("effect/HashMap").HashMap<string, import("effect/HashSet").HashSet<ExampleReference>>, import("effect/HashMap").HashMap<string, import("effect/HashSet").HashSet<ExampleReference>>, never>>>;
+export type TypeUsageIndex = S.Schema.Type<typeof TypeUsageIndex>;
+export type TypeUsageIndexEncoded = S.Schema.Encoded<typeof TypeUsageIndex>;
+export {};
+//# sourceMappingURL=type-usage-index.d.ts.map

package/build/api/examples/schemas/type-usage-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-usage-index.d.ts","sourceRoot":"","sources":["../../../../src/api/examples/schemas/type-usage-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAMxC;;GAEG;AACH,eAAO,MAAM,cAAc,sCAAuC,CAAA;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,cAAc,CAAC,CAAA;AAEjE;;GAEG;AACH,eAAO,MAAM,eAAe;;CAA0B,CAAA;AAEtD;;GAEG;AACH,eAAO,MAAM,UAAU,qRAA2C,CAAA;AAClE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,CAAA;;IAYvD;;OAEG;;IAEH;;;OAGG;;;IAPH;;OAEG;;IAEH;;;OAGG;;;;;;;AAbL;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,qBAUpC;CAAG;AAML;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc;;;;6NASzB,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,cAAc,CAAC,CAAA;AACjE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,cAAc,CAAC,CAAA"}

package/build/api/examples/schemas/type-usage-index.js

@@ -0,0 +1,64 @@
+import { S } from '#lib/kit-temp/effect';
+import { Version } from '#lib/version/$';
+// ============================================================================
+// Runtime Types
+// ============================================================================
+/**
+ * Sentinel type for unversioned schemas in the type usage index.
+ */
+export const UnversionedKey = S.TaggedStruct('UnversionedKey', {});
+/**
+ * Singleton instance for unversioned key.
+ */
+export const UNVERSIONED_KEY = UnversionedKey.make({});
+/**
+ * Union type for version keys in the index.
+ */
+export const VersionKey = S.Union(Version.Version, UnversionedKey);
+// ============================================================================
+// Example Reference
+// ============================================================================
+/**
+ * Lightweight reference to an example with version.
+ * Uses Class for proper Equal and Hash support needed by HashSet,
+ * and provides a convenient make constructor.
+ */
+export class ExampleReference extends S.Class('ExampleReference')({
+    /**
+     * The unique name of the example
+     */
+    name: S.String,
+    /**
+     * The version this reference is for.
+     * Always included for consistent URL generation.
+     */
+    version: Version.Version,
+}) {
+}
+// ============================================================================
+// Schema
+// ============================================================================
+/**
+ * Schema for type usage index with proper HashMap transformation.
+ * Structure: VersionKey → TypeName → HashSet<ExampleReference>
+ *
+ * S.HashMap automatically handles transformation between:
+ * - Runtime: HashMap<K, V>
+ * - Encoded: Array<[K, V]> for JSON serialization
+ *
+ * S.HashSet automatically handles:
+ * - Runtime: HashSet<ExampleReference>
+ * - Encoded: Array<ExampleReference> for JSON serialization
+ * - Automatic deduplication based on ExampleReference's structural equality
+ */
+export const TypeUsageIndex = S.HashMap({
+    key: VersionKey,
+    value: S.HashMap({
+        key: S.String,
+        value: S.HashSet(ExampleReference),
+    }),
+}).annotations({
+    identifier: 'TypeUsageIndex',
+    description: 'Index mapping versions to types to example references that use those types',
+});
+//# sourceMappingURL=type-usage-index.js.map

package/build/api/examples/schemas/type-usage-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-usage-index.js","sourceRoot":"","sources":["../../../../src/api/examples/schemas/type-usage-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAExC,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,YAAY,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAA;AAGlE;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAA;AAGlE,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,CAAC,CAAC,KAAK,CAAmB,kBAAkB,CAAC,CAAC;IAClF;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM;IACd;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC,OAAO;CACzB,CAAC;CAAG;AAEL,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,OAAO,CAAC;IACtC,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;QACf,GAAG,EAAE,CAAC,CAAC,MAAM;QACb,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;KACnC,CAAC;CACH,CAAC,CAAC,WAAW,CAAC;IACb,UAAU,EAAE,gBAAgB;IAC5B,WAAW,EAAE,4EAA4E;CAC1F,CAAC,CAAA"}

package/build/api/examples/type-generator.d.ts

@@ -0,0 +1,8 @@
+import { FileSystem } from '@effect/platform';
+import { Effect } from 'effect';
+import type { Catalog } from './schemas/catalog.js';
+/**
+ * Generate TypeScript type definitions for discovered examples.
+ */
+export declare const generateExampleTypes: (catalog: Catalog, projectRoot: string) => Effect.Effect<void, Error, FileSystem.FileSystem>;
+//# sourceMappingURL=type-generator.d.ts.map

package/build/api/examples/type-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-generator.d.ts","sourceRoot":"","sources":["../../../src/api/examples/type-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,SAAS,OAAO,EAChB,aAAa,MAAM,KAClB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CAUlD,CAAA"}

package/build/api/examples/type-generator.js

@@ -0,0 +1,36 @@
+import { Typings } from '#api/typings/$';
+import { FileSystem } from '@effect/platform';
+import { Effect } from 'effect';
+/**
+ * Generate TypeScript type definitions for discovered examples.
+ */
+export const generateExampleTypes = (catalog, projectRoot) => {
+    const exampleNames = catalog.examples.map(e => e.name);
+    const typeDefinition = generateTypeDefinition(exampleNames);
+    return Typings.write({
+        name: 'config.examples',
+        content: typeDefinition,
+    }, { projectRoot });
+};
+/**
+ * Generate the TypeScript type definition content.
+ */
+function generateTypeDefinition(exampleNames) {
+    const quotedNames = exampleNames.map(name => `'${name}'`);
+    const namesArray = quotedNames.length > 0
+        ? `readonly [${quotedNames.join(', ')}]`
+        : 'readonly []';
+    const interfaceContent = `/**
+ * Augment the global Examples interface with discovered example names.
+ * This extends the base interface defined in #api/examples/config.
+ */
+interface Examples {
+  /**
+   * Type-safe list of discovered example names from the /examples directory.
+   * This property is generated and provides autocomplete for example selection.
+   */
+  readonly names: ${namesArray}
+}`;
+    return Typings.createGlobalAugmentation(interfaceContent, 'Example type definitions');
+}
+//# sourceMappingURL=type-generator.js.map

package/build/api/examples/type-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-generator.js","sourceRoot":"","sources":["../../../src/api/examples/type-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG/B;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAAgB,EAChB,WAAmB,EACgC,EAAE;IACrD,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IACtD,MAAM,cAAc,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAA;IAC3D,OAAO,OAAO,CAAC,KAAK,CAClB;QACE,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,cAAc;KACxB,EACD,EAAE,WAAW,EAAE,CAChB,CAAA;AACH,CAAC,CAAA;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,YAAsB;IACpD,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,CAAC,CAAA;IACzD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC;QACvC,CAAC,CAAC,aAAa,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACxC,CAAC,CAAC,aAAa,CAAA;IAEjB,MAAM,gBAAgB,GAAG;;;;;;;;;oBASP,UAAU;EAC5B,CAAA;IAEA,OAAO,OAAO,CAAC,wBAAwB,CACrC,gBAAgB,EAChB,0BAA0B,CAC3B,CAAA;AACH,CAAC"}

package/build/api/examples/type-usage-indexer.d.ts

@@ -0,0 +1,18 @@
+import { Catalog } from '#lib/catalog/$';
+import { Version } from '#lib/version/$';
+import { HashSet } from 'effect';
+import { Schema as S } from 'effect';
+import type { Example } from './schemas/example/example.js';
+import { ExampleReference, type TypeUsageIndex } from './schemas/type-usage-index.js';
+/**
+ * Create a type usage index from examples and schemas.
+ *
+ * Processes all examples and their documents (versioned or unversioned)
+ * to build an index of which types are used in which examples.
+ */
+export declare const createTypeUsageIndex: (examples: readonly Example[], schemasCatalog: Catalog.Catalog) => TypeUsageIndex;
+/**
+ * Get example references that use a specific type in a specific version.
+ */
+export declare const getExampleReferencesForType: (typeUsageIndex: TypeUsageIndex, typeName: string, version?: Version.Version | null) => HashSet.HashSet<S.Schema.Type<typeof ExampleReference>>;
+//# sourceMappingURL=type-usage-indexer.d.ts.map

package/build/api/examples/type-usage-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-usage-indexer.d.ts","sourceRoot":"","sources":["../../../src/api/examples/type-usage-indexer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAGxC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AACxC,OAAO,EAAW,OAAO,EAAU,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAA;AAYpC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAoC,MAAM,+BAA+B,CAAA;AA8KvH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,SAAS,OAAO,EAAE,EAC5B,gBAAgB,OAAO,CAAC,OAAO,KAC9B,cAoCF,CAAA;AA0CD;;GAEG;AACH,eAAO,MAAM,2BAA2B,GACtC,gBAAgB,cAAc,EAC9B,UAAU,MAAM,EAChB,UAAS,OAAO,CAAC,OAAO,GAAG,IAAW,KACrC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAOxD,CAAA"}

package/build/api/examples/type-usage-indexer.js

@@ -0,0 +1,220 @@
+import { Catalog } from '#lib/catalog/$';
+import { Document } from '#lib/document/$';
+import { Schema } from '#lib/schema/$';
+import { Version } from '#lib/version/$';
+import { HashMap, HashSet, Option } from 'effect';
+import { Schema as S } from 'effect';
+import { getNamedType, isInterfaceType, isObjectType, isUnionType, Kind, parse, visit, } from 'graphql';
+import { ExampleReference, UNVERSIONED_KEY } from './schemas/type-usage-index.js';
+// ============================================================================
+// Type Extraction
+// ============================================================================
+/**
+ * Extract all named types referenced in a GraphQL document.
+ *
+ * This includes:
+ * - Types referenced in fields
+ * - Types referenced in fragments (inline and spreads)
+ * - For interfaces: both the interface and all implementations
+ * - For unions: both the union and all member types
+ */
+const extractTypesFromQuery = (documentString, schema) => {
+    const types = new Set();
+    const visitedTypes = new Set(); // Prevent infinite recursion
+    let ast;
+    try {
+        ast = parse(documentString);
+    }
+    catch {
+        // If parsing fails, return empty set
+        return types;
+    }
+    // Helper to add a type and its related types
+    const addType = (typeName) => {
+        if (visitedTypes.has(typeName))
+            return;
+        visitedTypes.add(typeName);
+        types.add(typeName);
+        const type = schema.getType(typeName);
+        if (!type)
+            return;
+        // If interface, add all implementations
+        if (isInterfaceType(type)) {
+            const implementations = schema.getImplementations(type);
+            for (const impl of implementations.objects) {
+                types.add(impl.name);
+            }
+            for (const impl of implementations.interfaces) {
+                types.add(impl.name);
+            }
+        } // If union, add all member types
+        else if (isUnionType(type)) {
+            for (const member of type.getTypes()) {
+                types.add(member.name);
+            }
+        }
+    };
+    // Helper to resolve field type from selection
+    const resolveFieldType = (fieldName, parentTypeName) => {
+        if (!parentTypeName)
+            return null;
+        const parentType = schema.getType(parentTypeName);
+        if (!parentType || !isObjectType(parentType) && !isInterfaceType(parentType)) {
+            return null;
+        }
+        const field = parentType.getFields()[fieldName];
+        if (!field)
+            return null;
+        const namedType = getNamedType(field.type);
+        return namedType.name;
+    };
+    // Track the current type context as we traverse
+    let currentType = null;
+    visit(ast, {
+        [Kind.OPERATION_DEFINITION]: (node) => {
+            // Set initial type based on operation
+            switch (node.operation) {
+                case 'query':
+                    currentType = schema.getQueryType()?.name ?? null;
+                    break;
+                case 'mutation':
+                    currentType = schema.getMutationType()?.name ?? null;
+                    break;
+                case 'subscription':
+                    currentType = schema.getSubscriptionType()?.name ?? null;
+                    break;
+            }
+            if (currentType) {
+                addType(currentType);
+            }
+        },
+        [Kind.FIELD]: {
+            enter(node) {
+                if (!currentType)
+                    return;
+                // Special handling for __typename
+                if (node.name.value === '__typename')
+                    return;
+                const fieldType = resolveFieldType(node.name.value, currentType);
+                if (fieldType) {
+                    addType(fieldType);
+                    // Update context for nested selections
+                    if (node.selectionSet) {
+                        currentType = fieldType;
+                    }
+                }
+            },
+            leave(node) {
+                // Restore parent context when leaving field with selection set
+                if (node.selectionSet && currentType) {
+                    // This is simplified - in production would need proper context stack
+                }
+            },
+        },
+        [Kind.INLINE_FRAGMENT]: (node) => {
+            if (node.typeCondition) {
+                const typeName = node.typeCondition.name.value;
+                addType(typeName);
+                currentType = typeName;
+            }
+        },
+        [Kind.FRAGMENT_SPREAD]: (node) => {
+            // Fragment spreads reference fragment definitions which have their own type
+            // In a full implementation, we'd look up the fragment definition
+        },
+        [Kind.FRAGMENT_DEFINITION]: (node) => {
+            const typeName = node.typeCondition.name.value;
+            addType(typeName);
+            currentType = typeName;
+        },
+    });
+    return types;
+};
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Get a schema by version from the catalog.
+ */
+const getSchemaByVersion = (catalog, version) => {
+    if (Catalog.Versioned.is(catalog)) {
+        // Find the schema with matching version
+        return catalog.entries.find(entry => Schema.Versioned.is(entry)
+            && Version.equivalence(entry.version, version));
+    }
+    // For unversioned catalog, return the single schema if version matches
+    if (Catalog.Unversioned.is(catalog)) {
+        // Unversioned catalogs don't have versions, so we can't match
+        return undefined;
+    }
+    return undefined;
+};
+// ============================================================================
+// Index Creation
+// ============================================================================
+/**
+ * Create a type usage index from examples and schemas.
+ *
+ * Processes all examples and their documents (versioned or unversioned)
+ * to build an index of which types are used in which examples.
+ */
+export const createTypeUsageIndex = (examples, schemasCatalog) => {
+    let index = HashMap.empty();
+    for (const example of examples) {
+        // Process based on document type
+        if (Document.Unversioned.is(example.document)) {
+            // Unversioned document
+            const schema = Catalog.getLatestSchema(schemasCatalog);
+            const types = extractTypesFromQuery(example.document.document, schema.definition);
+            for (const typeName of types) {
+                // For unversioned, use the latest version from the catalog
+                const latestVersion = Catalog.getLatestVersionIdentifier(schemasCatalog) ?? Version.fromString('1.0.0');
+                index = addExampleToIndex(index, UNVERSIONED_KEY, typeName, example, latestVersion);
+            }
+        }
+        else if (Document.Versioned.is(example.document)) {
+            // Versioned document - process each version covered
+            const allVersions = Document.Versioned.getAllVersions(example.document);
+            for (const version of allVersions) {
+                const schema = getSchemaByVersion(schemasCatalog, version);
+                if (!schema)
+                    continue;
+                const documentString = Document.Versioned.getContentForVersion(example.document, version);
+                if (!documentString)
+                    continue;
+                const types = extractTypesFromQuery(documentString, schema.definition);
+                for (const typeName of types) {
+                    index = addExampleToIndex(index, version, typeName, example, version);
+                }
+            }
+        }
+    }
+    return index;
+};
+/**
+ * Helper to add an example to the index for a specific version and type.
+ */
+const addExampleToIndex = (index, versionKey, typeName, example, version) => {
+    // Create lightweight reference using the schema's make constructor
+    const exampleRef = ExampleReference.make({ name: example.name, version });
+    // Get or create the version's type map
+    const versionMap = HashMap.get(index, versionKey).pipe(Option.getOrElse((HashMap.empty)));
+    // Get or create the type's example set
+    const examples = HashMap.get(versionMap, typeName).pipe(Option.getOrElse((HashSet.empty)));
+    // Add example reference to set (HashSet handles deduplication automatically)
+    const updatedExamples = HashSet.add(examples, exampleRef);
+    // Update both maps immutably
+    const updatedVersionMap = HashMap.set(versionMap, typeName, updatedExamples);
+    return HashMap.set(index, versionKey, updatedVersionMap);
+};
+// ============================================================================
+// Query Functions
+// ============================================================================
+/**
+ * Get example references that use a specific type in a specific version.
+ */
+export const getExampleReferencesForType = (typeUsageIndex, typeName, version = null) => {
+    const versionKey = version ?? UNVERSIONED_KEY;
+    return HashMap.get(typeUsageIndex, versionKey).pipe(Option.flatMap(versionMap => HashMap.get(versionMap, typeName)), Option.getOrElse((HashSet.empty)));
+};
+//# sourceMappingURL=type-usage-indexer.js.map