polen 0.11.0-next.15 → 0.11.0-next.17

package/build/api/examples/diagnostic/unknown-version.d.ts

@@ -0,0 +1,52 @@
+import { S } from '#lib/kit-temp/effect';
+import { Version } from '#lib/version/$';
+export declare const DiagnosticUnknownVersion: S.Struct<{
+    _tag: S.tag<"Diagnostic">;
+} & Omit<{
+    _tag: S.Literal<["Diagnostic"]>;
+    source: typeof S.String;
+    name: typeof S.String;
+    severity: S.Enums<{
+        readonly error: "error";
+        readonly warning: "warning";
+        readonly info: "info";
+    }>;
+    message: typeof S.String;
+}, "_tag" | "name" | "source" | "severity"> & {
+    name: S.Literal<["unknown-version"]>;
+    source: S.Literal<["examples-scanner"]>;
+    severity: S.Literal<["error"]>;
+} & {
+    example: S.Struct<{
+        name: typeof S.String;
+        path: typeof S.String;
+    }>;
+    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>;
+    availableVersions: S.Array$<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>>;
+}>;
+export declare const makeDiagnosticUnknownVersion: import("#lib/kit-temp/effect").EffectKit.Schema.ConstructorUsingOmitLiteral1Algo<S.Struct<{
+    _tag: S.tag<"Diagnostic">;
+} & Omit<{
+    _tag: S.Literal<["Diagnostic"]>;
+    source: typeof S.String;
+    name: typeof S.String;
+    severity: S.Enums<{
+        readonly error: "error";
+        readonly warning: "warning";
+        readonly info: "info";
+    }>;
+    message: typeof S.String;
+}, "_tag" | "name" | "source" | "severity"> & {
+    name: S.Literal<["unknown-version"]>;
+    source: S.Literal<["examples-scanner"]>;
+    severity: S.Literal<["error"]>;
+} & {
+    example: S.Struct<{
+        name: typeof S.String;
+        path: typeof S.String;
+    }>;
+    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>;
+    availableVersions: S.Array$<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>>;
+}>>;
+export type DiagnosticUnknownVersion = S.Schema.Type<typeof DiagnosticUnknownVersion>;
+//# sourceMappingURL=unknown-version.d.ts.map

package/build/api/examples/diagnostic/unknown-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-version.d.ts","sourceRoot":"","sources":["../../../../src/api/examples/diagnostic/unknown-version.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAExC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;EAenC,CAAA;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;GAAkD,CAAA;AAE3F,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,wBAAwB,CAAC,CAAA"}

package/build/api/examples/diagnostic/unknown-version.js

@@ -0,0 +1,21 @@
+import { Diagnostic } from '#lib/diagnostic/$';
+import { S } from '#lib/kit-temp/effect';
+import { Version } from '#lib/version/$';
+export const DiagnosticUnknownVersion = Diagnostic.create({
+    source: 'examples-scanner',
+    name: 'unknown-version',
+    severity: 'error',
+    context: {
+        example: S.Struct({
+            name: S.String,
+            path: S.String,
+        }),
+        version: Version.Version,
+        availableVersions: S.Array(Version.Version),
+    },
+}).annotations({
+    identifier: 'DiagnosticUnknownVersion',
+    description: 'Example specifies a version that does not exist in the API',
+});
+export const makeDiagnosticUnknownVersion = Diagnostic.createMake(DiagnosticUnknownVersion);
+//# sourceMappingURL=unknown-version.js.map

package/build/api/examples/diagnostic/unknown-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-version.js","sourceRoot":"","sources":["../../../../src/api/examples/diagnostic/unknown-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAExC,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAC,MAAM,CAAC;IACxD,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,OAAO;IACjB,OAAO,EAAE;QACP,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,IAAI,EAAE,CAAC,CAAC,MAAM;YACd,IAAI,EAAE,CAAC,CAAC,MAAM;SACf,CAAC;QACF,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;KAC5C;CACF,CAAC,CAAC,WAAW,CAAC;IACb,UAAU,EAAE,0BAA0B;IACtC,WAAW,EAAE,4DAA4D;CAC1E,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG,UAAU,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAA"}

