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

package/build/lib/change/criticality.js

@@ -0,0 +1,37 @@
+import { Level } from '#lib/change/level';
+import { S } from '#lib/kit-temp/effect';
+// ============================================================================
+// Schema
+// ============================================================================
+export const Criticality = S.Struct({
+    level: Level,
+    reason: S.optional(S.String),
+}).annotations({
+    identifier: 'Criticality',
+    title: 'Change Criticality',
+    description: 'The criticality assessment of a GraphQL schema change',
+});
+// ============================================================================
+// Constructors
+// ============================================================================
+export const make = Criticality.make;
+// ============================================================================
+// Guards
+// ============================================================================
+export const is = S.is(Criticality);
+// ============================================================================
+// State Predicates
+// ============================================================================
+export const isBreaking = (criticality) => criticality.level === 'BREAKING';
+export const isDangerous = (criticality) => criticality.level === 'DANGEROUS';
+export const isSafe = (criticality) => criticality.level === 'NON_BREAKING';
+// ============================================================================
+// Codecs
+// ============================================================================
+export const decode = S.decode(Criticality);
+export const encode = S.encode(Criticality);
+// ============================================================================
+// Equivalence
+// ============================================================================
+export const equivalence = S.equivalence(Criticality);
+//# sourceMappingURL=criticality.js.map

package/build/lib/change/criticality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"criticality.js","sourceRoot":"","sources":["../../../src/lib/change/criticality.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAExC,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;CAC7B,CAAC,CAAC,WAAW,CAAC;IACb,UAAU,EAAE,aAAa;IACzB,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EAAE,uDAAuD;CACrE,CAAC,CAAA;AAKF,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAA;AAEpC,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAA;AAEnC,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,WAAwB,EAAW,EAAE,CAAC,WAAW,CAAC,KAAK,KAAK,UAAU,CAAA;AAEjG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,WAAwB,EAAW,EAAE,CAAC,WAAW,CAAC,KAAK,KAAK,WAAW,CAAA;AAEnG,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,WAAwB,EAAW,EAAE,CAAC,WAAW,CAAC,KAAK,KAAK,cAAc,CAAA;AAEjG,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;AAC3C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;AAE3C,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAA"}

package/build/lib/change/level.d.ts

@@ -0,0 +1,3 @@
+import { S } from '#lib/kit-temp/effect';
+export declare const Level: S.Literal<["BREAKING", "DANGEROUS", "NON_BREAKING"]>;
+//# sourceMappingURL=level.d.ts.map

package/build/lib/change/level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level.d.ts","sourceRoot":"","sources":["../../../src/lib/change/level.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAExC,eAAO,MAAM,KAAK,sDAAqD,CAAA"}

package/build/lib/change/level.js

@@ -0,0 +1,3 @@
+import { S } from '#lib/kit-temp/effect';
+export const Level = S.Literal('BREAKING', 'DANGEROUS', 'NON_BREAKING');
+//# sourceMappingURL=level.js.map

package/build/lib/change/level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"level.js","sourceRoot":"","sources":["../../../src/lib/change/level.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAExC,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,EAAE,cAAc,CAAC,CAAA"}

package/build/lib/date-only/$.d.ts

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

package/build/lib/date-only/$.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../src/lib/date-only/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA"}

package/build/lib/date-only/$.js

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

package/build/lib/date-only/$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$.js","sourceRoot":"","sources":["../../../src/lib/date-only/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAA"}

package/build/lib/date-only/date-only.d.ts

