veryfront 0.1.283 → 0.1.285

package/esm/src/extensions/interfaces/schema-validator.d.ts

@@ -3,13 +3,57 @@
  *
  * Default implementation: `@veryfront/ext-zod`
  *
+ * The interface exposes a small DSL (inspired by zod) that lets core modules
+ * declare validation schemas without importing zod directly. Schemas are
+ * constructed lazily via `defineSchema()` so that an extension-provided
+ * implementation can be registered before any schema is materialized.
+ *
  * @module extensions/interfaces/schema-validator
  */
-/** An opaque schema definition that validates and infers type `T`. */
+/**
+ * An opaque schema definition that validates and infers type `T`.
+ *
+ * Implementations may use this as a nominal wrapper around a native validator
+ * (e.g. a zod schema). Core code only calls the methods defined here.
+ */
 export interface Schema<T = unknown> {
-    /** Brand field for nominal typing -- not used at runtime. */
+    /** Brand field for nominal typing — not used at runtime. */
     readonly _output: T;
+    optional(): Schema<T | undefined>;
+    nullable(): Schema<T | null>;
+    nullish(): Schema<T | null | undefined>;
+    default(value: T | (() => T)): Schema<T>;
+    describe(description: string): Schema<T>;
+    refine(check: (value: T) => boolean, message?: string | {
+        message?: string;
+    }): Schema<T>;
+    transform<U>(fn: (value: T) => U): Schema<U>;
+    strict(): Schema<T>;
+    passthrough(): Schema<T>;
+    partial(): Schema<Partial<T>>;
+    extend<U extends Record<string, Schema<unknown>>>(shape: U): Schema<T & {
+        [K in keyof U]: InferSchema<U[K]>;
+    }>;
+    merge<U>(other: Schema<U>): Schema<T & U>;
+    min(value: number, message?: string): Schema<T>;
+    max(value: number, message?: string): Schema<T>;
+    int(message?: string): Schema<T>;
+    positive(message?: string): Schema<T>;
+    nonnegative(message?: string): Schema<T>;
+    regex(pattern: RegExp, message?: string): Schema<T>;
+    email(message?: string): Schema<T>;
+    url(message?: string): Schema<T>;
+    uuid(message?: string): Schema<T>;
+    datetime(message?: string): Schema<T>;
+    parse(data: unknown): T;
+    safeParse(data: unknown): ValidationResult<T>;
 }