package/build/api/examples/diagnostic/unused-default.d.ts

@@ -0,0 +1,49 @@
+import { S } from '#lib/kit-temp/effect';
+export declare const DiagnosticUnusedDefault: S.Struct<{
+    _tag: S.tag<"Diagnostic">;
+} & Omit<{
+    _tag: S.Literal<["Diagnostic"]>;
+    source: typeof S.String;
+    name: typeof S.String;
+    severity: S.Enums<{
+        readonly error: "error";
+        readonly warning: "warning";
+        readonly info: "info";
+    }>;
+    message: typeof S.String;
+}, "_tag" | "name" | "source" | "severity"> & {
+    name: S.Literal<["unused-default"]>;
+    source: S.Literal<["examples-scanner"]>;
+    severity: S.Literal<["warning"]>;
+} & {
+    example: S.Struct<{
+        name: typeof S.String;
+        path: typeof S.String;
+    }>;
+    versions: S.Array$<typeof S.String>;
+}>;
+export declare const makeDiagnosticUnusedDefault: import("#lib/kit-temp/effect").EffectKit.Schema.ConstructorUsingOmitLiteral1Algo<S.Struct<{
+    _tag: S.tag<"Diagnostic">;
+} & Omit<{
+    _tag: S.Literal<["Diagnostic"]>;
+    source: typeof S.String;
+    name: typeof S.String;
+    severity: S.Enums<{
+        readonly error: "error";
+        readonly warning: "warning";
+        readonly info: "info";
+    }>;
+    message: typeof S.String;
+}, "_tag" | "name" | "source" | "severity"> & {
+    name: S.Literal<["unused-default"]>;
+    source: S.Literal<["examples-scanner"]>;
+    severity: S.Literal<["warning"]>;
+} & {
+    example: S.Struct<{
+        name: typeof S.String;
+        path: typeof S.String;
+    }>;
+    versions: S.Array$<typeof S.String>;
+}>>;
+export type DiagnosticUnusedDefault = S.Schema.Type<typeof DiagnosticUnusedDefault>;
+//# sourceMappingURL=unused-default.d.ts.map

package/build/api/examples/diagnostic/unused-default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-default.d.ts","sourceRoot":"","sources":["../../../../src/api/examples/diagnostic/unused-default.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAExC,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;EAclC,CAAA;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;GAAiD,CAAA;AAEzF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,uBAAuB,CAAC,CAAA"}

package/build/api/examples/diagnostic/unused-default.js

@@ -0,0 +1,19 @@
+import { Diagnostic } from '#lib/diagnostic/$';
+import { S } from '#lib/kit-temp/effect';
+export const DiagnosticUnusedDefault = Diagnostic.create({
+    source: 'examples-scanner',
+    name: 'unused-default',
+    severity: 'warning',
+    context: {
+        example: S.Struct({
+            name: S.String,
+            path: S.String,
+        }),
+        versions: S.Array(S.String),
+    },
+}).annotations({
+    identifier: 'DiagnosticUnusedDefault',
+    description: 'Default example file that is never used because explicit versions exist for all schema versions',
+});
+export const makeDiagnosticUnusedDefault = Diagnostic.createMake(DiagnosticUnusedDefault);
+//# sourceMappingURL=unused-default.js.map

package/build/api/examples/diagnostic/unused-default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-default.js","sourceRoot":"","sources":["../../../../src/api/examples/diagnostic/unused-default.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAExC,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC,MAAM,CAAC;IACvD,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,gBAAgB;IACtB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE;QACP,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,IAAI,EAAE,CAAC,CAAC,MAAM;YACd,IAAI,EAAE,CAAC,CAAC,MAAM;SACf,CAAC;QACF,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;KAC5B;CACF,CAAC,CAAC,WAAW,CAAC;IACb,UAAU,EAAE,yBAAyB;IACrC,WAAW,EAAE,iGAAiG;CAC/G,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAA"}