@@ -0,0 +1,49 @@
+import { S } from '#lib/kit-temp/effect';
+import { Order } from 'effect';
+export declare const DateOnly: S.brand<S.refine<string, typeof S.String>, "DateOnly">;
+export type DateOnly = typeof DateOnly.Type;
+export declare const make: (a: string, options?: S.MakeOptions) => string & import("effect/Brand").Brand<"DateOnly">;
+export declare const order: Order.Order<DateOnly>;
+export declare const min: {
+    (that: string & import("effect/Brand").Brand<"DateOnly">): (self: string & import("effect/Brand").Brand<"DateOnly">) => string & import("effect/Brand").Brand<"DateOnly">;
+    (self: string & import("effect/Brand").Brand<"DateOnly">, that: string & import("effect/Brand").Brand<"DateOnly">): string & import("effect/Brand").Brand<"DateOnly">;
+};
+export declare const max: {
+    (that: string & import("effect/Brand").Brand<"DateOnly">): (self: string & import("effect/Brand").Brand<"DateOnly">) => string & import("effect/Brand").Brand<"DateOnly">;
+    (self: string & import("effect/Brand").Brand<"DateOnly">, that: string & import("effect/Brand").Brand<"DateOnly">): string & import("effect/Brand").Brand<"DateOnly">;
+};
+export declare const lessThan: {
+    (that: string & import("effect/Brand").Brand<"DateOnly">): (self: string & import("effect/Brand").Brand<"DateOnly">) => boolean;
+    (self: string & import("effect/Brand").Brand<"DateOnly">, that: string & import("effect/Brand").Brand<"DateOnly">): boolean;
+};
+export declare const greaterThan: {
+    (that: string & import("effect/Brand").Brand<"DateOnly">): (self: string & import("effect/Brand").Brand<"DateOnly">) => boolean;
+    (self: string & import("effect/Brand").Brand<"DateOnly">, that: string & import("effect/Brand").Brand<"DateOnly">): boolean;
+};
+export declare const equivalence: import("effect/Equivalence").Equivalence<string & import("effect/Brand").Brand<"DateOnly">>;
+export declare const is: (u: unknown, overrideOptions?: import("effect/SchemaAST").ParseOptions | number) => u is string & import("effect/Brand").Brand<"DateOnly">;
+export declare const decode: (i: string, overrideOptions?: import("effect/SchemaAST").ParseOptions) => import("effect/Effect").Effect<string & import("effect/Brand").Brand<"DateOnly">, import("effect/ParseResult").ParseError, never>;
+export declare const decodeSync: (i: string, overrideOptions?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"DateOnly">;
+export declare const encode: (a: string & import("effect/Brand").Brand<"DateOnly">, overrideOptions?: import("effect/SchemaAST").ParseOptions) => import("effect/Effect").Effect<string, import("effect/ParseResult").ParseError, never>;
+export declare const fromDate: (date: Date) => DateOnly;
+export declare const toDate: (date: DateOnly) => Date;
+/**
+ * Get the year from a date
+ */
+export declare const getYear: (date: DateOnly) => number;
+/**
+ * Get the month from a date (1-12)
+ */
+export declare const getMonth: (date: DateOnly) => number;
+/**
+ * Get the day from a date (1-31)
+ */
+export declare const getDay: (date: DateOnly) => number;
+/**
+ * Calculate the number of days between two dates
+ * @param from - The starting date
+ * @param to - The ending date
+ * @returns Number of days between the dates (positive if to > from, negative otherwise)
+ */
+export declare const getDaysBetween: (from: DateOnly, to: DateOnly) => number;
+//# sourceMappingURL=date-only.d.ts.map

package/build/lib/date-only/date-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-only.d.ts","sourceRoot":"","sources":["../../../src/lib/date-only/date-only.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAM9B,eAAO,MAAM,QAAQ,wDASpB,CAAA;AAMD,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAM3C,eAAO,MAAM,IAAI,2FAAgB,CAAA;AAMjC,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAgD,CAAA;AAExF,eAAO,MAAM,GAAG;;;CAAmB,CAAA;AAEnC,eAAO,MAAM,GAAG;;;CAAmB,CAAA;AAEnC,eAAO,MAAM,QAAQ;;;CAAwB,CAAA;AAE7C,eAAO,MAAM,WAAW;;;CAA2B,CAAA;AAMnD,eAAO,MAAM,WAAW,6FAA0B,CAAA;AAMlD,eAAO,MAAM,EAAE,4IAAiB,CAAA;AAMhC,eAAO,MAAM,MAAM,6MAAqB,CAAA;AAExC,eAAO,MAAM,UAAU,6HAAyB,CAAA;AAEhD,eAAO,MAAM,MAAM,6MAAqB,CAAA;AAMxC,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,QAGrC,CAAA;AAMD,eAAO,MAAM,MAAM,GAAI,MAAM,QAAQ,KAAG,IAAyC,CAAA;AAMjF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,QAAQ,KAAG,MAA4C,CAAA;AAErF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,QAAQ,KAAG,MAA4C,CAAA;AAEtF;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,QAAQ,KAAG,MAA6C,CAAA;AAErF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,QAAQ,EAAE,IAAI,QAAQ,KAAG,MAK7D,CAAA"}

package/build/lib/date-only/date-only.js

@@ -0,0 +1,76 @@
+import { S } from '#lib/kit-temp/effect';
+import { Order } from 'effect';
+// ============================================================================
+// Schema
+// ============================================================================
+export const DateOnly = S.String.pipe(S.pattern(/^\d{4}-\d{2}-\d{2}$/), S.annotations({
+    identifier: 'DateOnly',
+    title: 'Date Only',
+    description: 'A date-only value in YYYY-MM-DD format',
+    examples: ['2024-01-15', '2023-12-31'],
+}), S.brand('DateOnly'));
+// ============================================================================
+// Constructors
+// ============================================================================
+export const make = DateOnly.make;
+// ============================================================================
+// Ordering
+// ============================================================================
+export const order = Order.mapInput(Order.string, (date) => date);
+export const min = Order.min(order);
+export const max = Order.max(order);
+export const lessThan = Order.lessThan(order);
+export const greaterThan = Order.greaterThan(order);
+// ============================================================================
+// Equivalence
+// ============================================================================
+export const equivalence = S.equivalence(DateOnly);
+// ============================================================================
+// Type Guard
+// ============================================================================
+export const is = S.is(DateOnly);
+// ============================================================================
+// Codec
+// ============================================================================
+export const decode = S.decode(DateOnly);
+export const decodeSync = S.decodeSync(DateOnly);
+export const encode = S.encode(DateOnly);
+// ============================================================================
+// Importers
+// ============================================================================
+export const fromDate = (date) => {
+    const dateString = date.toISOString().split('T')[0];
+    return make(dateString);
+};
+// ============================================================================
+// Exporters
+// ============================================================================
+export const toDate = (date) => new Date(date + 'T00:00:00.000Z');
+// ============================================================================
+// Domain Logic
+// ============================================================================
+/**
+ * Get the year from a date
+ */
+export const getYear = (date) => parseInt(date.substring(0, 4), 10);
+/**
+ * Get the month from a date (1-12)
+ */
+export const getMonth = (date) => parseInt(date.substring(5, 7), 10);
+/**
+ * Get the day from a date (1-31)
+ */
+export const getDay = (date) => parseInt(date.substring(8, 10), 10);
+/**
+ * Calculate the number of days between two dates
+ * @param from - The starting date
+ * @param to - The ending date
+ * @returns Number of days between the dates (positive if to > from, negative otherwise)
+ */
+export const getDaysBetween = (from, to) => {
+    const fromDate = toDate(from);
+    const toDate_ = toDate(to);
+    const diffMs = toDate_.getTime() - fromDate.getTime();
+    return Math.floor(diffMs / (1000 * 60 * 60 * 24));
+};
+//# sourceMappingURL=date-only.js.map

package/build/lib/date-only/date-only.js.map

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

package/build/lib/diagnostic/$$.d.ts

@@ -0,0 +1,6 @@
+export * from './control.js';
+export * from './diagnostic.js';
+export * from './filter.js';
+export * from './reporter.js';
+export * as Severity from './severity.js';
+//# sourceMappingURL=$$.d.ts.map

package/build/lib/diagnostic/$$.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../src/lib/diagnostic/$$.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA"}

package/build/lib/diagnostic/$$.js

@@ -0,0 +1,6 @@
+export * from './control.js';
+export * from './diagnostic.js';
+export * from './filter.js';
+export * from './reporter.js';
+export * as Severity from './severity.js';
+//# sourceMappingURL=$$.js.map

package/build/lib/diagnostic/$$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.js","sourceRoot":"","sources":["../../../src/lib/diagnostic/$$.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA"}

package/build/lib/diagnostic/$.d.ts

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

package/build/lib/diagnostic/$.d.ts.map

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

package/build/lib/diagnostic/$.js

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

package/build/lib/diagnostic/$.js.map

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

package/build/lib/diagnostic/control.d.ts

@@ -0,0 +1,79 @@
+import { S } from '#lib/kit-temp/effect';
+import type { Diagnostic } from './diagnostic.js';
+import { Severity } from './severity.js';
+/**
+ * Fine-grained control over diagnostic behavior.
+ * Can be used as a boolean for simple on/off, or as an object for detailed control.
+ */
+export declare const Control: S.Struct<{
+    /**
+     * Master switch - if false, diagnostic is disabled in all phases.
+     */
+    enabled: typeof S.Boolean;
+    /**
+     * Control behavior during development.
+     */
+    dev: S.optional<S.Struct<{
+        /**
+         * Whether diagnostics are enabled for this phase.
+         * If not specified, uses the global enabled setting.
+         */
+        enabled: S.optional<typeof S.Boolean>;
+        /**
+         * Override the default severity for this phase.
+         * If not specified, the diagnostic's default severity is used.
+         */
+        severity: S.optional<S.Enums<{
+            readonly error: "error";
+            readonly warning: "warning";
+            readonly info: "info";
+        }>>;
+    }>>;
+    /**
+     * Control behavior during build.
+     */
+    build: S.optional<S.Struct<{
+        /**
+         * Whether diagnostics are enabled for this phase.
+         * If not specified, uses the global enabled setting.
+         */
+        enabled: S.optional<typeof S.Boolean>;
+        /**
+         * Override the default severity for this phase.
+         * If not specified, the diagnostic's default severity is used.
+         */
+        severity: S.optional<S.Enums<{
+            readonly error: "error";
+            readonly warning: "warning";
+            readonly info: "info";
+        }>>;
+    }>>;
+}>;
+export type Control = typeof Control.Type;
+/**
+ * Filters diagnostics based on control settings and adjusts their severity.
+ *
+ * @param diagnostics - Array of diagnostics to filter
+ * @param getControl - Function to get the control setting for a diagnostic
+ * @param phase - Current phase (dev or build)
+ * @returns Filtered diagnostics with adjusted severity
+ */
+export declare const applyControl: <T extends Diagnostic>(diagnostics: T[], getControl: (diagnostic: T) => Control | boolean | undefined, phase?: Phase) => T[];
+export type Phase = 'dev' | 'build';
+/**
+ * Get effective settings for a specific phase.
+ * Call sites provide their own defaults for each diagnostic type.
+ *
+ * @param control - The diagnostic control configuration (boolean, object, or undefined)
+ * @param phase - The current phase (dev or build)
+ * @param defaults - Default settings to use when not specified
+ * @returns Effective enabled state and severity for the phase
+ */
+export declare const getEffetivePhaseSettings: (control: Control | boolean | undefined, phase: Phase, defaults: {
+    enabled: boolean;
+    severity: Severity;
+}) => {
+    enabled: boolean;
+    severity: Severity;
+};
+//# sourceMappingURL=control.d.ts.map

package/build/lib/diagnostic/control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../../src/lib/diagnostic/control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAyBxC;;;GAGG;AACH,eAAO,MAAM,OAAO;IAClB;;OAEG;;IAEH;;OAEG;;QA1BH;;;WAGG;;QAEH;;;WAGG;;;;;;;IAoBH;;OAEG;;QA9BH;;;WAGG;;QAEH;;;WAGG;;;;;;;EA2BH,CAAA;AAEF,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAA;AAMzC;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,UAAU,EAC/C,aAAa,CAAC,EAAE,EAChB,YAAY,CAAC,UAAU,EAAE,CAAC,KAAK,OAAO,GAAG,OAAO,GAAG,SAAS,EAC5D,QAAO,KAAa,KACnB,CAAC,EAmBH,CAAA;AAED,MAAM,MAAM,KAAK,GAAG,KAAK,GAAG,OAAO,CAAA;AAEnC;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS,OAAO,GAAG,OAAO,GAAG,SAAS,EACtC,OAAO,KAAK,EACZ,UAAU;IACR,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,QAAQ,CAAA;CACnB,KACA;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAiCxC,CAAA"}

package/build/lib/diagnostic/control.js

@@ -0,0 +1,107 @@
+import { S } from '#lib/kit-temp/effect';
+import { Severity } from './severity.js';
+// ============================================================================
+// Schema
+// ============================================================================
+/**
+ * Phase-specific control for diagnostics.
+ */
+const PhaseControl = S.Struct({
+    /**
+     * Whether diagnostics are enabled for this phase.
+     * If not specified, uses the global enabled setting.
+     */
+    enabled: S.optional(S.Boolean),
+    /**
+     * Override the default severity for this phase.
+     * If not specified, the diagnostic's default severity is used.
+     */
+    severity: S.optional(Severity),
+}).annotations({
+    identifier: 'DiagnosticPhaseControl',
+    description: 'Control diagnostic behavior for a specific phase',
+});
+/**
+ * Fine-grained control over diagnostic behavior.
+ * Can be used as a boolean for simple on/off, or as an object for detailed control.
+ */
+export const Control = S.Struct({
+    /**
+     * Master switch - if false, diagnostic is disabled in all phases.
+     */
+    enabled: S.Boolean,
+    /**
+     * Control behavior during development.
+     */
+    dev: S.optional(PhaseControl),
+    /**
+     * Control behavior during build.
+     */
+    build: S.optional(PhaseControl),
+}).annotations({
+    identifier: 'DiagnosticControl',
+    description: 'Fine-grained control over diagnostic behavior',
+});
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Filters diagnostics based on control settings and adjusts their severity.
+ *
+ * @param diagnostics - Array of diagnostics to filter
+ * @param getControl - Function to get the control setting for a diagnostic
+ * @param phase - Current phase (dev or build)
+ * @returns Filtered diagnostics with adjusted severity
+ */
+export const applyControl = (diagnostics, getControl, phase = 'dev') => {
+    return diagnostics.filter(diagnostic => {
+        const control = getControl(diagnostic);
+        // Get effective settings for this phase
+        const settings = getEffetivePhaseSettings(control, phase, { enabled: true, severity: diagnostic.severity });
+        if (!settings.enabled) {
+            return false; // Filter out disabled diagnostics
+        } // Override severity based on control settings
+        ;
+        diagnostic.severity = settings.severity;
+        return true;
+    });
+};
+/**
+ * Get effective settings for a specific phase.
+ * Call sites provide their own defaults for each diagnostic type.
+ *
+ * @param control - The diagnostic control configuration (boolean, object, or undefined)
+ * @param phase - The current phase (dev or build)
+ * @param defaults - Default settings to use when not specified
+ * @returns Effective enabled state and severity for the phase
+ */
+export const getEffetivePhaseSettings = (control, phase, defaults) => {
+    // Handle undefined - use defaults
+    if (control === undefined) {
+        return defaults;
+    }
+    // Handle boolean shorthand
+    if (typeof control === 'boolean') {
+        return {
+            enabled: control,
+            severity: defaults.severity,
+        };
+    }
+    // Handle full DiagnosticControl
+    const phaseControl = control[phase];
+    // Determine enabled state
+    // Priority: phase.enabled > global.enabled > default.enabled
+    const enabled = phaseControl?.enabled ?? control.enabled;
+    // If globally disabled and phase doesn't explicitly enable, stay disabled
+    if (!enabled) {
+        return {
+            enabled: false,
+            severity: phaseControl?.severity ?? defaults.severity,
+        };
+    }
+    return {
+        enabled,
+        severity: phaseControl?.severity ?? defaults.severity,
+    };
+};
+//# sourceMappingURL=control.js.map

package/build/lib/diagnostic/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../../../src/lib/diagnostic/control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E;;GAEG;AACH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B;;;OAGG;IACH,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9B;;;OAGG;IACH,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;CAC/B,CAAC,CAAC,WAAW,CAAC;IACb,UAAU,EAAE,wBAAwB;IACpC,WAAW,EAAE,kDAAkD;CAChE,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC,OAAO;IAClB;;OAEG;IACH,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC7B;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;CAChC,CAAC,CAAC,WAAW,CAAC;IACb,UAAU,EAAE,mBAAmB;IAC/B,WAAW,EAAE,+CAA+C;CAC7D,CAAC,CAAA;AAIF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,WAAgB,EAChB,UAA4D,EAC5D,QAAe,KAAK,EACf,EAAE;IACP,OAAO,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;QACrC,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;QAEtC,wCAAwC;QACxC,MAAM,QAAQ,GAAG,wBAAwB,CACvC,OAAO,EACP,KAAK,EACL,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CACjD,CAAA;QAED,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,OAAO,KAAK,CAAA,CAAC,kCAAkC;QACjD,CAAC,CAAC,8CAA8C;QAEhD,CAAC;QAAC,UAAkB,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAA;QAEjD,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAID;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,OAAsC,EACtC,KAAY,EACZ,QAGC,EACyC,EAAE;IAC5C,kCAAkC;IAClC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,2BAA2B;IAC3B,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B,CAAA;IACH,CAAC;IAED,gCAAgC;IAChC,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAEnC,0BAA0B;IAC1B,6DAA6D;IAC7D,MAAM,OAAO,GAAG,YAAY,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAA;IAExD,0EAA0E;IAC1E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,YAAY,EAAE,QAAQ,IAAI,QAAQ,CAAC,QAAQ;SACtD,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO;QACP,QAAQ,EAAE,YAAY,EAAE,QAAQ,IAAI,QAAQ,CAAC,QAAQ;KACtD,CAAA;AACH,CAAC,CAAA"}

package/build/lib/diagnostic/diagnostic.d.ts

@@ -0,0 +1,130 @@
+import { EffectKit, S } from '#lib/kit-temp/effect';
+import * as SeverityModule from './severity.js';
+/**
+ * Base schema that all diagnostics must extend.
+ *
+ * This provides a three-level hierarchy for diagnostics:
+ * - Level 1: `_tag: 'Diagnostic'` - Identifies any diagnostic
+ * - Level 2: `source` - Which system generated the diagnostic
+ * - Level 3: `name` - The specific diagnostic type
+ *
+ * @example
+ * ```typescript
+ * const MyDiagnostic = S.extend(
+ *   DiagnosticBase,
+ *   S.Struct({
+ *     _tag: S.Literal('Diagnostic'),
+ *     source: S.Literal('my-feature'),
+ *     name: S.Literal('specific-error'),
+ *     // ... additional fields
+ *   })
+ * )
+ * ```
+ */
+export declare const Diagnostic: S.Struct<{
+    /**
+     * Level 1: Identifies this as a diagnostic.
+     * All diagnostics must have this tag.
+     */
+    _tag: S.Literal<["Diagnostic"]>;
+    /**
+     * Level 2: Source system/feature that generated this diagnostic.
+     * Examples: 'file-router', 'examples', 'schema-validator'
+     */
+    source: typeof S.String;
+    /**
+     * Level 3: Specific diagnostic name within the source.
+     * Should be kebab-case and unique within the source.
+     * Examples: 'index-conflict', 'unused-default', 'missing-field'
+     */
+    name: typeof S.String;
+    /**
+     * Severity level of the diagnostic.
+     */
+    severity: S.Enums<{
+        readonly error: "error";
+        readonly warning: "warning";
+        readonly info: "info";
+    }>;
+    /**
+     * Human-readable message describing the issue.
+     */
+    message: typeof S.String;
+}>;
+export type Diagnostic = typeof Diagnostic.Type;
+/**
+ * Create a diagnostic schema that extends DiagnosticBase.
+ *
+ * This helper properly handles field narrowing (like severity)
+ * and ensures the diagnostic follows the three-level hierarchy.
+ *
+ * @example
+ * ```typescript
+ * const MyDiagnostic = Diagnostic.create({
+ *   source: 'my-feature',
+ *   name: 'specific-error',
+ *   severity: 'error',
+ *   context: {
+ *     customField: S.String,
+ *   }
+ * })
+ * ```
+ */
+export declare const create: <source extends string, name extends string, severity extends SeverityModule.Severity | undefined = undefined, context extends S.Struct.Fields = {}>(params: {
+    source: source;
+    name: name;
+    severity?: severity;
+    context?: context;
+}) => S.TaggedStruct<"Diagnostic", Omit<EffectKit.Schema.Struct.ExtractFields<typeof Diagnostic>, "name" | "source" | "severity" | "_tag"> & {
+    name: S.Literal<[name]>;
+    source: S.Literal<[source]>;
+    severity: severity extends string ? S.Literal<[severity]> : EffectKit.Schema.Struct.ExtractFields<typeof Diagnostic>["severity"];
+} & context>;
+export declare const createMake: <diagnostic extends S.TaggedStruct<any, any>>(diagnostic: diagnostic) => EffectKit.Schema.ConstructorUsingOmitLiteral1Algo<diagnostic>;
+export declare const decode: (i: {
+    readonly _tag: "Diagnostic";
+    readonly message: string;
+    readonly name: string;
+    readonly source: string;
+    readonly severity: "error" | "warning" | "info";
+}, overrideOptions?: import("effect/SchemaAST").ParseOptions) => import("effect/Effect").Effect<{
+    readonly _tag: "Diagnostic";
+    readonly message: string;
+    readonly name: string;
+    readonly source: string;
+    readonly severity: "error" | "warning" | "info";
+}, import("effect/ParseResult").ParseError, never>;
+export declare const decodeSync: (i: {
+    readonly _tag: "Diagnostic";
+    readonly message: string;
+    readonly name: string;
+    readonly source: string;
+    readonly severity: "error" | "warning" | "info";
+}, overrideOptions?: import("effect/SchemaAST").ParseOptions) => {
+    readonly _tag: "Diagnostic";
+    readonly message: string;
+    readonly name: string;
+    readonly source: string;
+    readonly severity: "error" | "warning" | "info";
+};
+export declare const encode: (a: {
+    readonly _tag: "Diagnostic";
+    readonly message: string;
+    readonly name: string;
+    readonly source: string;
+    readonly severity: "error" | "warning" | "info";
+}, overrideOptions?: import("effect/SchemaAST").ParseOptions) => import("effect/Effect").Effect<{
+    readonly _tag: "Diagnostic";
+    readonly message: string;
+    readonly name: string;
+    readonly source: string;
+    readonly severity: "error" | "warning" | "info";
+}, import("effect/ParseResult").ParseError, never>;
+export declare const is: (u: unknown, overrideOptions?: import("effect/SchemaAST").ParseOptions | number) => u is {
+    readonly _tag: "Diagnostic";
+    readonly message: string;
+    readonly name: string;
+    readonly source: string;
+    readonly severity: "error" | "warning" | "info";
+};
+//# sourceMappingURL=diagnostic.d.ts.map

package/build/lib/diagnostic/diagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.d.ts","sourceRoot":"","sources":["../../../src/lib/diagnostic/diagnostic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,KAAK,cAAc,MAAM,eAAe,CAAA;AAM/C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,UAAU;IACrB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;IAGH;;OAEG;;;;;;IAGH;;OAEG;;EAKH,CAAA;AAEF,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAM/C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM,GACjB,MAAM,SAAS,MAAM,EACrB,IAAI,SAAS,MAAM,EACnB,QAAQ,SAAS,cAAc,CAAC,QAAQ,GAAG,SAAS,GAAG,SAAS,EAChE,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,EAEpC,QAAQ;IACN,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,KACA,CAAC,CAAC,YAAY,CACf,YAAY,EACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC,GACvG;IACA,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IACvB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;IAC3B,QAAQ,EAAE,QAAQ,SAAS,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,GACrD,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,UAAU,CAAC,CAAC,UAAU,CAAC,CAAA;CACzE,GACC,OAAO,CAWV,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,UAAU,SAAS,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,EACpE,YAAY,UAAU,KACrB,SAAS,CAAC,MAAM,CAAC,gCAAgC,CAAC,UAAU,CAO9D,CAAA;AAMD,eAAO,MAAM,MAAM;;;;;;;;;;;;kDAAuB,CAAA;AAC1C,eAAO,MAAM,UAAU;;;;;;;;;;;;CAA2B,CAAA;AAClD,eAAO,MAAM,MAAM;;;;;;;;;;;;kDAAuB,CAAA;AAM1C,eAAO,MAAM,EAAE;;;;;;CAAmB,CAAA"}