+/** Extracts the inferred output type `T` from a `Schema<T>`. */
+export type InferSchema<S> = S extends Schema<infer T> ? T : never;
+/** Maps a raw object shape to its inferred object type. */
+export type InferShape<S extends Record<string, Schema<unknown>>> = {
+    [K in keyof S]: InferSchema<S[K]>;
+};
 /** A single validation issue with location context. */
 export interface ValidationIssue {
     /** Dot-path to the offending field (e.g. `"user.email"`). */
@@ -30,17 +74,52 @@ export interface ValidationFailure {
     success: false;
     /** List of issues found during validation. */
     issues: ValidationIssue[];
+    /** Native error thrown by the underlying validator (if any). */
+    error?: unknown;
 }
 /** Discriminated union of validation outcomes. */
 export type ValidationResult<T> = ValidationSuccess<T> | ValidationFailure;
+/**
+ * Namespace for `coerce.*` constructors — accepts input in any form and
+ * coerces to the target type before validation.
+ */
+export interface SchemaValidatorCoerce {
+    string(): Schema<string>;
+    number(): Schema<number>;
+    boolean(): Schema<boolean>;
+    date(): Schema<Date>;
+}
 /**
  * SchemaValidator contract interface.
  *
- * Implementations validate unknown input against a typed schema and
- * return a discriminated success/failure result.
+ * Exposes a zod-inspired DSL. The `object(shape)`, `array(schema)`, etc.
+ * constructors produce opaque `Schema<T>` instances that can be further
+ * refined via chainables and finally validated with `.parse` / `.safeParse`.
  */
 export interface SchemaValidator {
-    /** Validate `data` against the given schema. */
+    string(): Schema<string>;
+    number(): Schema<number>;
+    boolean(): Schema<boolean>;
+    date(): Schema<Date>;
+    null(): Schema<null>;
+    unknown(): Schema<unknown>;
+    any(): Schema<any>;
+    object<S extends Record<string, Schema<unknown>>>(shape: S): Schema<InferShape<S>>;
+    array<T>(element: Schema<T>): Schema<T[]>;
+    record<K extends string | number | symbol, V>(keys: Schema<K>, values: Schema<V>): Schema<Record<K, V>>;
+    union<T extends readonly [Schema<unknown>, ...Schema<unknown>[]]>(schemas: T): Schema<InferSchema<T[number]>>;
+    discriminatedUnion<K extends string, T extends readonly [Schema<unknown>, ...Schema<unknown>[]]>(discriminator: K, schemas: T): Schema<InferSchema<T[number]>>;
+    literal<T extends string | number | boolean | null>(value: T): Schema<T>;
+    enum<T extends readonly [string, ...string[]]>(values: T): Schema<T[number]>;
+    /** Coercing constructors — accept any input and coerce to the target. */
+    coerce: SchemaValidatorCoerce;
+    /**
+     * Convenience that runs validation on an already-constructed schema.
+     * Equivalent to `schema.safeParse(data)`; kept for ergonomic parity with
+     * earlier revisions of this contract.
+     */
     validate<T>(schema: Schema<T>, data: unknown): ValidationResult<T>;
 }
+/** Factory type accepted by `defineSchema`. */
+export type SchemaFactory<T> = (v: SchemaValidator) => Schema<T>;
 //# sourceMappingURL=schema-validator.d.ts.map

package/esm/src/extensions/interfaces/schema-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/schema-validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sEAAsE;AACtE,MAAM,WAAW,MAAM,CAAC,CAAC,GAAG,OAAO;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;CACrB;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qCAAqC;AACrC,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,OAAO,EAAE,IAAI,CAAC;IACd,iCAAiC;IACjC,IAAI,EAAE,CAAC,CAAC;CACT;AAED,iCAAiC;AACjC,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,8CAA8C;IAC9C,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;CACpE"}
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/schema-validator.ts"],"names":[],"mappings":"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"}

package/esm/src/extensions/interfaces/schema-validator.js

@@ -3,6 +3,11 @@
  *
  * Default implementation: `@veryfront/ext-zod`
  *
+ * The interface exposes a small DSL (inspired by zod) that lets core modules
+ * declare validation schemas without importing zod directly. Schemas are
+ * constructed lazily via `defineSchema()` so that an extension-provided
+ * implementation can be registered before any schema is materialized.
+ *
  * @module extensions/interfaces/schema-validator
  */
 export {};

package/esm/src/extensions/loader.d.ts

@@ -7,6 +7,13 @@ import type { ExtensionLogger, ResolvedExtension } from "./types.js";
 export declare class ExtensionLoader {
     private logger;
     private setupOrder;
+    private primed;
+    /**
+     * Register contracts that will be re-applied after each `setupAll()`
+     * teardown pass. Used by `orchestrateExtensions()` to seed infrastructure
+     * (e.g. `AIProviderRegistry`) before per-extension `setup()` runs.
+     */
+    primeContracts(contracts: Record<string, unknown>): void;
     constructor(logger: ExtensionLogger);
     /**
      * Flatten presets: extensions with `extends` are replaced by their children.

package/esm/src/extensions/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAA+B,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElG,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAA2B;gBAEjC,MAAM,EAAE,eAAe;IAInC;;;;OAIG;IACH,cAAc,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE;IAIpE,OAAO,CAAC,mBAAmB;IA8B3B;;;OAGG;IACH,eAAe,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE;IA6ErE;;;OAGG;IACG,QAAQ,CACZ,UAAU,EAAE,iBAAiB,EAAE,EAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC;IA4EhB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAcnC"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAA+B,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElG,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,MAAM,CAA+B;IAE7C;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;gBAI5C,MAAM,EAAE,eAAe;IAInC;;;;OAIG;IACH,cAAc,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE;IAIpE,OAAO,CAAC,mBAAmB;IA8B3B;;;OAGG;IACH,eAAe,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE;IA6ErE;;;OAGG;IACG,QAAQ,CACZ,UAAU,EAAE,iBAAiB,EAAE,EAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC;IAgFhB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAcnC"}

package/esm/src/extensions/loader.js

@@ -10,6 +10,15 @@ import { detectConflicts, selectContractProviders, validateExtension } from "./v
 export class ExtensionLoader {
     logger;
     setupOrder = [];
+    primed = {};
+    /**
+     * Register contracts that will be re-applied after each `setupAll()`
+     * teardown pass. Used by `orchestrateExtensions()` to seed infrastructure
+     * (e.g. `AIProviderRegistry`) before per-extension `setup()` runs.
+     */
+    primeContracts(contracts) {
+        this.primed = { ...this.primed, ...contracts };
+    }
     constructor(logger) {
         this.logger = logger;
     }
@@ -126,6 +135,9 @@ export class ExtensionLoader {
         // Idempotent: teardownAll clears setupOrder and resets the contract
         // registry even when nothing is loaded yet.
         await this.teardownAll();
+        for (const [name, impl] of Object.entries(this.primed)) {
+            register(name, impl);
+        }
         // Check for contract conflicts before loading
         const conflicts = detectConflicts(extensions);
         if (conflicts.length > 0) {

package/esm/src/extensions/orchestrate.d.ts

@@ -23,6 +23,8 @@ export interface OrchestrateOptions {
         extensions?: ExtensionConfigEntry[];
     };
     logger: ExtensionLogger;
+    /** Contracts to seed into the registry after teardown, before setup(). */
+    primeContracts?: Record<string, unknown>;
     /** @internal Override discovery functions in tests. */
     discovery?: {
         discoverPackageExtensions: typeof defaultDiscovery.discoverPackageExtensions;

package/esm/src/extensions/orchestrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrate.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,gBAAgB,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,IAAI,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAEV,oBAAoB,EACpB,eAAe,EAGhB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;IAChD,MAAM,EAAE,eAAe,CAAC;IACxB,uDAAuD;IACvD,SAAS,CAAC,EAAE;QACV,yBAAyB,EAAE,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QAC7E,yBAAyB,EAAE,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QAC7E,uBAAuB,EAAE,OAAO,gBAAgB,CAAC,uBAAuB,CAAC;QACzE,eAAe,EAAE,OAAO,gBAAgB,CAAC,eAAe,CAAC;KAC1D,CAAC;IACF,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,kBAAkB,CAAC;CACzC;AAmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,eAAe,CAAC,CA4E1B"}
+{"version":3,"file":"orchestrate.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,gBAAgB,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,IAAI,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAEV,oBAAoB,EACpB,eAAe,EAGhB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;IAChD,MAAM,EAAE,eAAe,CAAC;IACxB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,uDAAuD;IACvD,SAAS,CAAC,EAAE;QACV,yBAAyB,EAAE,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QAC7E,yBAAyB,EAAE,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QAC7E,uBAAuB,EAAE,OAAO,gBAAgB,CAAC,uBAAuB,CAAC;QACzE,eAAe,EAAE,OAAO,gBAAgB,CAAC,eAAe,CAAC;KAC1D,CAAC;IACF,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,kBAAkB,CAAC;CACzC;AAmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,eAAe,CAAC,CA+E1B"}

package/esm/src/extensions/orchestrate.js

@@ -104,6 +104,9 @@ export async function orchestrateExtensions(options) {
     const localResolved = await loadAllFactories(localPaths, "local-file", loadFactory);
     const merged = disc.mergeExtensions(configResolved, packageResolved, projectResolved, localResolved, disables);
     const loader = new ExtensionLoader(logger);
+    if (options.primeContracts) {
+        loader.primeContracts(options.primeContracts);
+    }
     await loader.setupAll(merged, config);
     return loader;
 }

package/esm/src/extensions/recommendations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/recommendations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1E"}
+{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/recommendations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1E"}

package/esm/src/extensions/recommendations.js

@@ -12,7 +12,10 @@ const recommendations = new Map([
     ["DatabaseClient", "@veryfront/ext-postgres"],
     ["AuthProvider", "@veryfront/ext-jwt"],
     ["TracingExporter", "@veryfront/ext-opentelemetry"],
-    ["AIModelProvider", "@veryfront/ext-openai"],
+    ["AIProviderRegistry", "@veryfront/ext-openai"],
+    ["AIProvider:openai", "@veryfront/ext-openai"],
+    ["AIProvider:anthropic", "@veryfront/ext-anthropic"],
+    ["AIProvider:google", "@veryfront/ext-google"],
     ["EmbeddingProvider", "@veryfront/ext-embeddings"],
     ["CodeParser", "@veryfront/ext-babel"],
     ["SchemaValidator", "@veryfront/ext-zod"],

package/esm/src/extensions/registries/ai-provider-registry.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Default Map-backed implementation of the AIProviderRegistry contract.
+ *
+ * Preserves insertion order via Map (used by `list()`). Throws on
+ * duplicate id to surface silent collisions between extensions.
+ *
+ * @module extensions/registries/ai-provider-registry
+ */
+import type { AIProviderRegistry } from "../interfaces/ai-provider.js";
+export declare function createAIProviderRegistry(): AIProviderRegistry;
+//# sourceMappingURL=ai-provider-registry.d.ts.map

package/esm/src/extensions/registries/ai-provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-provider-registry.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/registries/ai-provider-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAc,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAyCnF,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D"}

package/esm/src/extensions/registries/ai-provider-registry.js

@@ -0,0 +1,40 @@
+/**
+ * Default Map-backed implementation of the AIProviderRegistry contract.
+ *
+ * Preserves insertion order via Map (used by `list()`). Throws on
+ * duplicate id to surface silent collisions between extensions.
+ *
+ * @module extensions/registries/ai-provider-registry
+ */
+class AIProviderRegistryImpl {
+    providers = new Map();
+    register(provider) {
+        if (this.providers.has(provider.id)) {
+            throw new Error(`AIProvider "${provider.id}" is already registered. ` +
+                `Call unregister("${provider.id}") first if you intend to replace it.`);
+        }
+        this.providers.set(provider.id, provider);
+    }
+    unregister(id) {
+        this.providers.delete(id);
+    }
+    get(id) {
+        return this.providers.get(id);
+    }
+    require(id) {
+        const p = this.providers.get(id);
+        if (p)
+            return p;
+        const known = [...this.providers.keys()].join(", ") || "(none)";
+        throw new Error(`No AIProvider registered for "${id}". Known providers: ${known}.`);
+    }
+    has(id) {
+        return this.providers.has(id);
+    }
+    list() {
+        return [...this.providers.values()];
+    }
+}
+export function createAIProviderRegistry() {
+    return new AIProviderRegistryImpl();
+}

package/esm/src/html/styles-builder/plugin-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/plugin-loader.ts"],"names":[],"mappings":"AAiIA;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4D/E;AAED,wBAAsB,UAAU,CAC9B,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAwClB"}
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/plugin-loader.ts"],"names":[],"mappings":"AAqHA;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4D/E;AAED,wBAAsB,UAAU,CAC9B,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAwClB"}

package/esm/src/html/styles-builder/plugin-loader.js

@@ -7,9 +7,6 @@
  * @module html/styles-builder/plugin-loader
  */
 import * as dntShim from "../../../_dnt.shims.js";
-import plugin from "tailwindcss/plugin";
-import defaultTheme from "tailwindcss/defaultTheme";
-import colors from "tailwindcss/colors";
 import { serverLogger } from "../../utils/index.js";
 import { getErrorBySlug, IMPORT_RESOLUTION_ERROR, NETWORK_ERROR, VeryfrontError, } from "../../errors/index.js";
 import { getTailwindPluginBundleUrl } from "../../build/binary-plugin-includes.js";
@@ -53,19 +50,10 @@ catch {
         enumerable: true,
     });
 }
-// Set up global shims for tailwindcss subpaths - used by dynamically loaded plugins
-dntShim.dntGlobalThis.__tailwindPluginShim = {
-    default: plugin,
-    __esModule: true,
-};
-dntShim.dntGlobalThis.__tailwindDefaultThemeShim = {
-    default: defaultTheme,
-    __esModule: true,
-};
-dntShim.dntGlobalThis.__tailwindColorsShim = {
-    default: colors,
-    __esModule: true,
-};
+// Global shims for `tailwindcss/plugin`, `tailwindcss/defaultTheme`, and
+// `tailwindcss/colors` used by dynamically loaded plugin bundles are installed
+// by the `@veryfront/ext-tailwind` extension's `setup()` hook — they depend on
+// tailwindcss imports that live in the extension package, not in core.
 function isRealDenoRuntime() {
     return typeof dntShim.Deno !== "undefined" && typeof dntShim.Deno.version === "object";
 }

package/esm/src/html/styles-builder/tailwind-compiler-cache.d.ts

@@ -5,10 +5,16 @@
  * stylesheet hash. Prevents race conditions when concurrent requests use
  * different stylesheets.
  *
+ * The actual tailwindcss `compile()` call is routed through the
+ * `CSSProcessor` extension contract (default implementation:
+ * `@veryfront/ext-tailwind`). When no `CSSProcessor` is registered, the
+ * compile path returns a no-op compiler that emits empty CSS and logs an
+ * actionable install message.
+ *
  * @module html/styles-builder/tailwind-compiler-cache
  */
-import { compile } from "tailwindcss";
-export declare function getCompiler(stylesheet: string, projectSlug?: string): Promise<Awaited<ReturnType<typeof compile>>>;
+import type { CSSCompiler } from "../../extensions/interfaces/index.js";
+export declare function getCompiler(stylesheet: string, projectSlug?: string): Promise<CSSCompiler>;
 export declare function invalidateCompiler(): void;
 /**
  * Get compiler cache statistics for monitoring.

package/esm/src/html/styles-builder/tailwind-compiler-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tailwind-compiler-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/tailwind-compiler-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AA2EtC,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAkD9C;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E,CAQA;AAED,wBAAgB,gBAAgB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAalD"}
+{"version":3,"file":"tailwind-compiler-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/html/styles-builder/tailwind-compiler-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,sCAAsC,CAAC;AA2EtF,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC,CAgEtB;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E,CAQA;AAED,wBAAgB,gBAAgB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAalD"}

package/esm/src/html/styles-builder/tailwind-compiler-cache.js

@@ -5,9 +5,15 @@
  * stylesheet hash. Prevents race conditions when concurrent requests use
  * different stylesheets.
  *
+ * The actual tailwindcss `compile()` call is routed through the
+ * `CSSProcessor` extension contract (default implementation:
+ * `@veryfront/ext-tailwind`). When no `CSSProcessor` is registered, the
+ * compile path returns a no-op compiler that emits empty CSS and logs an
+ * actionable install message.
+ *
  * @module html/styles-builder/tailwind-compiler-cache
  */
-import { compile } from "tailwindcss";
+import { tryResolve as tryResolveContract } from "../../extensions/contracts.js";
 import { serverLogger } from "../../utils/index.js";
 import { DEPENDENCY_MISSING, NETWORK_ERROR } from "../../errors/index.js";
 import { getTailwindCSSUrl } from "../../utils/constants/cdn.js";
@@ -73,10 +79,22 @@ export async function getCompiler(stylesheet, projectSlug) {
         return cached.compiler;
     }
     logger.debug("Creating new compiler", { hash, projectSlug });
+    const processor = tryResolveContract("CSSProcessor");
+    if (!processor) {
+        logger.warn("No CSSProcessor extension registered — CSS output will be empty. Install it with: deno add @veryfront/ext-tailwind");
+        const noopCompiler = { build: () => "" };
+        compilerCache.set(hash, {
+            compiler: noopCompiler,
+            createdAt: Date.now(),
+            pluginCache: new Map(),
+            pluginErrors: new Map(),
+        });
+        return noopCompiler;
+    }
     const tailwindBase = await getTailwindBaseCSS();
     const pluginCache = new Map();
     const pluginErrors = new Map();
-    const newCompiler = await compile(stylesheet, {
+    const newCompiler = await processor.compile(stylesheet, {
         base: "/",
         loadStylesheet: (id) => {
             if (id === "tailwindcss") {
@@ -92,7 +110,6 @@ export async function getCompiler(stylesheet, projectSlug) {
                     detail: `Failed to load plugin "${id}": plugin not installed`,
                 });
             }
-            // deno-lint-ignore no-explicit-any -- dynamically loaded plugin cannot be statically verified against Tailwind's Plugin | Config type
             return { module: loaded, base: "/", path: "/" };
         },
     });

package/esm/src/provider/model-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../../../src/src/provider/model-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAyBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAC;AAOrE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAEN;AAwID;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CASvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CA6D9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAGtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}
+{"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../../../src/src/provider/model-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAwBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAC;AAOrE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAEN;AAsJD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAWvD;AAMD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CA6D9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAGtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}

package/esm/src/provider/model-registry.js

@@ -14,6 +14,8 @@
  */
 import { createError, fromError, toError } from "../errors/veryfront-error.js";
 import { getAnthropicEnvConfig, getGoogleGenAIEnvConfig, getOpenAIEnvConfig, } from "../config/env.js";
+import { tryResolve } from "../extensions/contracts.js";
+import { AIProviderRegistryName } from "../extensions/interfaces/index.js";
 import { ProjectScopedRegistryManager } from "../registry/project-scoped-registry-manager.js";
 import { serverLogger } from "../utils/index.js";
 import { DEFAULT_LOCAL_MODEL } from "./local/model-catalog.js";
@@ -21,7 +23,7 @@ import { createLocalModel } from "./local/model-runtime-adapter.js";
 import { throwIfLocalAIDisabled } from "./local/env.js";
 import { verifyLocalRuntime } from "./local/local-engine.js";
 import { getDefaultVeryfrontCloudModel, isVeryfrontCloudEnabled, } from "../platform/cloud/resolver.js";
-import { createAnthropicModelRuntime, createGoogleModelRuntime, createOpenAIModelRuntime, } from "./runtime-loader.js";
+import { createGoogleModelRuntime } from "./runtime-loader.js";
 import { createVeryfrontCloudModel } from "./veryfront-cloud/provider.js";
 import { getModelRuntimeId, hasLocalModelRuntimeMarker } from "./runtime-inspection.js";
 const localLogger = serverLogger.component("local-llm");
@@ -64,7 +66,18 @@ function autoInitializeFromEnv() {
                     message: "OPENAI_API_KEY not set. Set the environment variable or register a custom provider with registerModelProvider().",
                 }));
             }
-            return createOpenAIModelRuntime({ apiKey: config.apiKey, baseURL: config.baseURL }, id);
+            const registry = tryResolve(AIProviderRegistryName);
+            const provider = registry?.get("openai");
+            if (provider) {
+                return provider.createModel(id, {
+                    credential: config.apiKey,
+                    baseURL: config.baseURL,
+                });
+            }
+            throw toError(createError({
+                type: "config",
+                message: "OpenAI provider not installed. Add @veryfront/ext-openai to use openai/* models.",
+            }));
         });
     }
     if (!manager.has("anthropic")) {
@@ -76,10 +89,18 @@ function autoInitializeFromEnv() {
                     message: "ANTHROPIC_API_KEY not set. Set the environment variable or register a custom provider with registerModelProvider().",
                 }));
             }