package/build/api/examples/diagnostic/validation-error.d.ts

@@ -0,0 +1,63 @@
+import { S } from '#lib/kit-temp/effect';
+export declare const DiagnosticValidationError: S.Struct<{
+    _tag: S.tag<"Diagnostic">;
+} & Omit<{
+    _tag: S.Literal<["Diagnostic"]>;
+    source: typeof S.String;
+    name: typeof S.String;
+    severity: S.Enums<{
+        readonly error: "error";
+        readonly warning: "warning";
+        readonly info: "info";
+    }>;
+    message: typeof S.String;
+}, "_tag" | "name" | "source" | "severity"> & {
+    name: S.Literal<["invalid-graphql"]>;
+    source: S.Literal<["examples-validation"]>;
+    severity: S.Literal<["error"]>;
+} & {
+    example: S.Struct<{
+        name: typeof S.String;
+        path: typeof S.String;
+    }>;
+    version: typeof S.String;
+    errors: S.Array$<S.Struct<{
+        message: typeof S.String;
+        locations: S.optional<S.Array$<S.Struct<{
+            line: typeof S.Number;
+            column: typeof S.Number;
+        }>>>;
+    }>>;
+}>;
+export declare const makeDiagnosticValidationError: import("#lib/kit-temp/effect").EffectKit.Schema.ConstructorUsingOmitLiteral1Algo<S.Struct<{
+    _tag: S.tag<"Diagnostic">;
+} & Omit<{
+    _tag: S.Literal<["Diagnostic"]>;
+    source: typeof S.String;
+    name: typeof S.String;
+    severity: S.Enums<{
+        readonly error: "error";
+        readonly warning: "warning";
+        readonly info: "info";
+    }>;
+    message: typeof S.String;
+}, "_tag" | "name" | "source" | "severity"> & {
+    name: S.Literal<["invalid-graphql"]>;
+    source: S.Literal<["examples-validation"]>;
+    severity: S.Literal<["error"]>;
+} & {
+    example: S.Struct<{
+        name: typeof S.String;
+        path: typeof S.String;
+    }>;
+    version: typeof S.String;
+    errors: S.Array$<S.Struct<{
+        message: typeof S.String;
+        locations: S.optional<S.Array$<S.Struct<{
+            line: typeof S.Number;
+            column: typeof S.Number;
+        }>>>;
+    }>>;
+}>>;
+export type DiagnosticValidationError = S.Schema.Type<typeof DiagnosticValidationError>;
+//# sourceMappingURL=validation-error.d.ts.map

package/build/api/examples/diagnostic/validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../../../../src/api/examples/diagnostic/validation-error.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAExC,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAepC,CAAA;AAEF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAmD,CAAA;AAE7F,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,yBAAyB,CAAC,CAAA"}

package/build/api/examples/diagnostic/validation-error.js

@@ -0,0 +1,21 @@
+import { Diagnostic } from '#lib/diagnostic/$';
+import { GraphQLError } from '#lib/graphql-error/$';
+import { S } from '#lib/kit-temp/effect';
+export const DiagnosticValidationError = Diagnostic.create({
+    source: 'examples-validation',
+    name: 'invalid-graphql',
+    severity: 'error', // Will be overridden based on config
+    context: {
+        example: S.Struct({
+            name: S.String,
+            path: S.String,
+        }),
+        version: S.String,
+        errors: S.Array(GraphQLError.GraphQLError),
+    },
+}).annotations({
+    identifier: 'DiagnosticValidationError',
+    description: 'GraphQL document validation error against the schema',
+});
+export const makeDiagnosticValidationError = Diagnostic.createMake(DiagnosticValidationError);
+//# sourceMappingURL=validation-error.js.map

