@hops-ops/distributed 4.8.0 → 4.10.0

package/dist/sveltekit/vite.d.ts

@@ -1,3 +1,5 @@
+import { type DistributedSvelteKitBoundaryRegistration } from './islands/boundaries.js';
+export { analyzeDistributedSvelteKitBoundaries, validateDistributedSvelteKitBoundaryPlan, type DistributedIslandInventory, type DistributedIslandPlanInput, type DistributedSvelteKitBoundary, type DistributedSvelteKitBoundaryAnalysisClient, type DistributedSvelteKitBoundaryAnalysisOptions, type DistributedSvelteKitBoundaryOccurrence, type DistributedSvelteKitBoundaryPlan, type DistributedSvelteKitBoundaryRegistration } from './islands/boundaries.js';
 export type DistributedGraphqlProxyOptions = {
     /** Absolute Distributed API origin, for example `http://127.0.0.1:8791`. */
     target: string;
@@ -28,8 +30,8 @@ export type DistributedSvelteKitClientCompiler = Readonly<{
     surface?: string;
     /** GraphQL globs passed verbatim as repeated `distributed client --documents`. */
     documents: readonly string[];
-    /** Explicit `OPERATION=/route` fallbacks. */
-    routes?: readonly string[];
+    /** Typed fallback when static component ownership cannot be proven. */
+    boundaries?: readonly DistributedSvelteKitBoundaryRegistration[];
     /** Compiler-owned artifact directory, relative to `cwd` by default. */
     out: string;
 }>;
@@ -40,6 +42,12 @@ export type DistributedSvelteKitViteOptions = Readonly<{
     command?: string;
     /** Prefix argv, e.g. `cargo run ... --`; never interpreted by a shell. */
     commandArgs?: readonly string[];
+    /** SvelteKit route source root. Defaults to `src/routes`. */
+    routesDir?: string;
+    /** SvelteKit library source root. Defaults to `src/lib`. */
+    libDir?: string;
+    /** Additional project-local `$name` aliases used by static component imports. */
+    aliases?: Readonly<Record<string, string>>;
     clients: readonly DistributedSvelteKitClientCompiler[];
 }>;
 type ViteWebSocketLike = Readonly<{
@@ -49,12 +57,26 @@ type ViteModuleGraphLike = Readonly<{
     getModuleById(id: string): unknown;
     invalidateModule(module: unknown): void;
 }>;
+type ViteMiddlewareRequest = Readonly<{
+    method?: string;
+    headers: Readonly<Record<string, string | readonly string[] | undefined>>;
+    on(event: 'data', listener: (chunk: Uint8Array) => void): void;
+    on(event: 'end' | 'error', listener: (value?: unknown) => void): void;
+}>;
+type ViteMiddlewareResponse = {
+    statusCode: number;
+    setHeader(name: string, value: string): void;
+    end(body?: string | Uint8Array): void;
+};
 type ViteServerLike = Readonly<{
     watcher: Readonly<{
         add(paths: string | readonly string[]): void;
     }>;
     ws: ViteWebSocketLike;
     moduleGraph: ViteModuleGraphLike;
+    middlewares?: Readonly<{
+        use(path: string, handler: (request: ViteMiddlewareRequest, response: ViteMiddlewareResponse) => void): void;
+    }>;
     httpServer?: Readonly<{
         once(event: 'close', listener: () => void): void;
     }> | null;
@@ -62,6 +84,7 @@ type ViteServerLike = Readonly<{
 type ViteHotContextLike = Readonly<{
     file: string;
     server: ViteServerLike;
+    modules?: readonly unknown[];
 }>;
 type RollupWatchContextLike = Readonly<{
     addWatchFile(path: string): void;
@@ -77,10 +100,31 @@ export type DistributedSvelteKitVitePlugin = Readonly<{
     buildStart(this: RollupWatchContextLike): void;
     resolveId(source: string): string | undefined;
     load(id: string): string | undefined;
+    transformIndexHtml(): LifecycleHtmlTag[];
     handleHotUpdate(context: ViteHotContextLike): Promise<never[] | undefined>;
     watchChange(id: string): Promise<void>;
     closeBundle(): Promise<void>;
 }>;
+export type DistributedLifecycleVitePlugin = Readonly<{
+    name: string;
+    enforce: 'pre';
+    configResolved(config: Readonly<{
+        root: string;
+    }>): void;
+    configureServer(server: ViteServerLike): void;
+    transformIndexHtml(): LifecycleHtmlTag[];
+    handleHotUpdate(context: ViteHotContextLike): never[] | undefined;
+}>;
+type LifecycleHtmlTag = Readonly<{
+    tag: 'meta';
+    attrs: Readonly<{
+        name: string;
+        content: string;
+    }>;
+    injectTo: 'head-prepend';
+}>;
+/** Lifecycle-only side channel for projects using committed generated clients. */
+export declare function distributedLifecycle(): DistributedLifecycleVitePlugin;
 /** Generate every configured surface through the same transaction used by Vite. */
 export declare function generateDistributedSvelteKit(options: DistributedSvelteKitViteOptions): Promise<void>;
 /** Check every configured surface through canonical `distributed client --check`; never write. */
@@ -100,4 +144,3 @@ export declare function distributedSvelteKit(options: DistributedSvelteKitViteOp
  * generation and is safe to call from `svelte.config.js`.
  */
 export declare function distributedSvelteKitAliases(options: Pick<DistributedSvelteKitViteOptions, 'cwd' | 'clients'>): Readonly<Record<string, string>>;
-export {};