-            return createAnthropicModelRuntime({
-                apiKey: config.apiKey,
-                baseURL: config.baseURL,
-            }, id);
+            const registry = tryResolve(AIProviderRegistryName);
+            const provider = registry?.get("anthropic");
+            if (provider) {
+                return provider.createModel(id, {
+                    credential: config.apiKey,
+                    baseURL: config.baseURL,
+                });
+            }
+            throw toError(createError({
+                type: "config",
+                message: "Anthropic provider not installed. Add @veryfront/ext-anthropic to use anthropic/* models.",
+            }));
         });
     }
     if (!manager.has("google")) {
@@ -156,16 +177,22 @@ function isMissingProviderConfiguration(errorData) {
  */
 export function findAvailableCloudModel() {
     autoInitializeFromEnv();
+    const registry = tryResolve(AIProviderRegistryName);
     for (const { provider, model, hasKey } of CLOUD_UPGRADE_CANDIDATES) {
         if (!hasKey())
             continue;
         if (!manager.has(provider))
             continue;
+        if (registry && !registry.has(provider) && !isBuiltinProvider(provider))
+            continue;
         const resolvedModel = typeof model === "function" ? model() : model;
         return `${provider}/${resolvedModel}`;
     }
     return null;
 }
+function isBuiltinProvider(provider) {
+    return provider === "google" || provider === "veryfront-cloud";
+}
 /**
  * Resolve a "provider/model" string to a framework-compatible model runtime.
  *

package/esm/src/provider/runtime-loader/provider-embedding-responses.d.ts

@@ -1,3 +1,4 @@
+export declare function isNumberArray(value: unknown): value is number[];
 export declare function extractOpenAIEmbeddings(payload: unknown): number[][];
 export declare function extractOpenAIUsageTokens(payload: unknown): number | undefined;
 export declare function extractGoogleEmbedding(payload: unknown): number[];

package/esm/src/provider/runtime-loader/provider-embedding-responses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-embedding-responses.d.ts","sourceRoot":"","sources":["../../../../src/src/provider/runtime-loader/provider-embedding-responses.ts"],"names":[],"mappings":"AAMA,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,EAAE,CAmBpE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK7E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAmBjE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK7E"}
+{"version":3,"file":"provider-embedding-responses.d.ts","sourceRoot":"","sources":["../../../../src/src/provider/runtime-loader/provider-embedding-responses.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,CAE/D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,EAAE,CAmBpE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK7E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAmBjE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK7E"}

package/esm/src/provider/runtime-loader/provider-embedding-responses.js

@@ -1,5 +1,5 @@
 import { readRecord } from "./provider-records.js";
-function isNumberArray(value) {
+export function isNumberArray(value) {
     return Array.isArray(value) && value.every((entry) => typeof entry === "number");
 }
 export function extractOpenAIEmbeddings(payload) {

package/esm/src/provider/runtime-loader/provider-http.d.ts

@@ -30,6 +30,15 @@ export declare class ProviderQuotaError extends ProviderError {
 /** Non-retryable 4xx/5xx that doesn't fit another bucket. */
 export declare class ProviderRequestError extends ProviderError {
 }
+export declare function parseRetryAfterMs(header: string | null): number | undefined;
+/**
+ * Inspect a non-2xx response and build the most specific ProviderError
+ * subclass we can. Reads the response body as text (it's already dead
+ * on the wire by this point). Body classification handles the cases
+ * where HTTP status alone is ambiguous — notably OpenAI
+ * `insufficient_quota` vs `rate_limit_exceeded` both arriving as 429.
+ */
+export declare function buildProviderError(provider: ProviderKind, response: Response): Promise<ProviderError>;
 export declare function requestJson(options: {
     url: string;
     fetchImpl: typeof globalThis.fetch;

package/esm/src/provider/runtime-loader/provider-http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-http.d.ts","sourceRoot":"","sources":["../../../../src/src/provider/runtime-loader/provider-http.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7D;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE;QACnB,QAAQ,EAAE,YAAY,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;CAUF;AAED,4EAA4E;AAC5E,qBAAa,uBAAwB,SAAQ,aAAa;CAAG;AAE7D,mFAAmF;AACnF,qBAAa,sBAAuB,SAAQ,aAAa;CAAG;AAE5D,2DAA2D;AAC3D,qBAAa,kBAAmB,SAAQ,aAAa;CAAG;AAExD,6DAA6D;AAC7D,qBAAa,oBAAqB,SAAQ,aAAa;CAAG;AAyH1D,wBAAsB,WAAW,CAAC,OAAO,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;CAC5B,GAAG,OAAO,CAAC,OAAO,CAAC,CASnB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;CAC5B,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAkBtC"}
+{"version":3,"file":"provider-http.d.ts","sourceRoot":"","sources":["../../../../src/src/provider/runtime-loader/provider-http.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7D;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE;QACnB,QAAQ,EAAE,YAAY,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;CAUF;AAED,4EAA4E;AAC5E,qBAAa,uBAAwB,SAAQ,aAAa;CAAG;AAE7D,mFAAmF;AACnF,qBAAa,sBAAuB,SAAQ,aAAa;CAAG;AAE5D,2DAA2D;AAC3D,qBAAa,kBAAmB,SAAQ,aAAa;CAAG;AAExD,6DAA6D;AAC7D,qBAAa,oBAAqB,SAAQ,aAAa;CAAG;AAE1D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAY3E;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,aAAa,CAAC,CA6FxB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;CAC5B,GAAG,OAAO,CAAC,OAAO,CAAC,CASnB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;CAC5B,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAkBtC"}

package/esm/src/provider/runtime-loader/provider-http.js

@@ -33,7 +33,7 @@ export class ProviderQuotaError extends ProviderError {
 /** Non-retryable 4xx/5xx that doesn't fit another bucket. */
 export class ProviderRequestError extends ProviderError {
 }
-function parseRetryAfterMs(header) {
+export function parseRetryAfterMs(header) {
     if (!header)
         return undefined;
     const asNumber = Number(header);
@@ -54,7 +54,7 @@ function parseRetryAfterMs(header) {
  * where HTTP status alone is ambiguous — notably OpenAI
  * `insufficient_quota` vs `rate_limit_exceeded` both arriving as 429.
  */
-async function buildProviderError(provider, response) {
+export async function buildProviderError(provider, response) {
     const rawBody = await response.text();
     const message = rawBody.trim() || `${response.status} ${response.statusText}`.trim();
     const status = response.status;