package/build/api/examples/diagnostic/validation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.js","sourceRoot":"","sources":["../../../../src/api/examples/diagnostic/validation-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAExC,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC,MAAM,CAAC;IACzD,MAAM,EAAE,qBAAqB;IAC7B,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,OAAO,EAAE,qCAAqC;IACxD,OAAO,EAAE;QACP,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;YAChB,IAAI,EAAE,CAAC,CAAC,MAAM;YACd,IAAI,EAAE,CAAC,CAAC,MAAM;SACf,CAAC;QACF,OAAO,EAAE,CAAC,CAAC,MAAM;QACjB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,CAAC;KAC3C;CACF,CAAC,CAAC,WAAW,CAAC;IACb,UAAU,EAAE,2BAA2B;IACvC,WAAW,EAAE,sDAAsD;CACpE,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAG,UAAU,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAA"}

package/build/api/examples/diagnostic/validator.d.ts

@@ -0,0 +1,13 @@
+import { Catalog as SchemaCatalog } from '#lib/catalog/$';
+import { Example } from '../schemas/example/$.js';
+import type { DiagnosticValidationError } from './diagnostic.js';
+export type ValidationDiagnostic = DiagnosticValidationError;
+/**
+ * Validate examples against a schema catalog.
+ *
+ * @param examples - The examples to validate
+ * @param catalog - The schema catalog containing versioned or unversioned schemas
+ * @returns Array of validation diagnostics
+ */
+export declare const validateExamples: (examples: Example.Example[], catalog: SchemaCatalog.Catalog) => ValidationDiagnostic[];
+//# sourceMappingURL=validator.d.ts.map

package/build/api/examples/diagnostic/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../src/api/examples/diagnostic/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAOzD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACjD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA;AAOhE,MAAM,MAAM,oBAAoB,GAAG,yBAAyB,CAAA;AAM5D;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,OAAO,CAAC,OAAO,EAAE,EAC3B,SAAS,aAAa,CAAC,OAAO,KAC7B,oBAAoB,EAkEtB,CAAA"}

package/build/api/examples/diagnostic/validator.js

@@ -0,0 +1,115 @@
+import { Catalog as SchemaCatalog } from '#lib/catalog/$';
+import { Document } from '#lib/document/$';
+import { Version } from '#lib/version/$';
+import { Match } from 'effect';
+import { HashMap } from 'effect/Schema';
+import { parse, specifiedRules, validate } from 'graphql';
+import { Example } from '../schemas/example/$.js';
+import { makeDiagnosticValidationError } from './diagnostic.js';
+// ============================================================================
+// Validation
+// ============================================================================
+/**
+ * Validate examples against a schema catalog.
+ *
+ * @param examples - The examples to validate
+ * @param catalog - The schema catalog containing versioned or unversioned schemas
+ * @returns Array of validation diagnostics
+ */
+export const validateExamples = (examples, catalog) => {
+    const diagnostics = [];
+    return Match.value(catalog).pipe(Match.tagsExhaustive({
+        CatalogVersioned: (versioned) => {
+            for (const example of examples) {
+                Match.value(example.document).pipe(Match.tagsExhaustive({
+                    DocumentVersioned: (doc) => {
+                        // Validate each version against its corresponding schema
+                        for (const schema of SchemaCatalog.Versioned.getAll(versioned)) {
+                            const content = Document.Versioned.getContentForVersion(doc, schema.version);
+                            if (content) {
+                                const versionStr = Version.encodeSync(schema.version);
+                                validateDocument(example.name, example.path, versionStr, content, schema.definition, diagnostics);
+                            }
+                        }
+                        return undefined;
+                    },
+                    DocumentUnversioned: (doc) => {
+                        const latestEntry = SchemaCatalog.Versioned.getLatestOrThrow(versioned);
+                        validateDocument(example.name, example.path, 'default', doc.document, latestEntry.definition, diagnostics);
+                        return undefined;
+                    },
+                }));
+            }
+            return diagnostics;
+        },
+        CatalogUnversioned: (unversioned) => {
+            // For unversioned catalog, only unversioned documents make sense
+            for (const example of examples) {
+                if (example.document._tag === 'DocumentUnversioned') {
+                    validateDocument(example.name, example.path, 'default', example.document.document, unversioned.schema.definition, diagnostics);
+                }
+                // Versioned/PartiallyVersioned documents with unversioned catalog don't make sense
+                // These should be caught by other diagnostics
+            }
+            return diagnostics;
+        },
+    }));
+};
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Validate a single document and add diagnostics if needed.
+ */
+const validateDocument = (exampleName, examplePath, version, content, schema, diagnostics) => {
+    try {
+        // Parse the GraphQL document
+        const document = parse(content);
+        // Validate against the schema
+        const errors = validate(schema, document, specifiedRules);
+        if (errors.length > 0) {
+            diagnostics.push(makeDiagnosticValidationError({
+                message: formatValidationMessage(exampleName, version, errors),
+                example: { name: exampleName, path: examplePath },
+                version,
+                errors: errors.map(formatGraphQLError),
+            }));
+        }
+    }
+    catch (parseError) {
+        // Parse errors are also validation errors
+        diagnostics.push(makeDiagnosticValidationError({
+            message: `Example "${exampleName}" (${version}) has invalid GraphQL syntax`,
+            example: { name: exampleName, path: examplePath },
+            version,
+            errors: [{ message: String(parseError) }],
+        }));
+    }
+};
+/**
+ * Format a validation message for an example.
+ */
+const formatValidationMessage = (exampleId, version, errors) => {
+    const versionStr = version === 'default' ? '' : ` (${version})`;
+    const errorCount = errors.length;
+    const errorWord = errorCount === 1 ? 'error' : 'errors';
+    // Include the first error message for context
+    const firstError = errors[0];
+    const preview = firstError ? `: ${firstError.message}` : '';
+    return `Example "${exampleId}"${versionStr} has ${errorCount} validation ${errorWord}${preview}`;
+};
+/**
+ * Format a GraphQL error for diagnostic reporting.
+ */
+const formatGraphQLError = (error) => ({
+    message: error.message,
+    ...(error.locations
+        ? {
+            locations: error.locations.map(loc => ({
+                line: loc.line,
+                column: loc.column,
+            })),
+        }
+        : {}),
+});
+//# sourceMappingURL=validator.js.map

package/build/api/examples/diagnostic/validator.js.map

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

package/build/api/examples/filter.d.ts

@@ -0,0 +1,19 @@
+import type { ExampleName, ExampleSelection } from './config.js';
+import { Example } from './schemas/example/$.js';
+/**
+ * Filter examples based on the display configuration.
+ *
+ * @param examples - All available examples
+ * @param selection - The display configuration
+ * @returns Filtered examples based on the selection criteria
+ */
+export declare const filterExamplesBySelection: (examples: Example.Example[], selection: ExampleSelection | undefined) => Example.Example[];
+/**
+ * Check if an example should be displayed based on the selection criteria.
+ *
+ * @param exampleName - The ID of the example to check
+ * @param selection - The display configuration
+ * @returns Whether the example should be displayed
+ */
+export declare const shouldDisplayExample: (exampleName: ExampleName, selection: ExampleSelection | undefined) => boolean;
+//# sourceMappingURL=filter.d.ts.map

package/build/api/examples/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/api/examples/filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,OAAO,CAAC,OAAO,EAAE,EAC3B,WAAW,gBAAgB,GAAG,SAAS,KACtC,OAAO,CAAC,OAAO,EA6BjB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,aAAa,WAAW,EACxB,WAAW,gBAAgB,GAAG,SAAS,KACtC,OA2BF,CAAA"}

package/build/api/examples/filter.js

@@ -0,0 +1,64 @@
+import { Example } from './schemas/example/$.js';
+/**
+ * Filter examples based on the display configuration.
+ *
+ * @param examples - All available examples
+ * @param selection - The display configuration
+ * @returns Filtered examples based on the selection criteria
+ */
+export const filterExamplesBySelection = (examples, selection) => {
+    // If no selection config, default to all
+    if (selection === undefined) {
+        return examples;
+    }
+    // Handle string literals
+    if (selection === 'all') {
+        return examples;
+    }
+    if (selection === 'none') {
+        return [];
+    }
+    // Handle include pattern
+    if ('include' in selection) {
+        const includeSet = new Set(selection.include);
+        return examples.filter(example => includeSet.has(example.name));
+    }
+    // Handle exclude pattern
+    if ('exclude' in selection) {
+        const excludeSet = new Set(selection.exclude);
+        return examples.filter(example => !excludeSet.has(example.name));
+    }
+    // Fallback to all examples if selection pattern is not recognized
+    return examples;
+};
+/**
+ * Check if an example should be displayed based on the selection criteria.
+ *
+ * @param exampleName - The ID of the example to check
+ * @param selection - The display configuration
+ * @returns Whether the example should be displayed
+ */
+export const shouldDisplayExample = (exampleName, selection) => {
+    // If no selection config, default to show
+    if (selection === undefined) {
+        return true;
+    }
+    // Handle string literals
+    if (selection === 'all') {
+        return true;
+    }
+    if (selection === 'none') {
+        return false;
+    }
+    // Handle include pattern
+    if ('include' in selection) {
+        return selection.include.includes(exampleName);
+    }
+    // Handle exclude pattern
+    if ('exclude' in selection) {
+        return !selection.exclude.includes(exampleName);
+    }
+    // Fallback to show if selection pattern is not recognized
+    return true;
+};
+//# sourceMappingURL=filter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/api/examples/filter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,QAA2B,EAC3B,SAAuC,EACpB,EAAE;IACrB,yCAAyC;IACzC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,yBAAyB;IACzB,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,yBAAyB;IACzB,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAc,SAAS,CAAC,OAAO,CAAC,CAAA;QAC1D,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAmB,CAAC,CAAC,CAAA;IAChF,CAAC;IAED,yBAAyB;IACzB,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAc,SAAS,CAAC,OAAO,CAAC,CAAA;QAC1D,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAmB,CAAC,CAAC,CAAA;IACjF,CAAC;IAED,kEAAkE;IAClE,OAAO,QAAQ,CAAA;AACjB,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,WAAwB,EACxB,SAAuC,EAC9B,EAAE;IACX,0CAA0C;IAC1C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,yBAAyB;IACzB,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,yBAAyB;IACzB,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;IAChD,CAAC;IAED,yBAAyB;IACzB,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QAC3B,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;IACjD,CAAC;IAED,0DAA0D;IAC1D,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

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

@@ -0,0 +1,18 @@
+import { Catalog as SchemaCatalog } from '#lib/catalog/$';
+import { FileSystem } from '@effect/platform';
+import { Effect } from 'effect';
+import type { Diagnostic } from './diagnostic/diagnostic.js';
+import { Catalog } from './schemas/catalog.js';
+export interface ScanResult {
+    catalog: Catalog;
+    diagnostics: Diagnostic[];
+}
+export interface ScanOptions {
+    dir: string;
+    extensions?: string[];
+    schemaCatalog?: SchemaCatalog.Catalog;
+}
+export declare const scan: (options: ScanOptions & {
+    files?: string[];
+}) => Effect.Effect<ScanResult, Error, FileSystem.FileSystem>;
+//# sourceMappingURL=scanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/api/examples/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAKzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,MAAM,EAA2B,MAAM,QAAQ,CAAA;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAQ5D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAO9C,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC,OAAO,CAAA;CACtC;AAyHD,eAAO,MAAM,IAAI,GACf,SAAS,WAAW,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,KAC1C,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,CA6LrD,CAAA"}