veryfront 0.1.810 → 0.1.812

package/esm/src/rendering/orchestrator/pipeline.js

@@ -35,6 +35,7 @@ import { getCSSByHashAsync, regenerateCSSByHash, } from "../../html/styles-build
 import { getReadyManifestForRender } from "../../release-assets/manifest-cache.js";
 import { createEsmCache, createModuleCache, loadModule } from "./module-loader/index.js";
 import { getCSSImports, runWithCSSCollector, } from "../../modules/react-loader/css-import-collector.js";
+import { assembleRenderResult } from "./render-result-assembly.js";
 // Extracted modules
 import { EMPTY_LAYOUT_RESULT, isDotPath } from "./path-helpers.js";
 import { cachePageCss, CSS_SSR_TIMEOUT_MS, getCachedPageCss, getPageCssCacheKey, } from "./css-cache.js";
@@ -342,31 +343,18 @@ export class RenderPipeline {
                             paths: collectedCSSImports.map((p) => p.split("/").pop()),
                         });
                     }
-                    const pageModule = pageBundleResult.clientModuleCode && pageBundleResult.pageModuleType
-                        ? {
-                            slug,
-                            code: pageBundleResult.clientModuleCode,
-                            type: pageBundleResult.pageModuleType,
-                        }
-                        : undefined;
-                    const result = {
-                        html: ssrResult.fullHtml,
-                        frontmatter: pageBundleResult.pageBundle.frontmatter || {},
-                        headings: pageBundleResult.pageBundle.headings || [],
-                        nodeMap: pageBundleResult.pageBundle.nodeMap,
-                        stream: ssrResult.finalStream,
-                        ssrHash: ssrResult.ssrHash,
-                        ...(pageModule ? { pageModule } : {}),
-                    };
-                    if (shouldCache && !options?.skipCachePersist) {
-                        void this.config.cacheCoordinator.persistResult(result, slug, cacheKey).catch((error) => {
-                            renderPipelineLog.error("Cache persist failed", {
-                                slug,
-                                error: error instanceof Error ? error.message : String(error),
-                                stack: error instanceof Error ? error.stack : undefined,
-                            });
-                        });
-                    }
+                    const result = assembleRenderResult({
+                        slug,
+                        cacheKey,
+                        ssrResult,
+                        pageBundle: pageBundleResult.pageBundle,
+                        clientModuleCode: pageBundleResult.clientModuleCode,
+                        pageModuleType: pageBundleResult.pageModuleType,
+                        shouldCache,
+                        skipCachePersist: options?.skipCachePersist,
+                        cacheCoordinator: this.config.cacheCoordinator,
+                        logger: renderPipelineLog,
+                    });
                     timing.total = Math.round(performance.now() - pipelineStartTime);
                     renderPipelineLog.debug("Complete", { slug, timing });
                     return result;

package/esm/src/rendering/orchestrator/render-result-assembly.d.ts

@@ -0,0 +1,27 @@
+import type { PageBundle, RenderResult } from "../../types/index.js";
+interface RenderResultAssemblyCache {
+    persistResult(result: RenderResult, slug: string, cacheKey?: string): Promise<void>;
+}
+interface RenderResultAssemblyLogger {
+    error(message: string, metadata?: Record<string, unknown>): void;
+}
+interface SSRResult {
+    fullHtml: string;
+    finalStream?: ReadableStream | null;
+    ssrHash?: string;
+}
+export interface AssembleRenderResultOptions {
+    slug: string;
+    cacheKey?: string | null;
+    ssrResult: SSRResult;
+    pageBundle: PageBundle;
+    clientModuleCode?: string;
+    pageModuleType?: "mdx" | "component";
+    shouldCache: boolean;
+    skipCachePersist?: boolean;
+    cacheCoordinator?: RenderResultAssemblyCache;
+    logger?: RenderResultAssemblyLogger;
+}
+export declare function assembleRenderResult(options: AssembleRenderResultOptions): RenderResult;
+export {};
+//# sourceMappingURL=render-result-assembly.d.ts.map

package/esm/src/rendering/orchestrator/render-result-assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-result-assembly.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/render-result-assembly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAErE,UAAU,yBAAyB;IACjC,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF;AAED,UAAU,0BAA0B;IAClC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAClE;AAED,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,YAAY,CAoCvF"}

package/esm/src/rendering/orchestrator/render-result-assembly.js

@@ -0,0 +1,28 @@
+export function assembleRenderResult(options) {
+    const pageModule = options.clientModuleCode && options.pageModuleType
+        ? {
+            slug: options.slug,
+            code: options.clientModuleCode,
+            type: options.pageModuleType,
+        }
+        : undefined;
+    const result = {
+        html: options.ssrResult.fullHtml,
+        frontmatter: options.pageBundle.frontmatter || {},
+        headings: options.pageBundle.headings || [],
+        nodeMap: options.pageBundle.nodeMap,
+        stream: options.ssrResult.finalStream,
+        ssrHash: options.ssrResult.ssrHash,
+        ...(pageModule ? { pageModule } : {}),
+    };
+    if (options.shouldCache && !options.skipCachePersist) {
+        void options.cacheCoordinator?.persistResult(result, options.slug, options.cacheKey ?? undefined).catch((error) => {
+            options.logger?.error("Cache persist failed", {
+                slug: options.slug,
+                error: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+        });
+    }
+    return result;
+}

package/esm/src/rendering/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/src/rendering/renderer.ts"],"names":[],"mappings":"AA6CA,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AAgBzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAwBxD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,oBAAoB;IACpB,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC;AAeD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,oBAAoB,CAAgC;IAC5D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAA8B;IAE3D;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAwC;gBAEhD,OAAO,GAAE,eAAoB;IAInC,UAAU,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YAwF9E,2BAA2B;IAWzC,OAAO,CAAC,uBAAuB;IAiB/B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;YAwBP,YAAY;IAoF1B,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,gBAAgB,CAAC;IAkB5B,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAU5C,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5D,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,OAAO,CAAC,wBAAwB;CA0FjC;AAED,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,aAAa,GACnB,CAAC;AAMF,wBAAgB,WAAW,IAAI,QAAQ,CAOtC;AAED,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsBrF;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAQrD;AAED,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYnF;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,cAAc,EAC1B,OAAO,CAAC,EAAE,aAAa,EACvB,cAAc,CAAC,EAAE,0BAA0B,GAC1C,OAAO,CAAC,YAAY,CAAC,CAIvB"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../src/src/rendering/renderer.ts"],"names":[],"mappings":"AA6CA,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AAgBzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAwBxD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,oBAAoB;IACpB,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC;AAeD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,oBAAoB,CAAgC;IAC5D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,qBAAqB,CAA8B;IAE3D;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAwC;gBAEhD,OAAO,GAAE,eAAoB;IAInC,UAAU,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YAwF9E,2BAA2B;IAWzC,OAAO,CAAC,uBAAuB;IAiB/B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;YAwBP,YAAY;IAoF1B,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,gBAAgB,CAAC;IAkB5B,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAU5C,UAAU,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5D,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,OAAO,CAAC,wBAAwB;CA4FjC;AAED,OAAO,EACL,mBAAmB,EACnB,+BAA+B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,aAAa,GACnB,CAAC;AAMF,wBAAgB,WAAW,IAAI,QAAQ,CAOtC;AAED,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsBrF;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAQrD;AAED,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYnF;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,cAAc,EAC1B,OAAO,CAAC,EAAE,aAAa,EACvB,cAAc,CAAC,EAAE,0BAA0B,GAC1C,OAAO,CAAC,YAAY,CAAC,CAIvB"}

package/esm/src/rendering/renderer.js

@@ -130,7 +130,7 @@ export class Renderer {
             const cacheKey = this.buildCacheKey(slug, effectiveCtx, effectiveOptions);
             const cacheResult = cacheKey
                 ? await this.cache.checkCache(slug, effectiveCtx, effectiveOptions?.colorScheme, cacheKey)
-                : { hit: false, cacheKey: "" };
+                : { hit: false, cacheKey: "", status: "miss", lookupDurationMs: 0 };
             if (cacheResult.hit && cacheResult.cachedResult) {
                 logger.debug("Cache hit", {
                     slug,
@@ -398,6 +398,8 @@ export class Renderer {
                     depAwareSlug: slug,
                     moduleCacheKey: cacheKey ?? slug,
                     cachedModule: result.cachedResult?.pageModule,
+                    cacheStatus: result.status,
+                    lookupDurationMs: result.lookupDurationMs,
                 };
             },
             persistResult: async (result, slug, cacheKey) => {

package/esm/src/rendering/shared/context-aware-cache.d.ts

@@ -1,5 +1,6 @@
 import type { RenderResult } from "../orchestrator/types.js";
 import type { CacheStore } from "../cache/types.js";
+import type { CacheLookupStatus } from "../cache/cache-coordinator.js";
 import { type MemoryCacheStoreOptions } from "../cache/stores/index.js";
 import type { RenderContext } from "../context/render-context.js";
 export interface ContextAwareCacheOptions {
@@ -11,6 +12,8 @@ export interface ContextAwareCacheLookupResult {
     cachedResult?: RenderResult;
     cacheKey: string;
     hit: boolean;
+    status: CacheLookupStatus;
+    lookupDurationMs: number;
 }
 export declare class ContextAwareCacheCoordinator {
     private store;

package/esm/src/rendering/shared/context-aware-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-aware-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/shared/context-aware-cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAUlE,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD,MAAM,WAAW,6BAA6B;IAC5C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,qBAAa,4BAA4B;IACvC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;gBAEzC,OAAO,GAAE,wBAA6B;IASlD,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,6BAA6B,CAAC;IAqDnC,aAAa,CACjB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC;IAqBV,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BlD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAO5B,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;CAkCpB"}
+{"version":3,"file":"context-aware-cache.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/shared/context-aware-cache.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAUlE,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD,MAAM,WAAW,6BAA6B;IAC5C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,4BAA4B;IACvC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;gBAEzC,OAAO,GAAE,wBAA6B;IAUlD,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,6BAA6B,CAAC;IAiEnC,aAAa,CACjB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC;IAqBV,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BlD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAO5B,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;CAkCpB"}

package/esm/src/rendering/shared/context-aware-cache.js

@@ -1,4 +1,6 @@
 import { rendererLogger } from "../../utils/index.js";
+import { markRequestProfilePhase } from "../../observability/request-profiler.js";
+import { metrics } from "../../observability/simple-metrics/index.js";
 import { withSpan } from "../../observability/tracing/otlp-setup.js";
 import { SpanNames } from "../../observability/tracing/span-names.js";
 import { MemoryCacheStore } from "../cache/stores/index.js";
@@ -18,40 +20,53 @@ export class ContextAwareCacheCoordinator {
             new MemoryCacheStore({
                 maxEntries: options.memory?.maxEntries ?? DEFAULT_MAX_ENTRIES,
                 ttlMs: options.memory?.ttlMs ?? this.ttlMs,
+                enforceStoreTtl: false,
             });
     }
     checkCache(slug, ctx, colorScheme, cacheKeyOverride) {
         const cacheKey = this.getCacheKey(slug, ctx, colorScheme, cacheKeyOverride);
         return withSpan(SpanNames.CACHE_CHECK_SPECULATIVE, async () => {
+            const lookupStart = performance.now();
             const cached = (await this.store.get(cacheKey));
             if (!cached) {
+                const lookupDurationMs = roundDurationMs(performance.now() - lookupStart);
+                recordCacheLookup("miss", lookupDurationMs);
                 logger.debug("Cache miss", {
                     slug,
                     cacheKey,
                     projectId: ctx.projectId,
                     environment: ctx.environment,
+                    lookupDurationMs,
                 });
-                return { cacheKey, hit: false };
+                return { cacheKey, hit: false, status: "miss", lookupDurationMs };
             }
             if (this.isExpired(cached)) {
                 await this.store.delete(cacheKey);
+                const lookupDurationMs = roundDurationMs(performance.now() - lookupStart);
+                recordCacheLookup("expired", lookupDurationMs);
                 logger.debug("Cache expired", {
                     slug,
                     cacheKey,
                     projectId: ctx.projectId,
                     environment: ctx.environment,
+                    lookupDurationMs,
                 });
-                return { cacheKey, hit: false };
+                return { cacheKey, hit: false, status: "expired", lookupDurationMs };
             }
+            const lookupDurationMs = roundDurationMs(performance.now() - lookupStart);
+            recordCacheLookup("hit", lookupDurationMs);
             logger.debug("Cache hit", {
                 slug,
                 projectId: ctx.projectId,
                 environment: ctx.environment,
+                lookupDurationMs,
             });
             return {
                 cachedResult: this.cloneResult(cached.result, cached.nodeMapEntries),
                 cacheKey,
                 hit: true,
+                status: "hit",
+                lookupDurationMs,
             };
         }, {
             "cache.key": cacheKey,
@@ -195,3 +210,11 @@ export class ContextAwareCacheCoordinator {
         return cloned;
     }
 }
+function roundDurationMs(value) {
+    return Math.round(value * 100) / 100;
+}
+function recordCacheLookup(status, durationMs) {
+    markRequestProfilePhase("render.cache_lookup", durationMs);
+    markRequestProfilePhase(`render.cache_${status}`);
+    metrics.recordCacheGet(status === "hit");
+}

package/esm/src/server/dev-server/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/src/server/dev-server/server.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAmCvD,4BAA4B;AAC5B,qBAAa,SAAS;IAiBR,OAAO,CAAC,OAAO;IAhB3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,CAAsC;IACvD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,qBAAqB,CAAC,CAAa;IAC3C,OAAO,CAAC,8BAA8B,CAAC,CAAa;gBAEhC,OAAO,EAAE,gBAAgB;IAQ7C,OAAO,CAAC,OAAO;YAID,YAAY;IAWpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgL5B,qEAAqE;IACrE,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAKjD;IAED,OAAO,CAAC,oBAAoB;YAkBd,qBAAqB;YAkBrB,yBAAyB;YAoBzB,uBAAuB;YA4BvB,wBAAwB;IAmBtC,OAAO,CAAC,kBAAkB;IAuBpB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;YAe7B,iBAAiB;IAsC/B,qBAAqB,IAAI,UAAU,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI;IAIlE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA6B5B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/src/server/dev-server/server.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAmCvD,4BAA4B;AAC5B,qBAAa,SAAS;IAiBR,OAAO,CAAC,OAAO;IAhB3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,CAAsC;IACvD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,qBAAqB,CAAC,CAAa;IAC3C,OAAO,CAAC,8BAA8B,CAAC,CAAa;gBAEhC,OAAO,EAAE,gBAAgB;IAQ7C,OAAO,CAAC,OAAO;YAID,YAAY;IAWpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgL5B,qEAAqE;IACrE,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAKjD;IAED,OAAO,CAAC,oBAAoB;YAmBd,qBAAqB;YAoBrB,yBAAyB;YAoBzB,uBAAuB;YA4BvB,wBAAwB;IAmBtC,OAAO,CAAC,kBAAkB;IAuBpB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;YAe7B,iBAAiB;IAsC/B,qBAAqB,IAAI,UAAU,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI;IAIlE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA6B5B"}

package/esm/src/server/dev-server/server.js

@@ -227,6 +227,7 @@ export class DevServer {
             resourceDirs: ["resources"],
             promptDirs: ["prompts"],
             workflowDirs: ["workflows"],
+            workDirs: ["work"],
             fsAdapter: this.adapter.fs,
             verbose: this.isDebug(),
         };
@@ -236,10 +237,12 @@ export class DevServer {
             const config = this.buildDiscoveryConfig();
             const result = await discoverAll(config);
             const total = result.tools.size + result.agents.size + result.skills.size +
-                result.workflows.size + result.prompts.size + result.resources.size;
+                result.workflows.size + result.works.size + result.prompts.size +
+                result.resources.size;
             if (total > 0) {
                 logger.debug(`[Discovery] Registered ${result.tools.size} tools, ${result.agents.size} agents, ` +
                     `${result.skills.size} skills, ${result.workflows.size} workflows, ` +
+                    `${result.works.size} Work definitions, ` +
                     `${result.prompts.size} prompts, ${result.resources.size} resources`);
             }
         }

package/esm/src/server/handlers/dev/dashboard/api.d.ts

@@ -1,3 +1,6 @@
 import type { HandlerContext } from "../../types.js";
+type DashboardApiMethod = "GET" | "POST";
+export declare function getDashboardApiRoutePaths(method: DashboardApiMethod): string[];
 export declare function handleDashboardAPI(req: Request, ctx: HandlerContext): Promise<Response | null> | Response | null;
+export {};
 //# sourceMappingURL=api.d.ts.map

package/esm/src/server/handlers/dev/dashboard/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/dev/dashboard/api.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA4CrD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,QAAQ,GAAG,IAAI,CAgE5C"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/dev/dashboard/api.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA4CrD,KAAK,kBAAkB,GAAG,KAAK,GAAG,MAAM,CAAC;AA2CzC,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAG9E;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,QAAQ,GAAG,IAAI,CAQ5C"}

package/esm/src/server/handlers/dev/dashboard/api.js

@@ -59,67 +59,51 @@ const TEXT_EXTENSIONS = new Set([
     "gitignore",
     "dockerignore",
 ]);
+const GET_DASHBOARD_API_ROUTES = {
+    "/_dev/api/stats": () => handleStats(),
+    "/_dev/api/tools": () => handleListTools(),
+    "/_dev/api/resources": () => handleListResources(),
+    "/_dev/api/prompts": () => handleListPrompts(),
+    "/_dev/api/agents": () => handleListAgents(),
+    "/_dev/api/workflows": () => handleListWorkflows(),
+    "/_dev/api/handlers": (_req, ctx) => handleListHandlers(ctx),
+    "/_dev/api/metrics": () => handleGetMetrics(),
+    "/_dev/api/files": (req, ctx) => handleListFiles(req, ctx),
+    "/_dev/api/file-content": (req, ctx) => handleReadFileContent(req, ctx),
+    "/_dev/api/infrastructure": () => handleGetInfrastructure(),
+    "/_dev/api/memory": () => handleGetMemory(),
+    "/_dev/api/build": () => handleGetBuild(),
+    "/_dev/api/errors": () => handleGetErrors(),
+    "/_dev/api/config": (_req, ctx) => handleGetConfig(ctx),
+    "/_dev/api/live-errors": (req) => handleLiveErrors(req),
+    "/_dev/api/live-logs": (req) => handleLiveLogs(req),
+};
+const POST_DASHBOARD_API_ROUTES = {
+    "/_dev/api/hmr-trigger": (req) => handleHmrTrigger(req),
+    "/_dev/api/execute-tool": (req) => handleExecuteTool(req),
+    "/_dev/api/read-resource": (req) => handleReadResource(req),
+    "/_dev/api/render-prompt": (req) => handleRenderPrompt(req),
+    "/_dev/api/start-workflow": (req) => handleStartWorkflow(req),
+};
+function getDashboardRouteHandler(method, pathname) {
+    if (method === "GET")
+        return GET_DASHBOARD_API_ROUTES[pathname];
+    if (method === "POST")
+        return POST_DASHBOARD_API_ROUTES[pathname];
+    return undefined;
+}
+export function getDashboardApiRoutePaths(method) {
+    const routes = method === "GET" ? GET_DASHBOARD_API_ROUTES : POST_DASHBOARD_API_ROUTES;
+    return Object.keys(routes).sort();
+}
 export function handleDashboardAPI(req, ctx) {
     if (!ctx.isLocalProject)
         return errorResponse("Unauthorized", 401);
     const { pathname } = new URL(req.url);
-    if (req.method === "GET") {
-        switch (pathname) {
-            case "/_dev/api/stats":
-                return handleStats();
-            case "/_dev/api/tools":
-                return handleListTools();
-            case "/_dev/api/resources":
-                return handleListResources();
-            case "/_dev/api/prompts":
-                return handleListPrompts();
-            case "/_dev/api/agents":
-                return handleListAgents();
-            case "/_dev/api/workflows":
-                return handleListWorkflows();
-            case "/_dev/api/handlers":
-                return handleListHandlers(ctx);
-            case "/_dev/api/metrics":
-                return handleGetMetrics();
-            case "/_dev/api/files":
-                return handleListFiles(req, ctx);
-            case "/_dev/api/file-content":
-                return handleReadFileContent(req, ctx);
-            case "/_dev/api/infrastructure":
-                return handleGetInfrastructure();
-            case "/_dev/api/memory":
-                return handleGetMemory();
-            case "/_dev/api/build":
-                return handleGetBuild();
-            case "/_dev/api/errors":
-                return handleGetErrors();
-            case "/_dev/api/config":
-                return handleGetConfig(ctx);
-            case "/_dev/api/live-errors":
-                return handleLiveErrors(req);
-            case "/_dev/api/live-logs":
-                return handleLiveLogs(req);
-            default:
-                return null;
-        }
-    }
-    if (req.method === "POST") {
-        switch (pathname) {
-            case "/_dev/api/hmr-trigger":
-                return handleHmrTrigger(req);
-            case "/_dev/api/execute-tool":
-                return handleExecuteTool(req);
-            case "/_dev/api/read-resource":
-                return handleReadResource(req);
-            case "/_dev/api/render-prompt":
-                return handleRenderPrompt(req);
-            case "/_dev/api/start-workflow":
-                return handleStartWorkflow(req);
-            default:
-                return null;
-        }
-    }
-    return null;
+    const handler = getDashboardRouteHandler(req.method, pathname);
+    if (!handler)
+        return null;
+    return handler(req, ctx);
 }
 function handleStats() {
     const mcpStats = getMCPStats();

package/esm/src/server/handlers/dev/framework-candidates.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-candidates.generated.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/framework-candidates.generated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAisLjD,CAAC"}
+{"version":3,"file":"framework-candidates.generated.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/framework-candidates.generated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EA2sLjD,CAAC"}

package/esm/src/server/handlers/dev/framework-candidates.generated.js

@@ -2085,10 +2085,12 @@ export const FRAMEWORK_CANDIDATES = [
     "aria-expanded={attachmentMenuOpen}",
     "aria-expanded={open}",
     "aria-haspopup=",
+    "aria-label",
     "aria-label=",
     "aria-label={",
     "aria-label={ariaLabel}",
     "aria-label={copied",
+    "aria-label={inputLabel}",
     "aria-label={isDark",
     "aria-label={provider",
     "aria-label={sidebarOpen",
@@ -2142,6 +2144,7 @@ export const FRAMEWORK_CANDIDATES = [
     "assertEquals(selectCalls,",
     "assertEquals(submitButton.className.includes(",
     "assertEquals(submitCalls,",
+    "assertEquals(textarea.getAttribute(",
     "assertEquals(theme.messageVariants({",
     "assertEquals(third.type,",
     "assertEquals,",
@@ -2155,6 +2158,7 @@ export const FRAMEWORK_CANDIDATES = [
     "assistant",
     "assistant:",
     "assistant?:",
+    "assistive",
     "async",
     "at",
     "attachAccept",
@@ -3487,6 +3491,8 @@ export const FRAMEWORK_CANDIDATES = [
     "input?.script",
     "input?.skillId",
     "input?:",
+    "inputLabel",
+    "inputPlaceholder",
     "inputRef",
     "inputRef.current?.focus();",
     "input}",
@@ -3643,6 +3649,7 @@ export const FRAMEWORK_CANDIDATES = [
     "label.",
     "label:",
     "label?:",
+    "labels",
     "label}",
     "language",
     "language,",
@@ -4448,7 +4455,9 @@ export const FRAMEWORK_CANDIDATES = [
     "placeholder",
     "placeholder,",
     "placeholder:text-[var(--input-placeholder)]",
-    "placeholder={isListening",
+    "placeholder;",
+    "placeholder=",
+    "placeholder={inputPlaceholder}",
     "placeholder={voice.isListening",
     "placeholder?:",
     "placeholder}",
@@ -5273,6 +5282,7 @@ export const FRAMEWORK_CANDIDATES = [
     "tc2",
     "td",
     "td>",
+    "technology",
     "text",
     "text)",
     "text);",

package/esm/src/transforms/esm/specifier-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"specifier-resolver.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/specifier-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,KAAK,YAAY,EAOlB,MAAM,yBAAyB,CAAC;AAEjC,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAuD/F;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,iBAAiB,GACjC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiB9B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,iBAAiB,GACjC,OAAO,CAAC,MAAM,CAAC,CAKjB"}
+{"version":3,"file":"specifier-resolver.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/specifier-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EACL,KAAK,YAAY,EAOlB,MAAM,yBAAyB,CAAC;AAEjC,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAoE/F;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,iBAAiB,GACjC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiB9B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EACrB,eAAe,EAAE,iBAAiB,GACjC,OAAO,CAAC,MAAM,CAAC,CAKjB"}

package/esm/src/transforms/esm/specifier-resolver.js

@@ -7,8 +7,14 @@
  * @module transforms/esm/specifier-resolver
  */
 import { basename } from "../../platform/compat/path/index.js";
+import { resolveImport } from "../../modules/import-map/resolver.js";
 import { parseImports, replaceSpecifiers } from "./lexer.js";
 import { isExternalScheme, isHttpUrl, isInternalBare, isParentHttpModule, isRelative, resolveBareSpecifier, } from "./http-cache-helpers.js";
+function isLocalMappedSpecifier(specifier) {
+    return specifier.startsWith("/_vf_modules/") ||
+        specifier.startsWith("_vf_modules/") ||
+        specifier.startsWith("file://");
+}
 /**
  * Resolve a single import specifier to a local cached path.
  *
@@ -29,6 +35,12 @@ async function resolveSpecifier(specifier, baseUrl, options, cacheHttpModule) {
         return `file://${cached}`;
     }
     if (isHttpUrl(specifier)) {
+        const mapped = resolveImport(specifier, options.importMap);
+        if (mapped !== specifier) {
+            if (isLocalMappedSpecifier(mapped))
+                return mapped;
+            return resolveSpecifier(mapped, baseUrl, options, cacheHttpModule);
+        }
         const cached = await cacheHttpModule(specifier, options);
         if (!cached)
             return null;
@@ -51,6 +63,8 @@ async function resolveSpecifier(specifier, baseUrl, options, cacheHttpModule) {
     const mapped = resolveBareSpecifier(specifier, options.importMap, options.reactVersion);
     if (mapped === specifier)
         return null;
+    if (isLocalMappedSpecifier(mapped))
+        return mapped;
     return resolveSpecifier(mapped, baseUrl, options, cacheHttpModule);
 }
 /**

package/esm/src/utils/version-constant.d.ts

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.810";
+export declare const VERSION = "0.1.812";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.810";
+export const VERSION = "0.1.812";

package/esm/src/work/factory.d.ts

@@ -0,0 +1,4 @@
+import type { WorkConfig, WorkDefinition } from "./types.js";
+/** Create a typed Work definition. */
+export declare function work(config: WorkConfig): WorkDefinition;
+//# sourceMappingURL=factory.d.ts.map

package/esm/src/work/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/src/work/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGtF,sCAAsC;AACtC,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CA0CvD"}

package/esm/src/work/factory.js

@@ -0,0 +1,51 @@
+import { createError, toError } from "../errors/veryfront-error.js";
+/** Create a typed Work definition. */
+export function work(config) {
+    const id = assertWorkId(config.id);
+    const outcome = assertNonEmptyString(config.outcome, `Work "${id}" outcome`);
+    if (!Array.isArray(config.acceptanceCriteria) || config.acceptanceCriteria.length === 0) {
+        throwWorkConfigError(`Work "${id}" must define at least one acceptance criterion.`);
+    }
+    const seenCriterionIds = new Set();
+    const acceptanceCriteria = config.acceptanceCriteria.map((criterion, index) => {
+        const criterionId = assertNonEmptyString(criterion.id, `Work "${id}" acceptance criterion at index ${index} id`);
+        if (seenCriterionIds.has(criterionId)) {
+            throwWorkConfigError(`Work "${id}" has duplicate acceptance criterion id "${criterionId}".`);
+        }
+        seenCriterionIds.add(criterionId);
+        const description = assertNonEmptyString(criterion.description, `Work "${id}" acceptance criterion "${criterionId}" description`);
+        const normalizedCriterion = {
+            id: criterionId,
+            description,
+        };
+        if (criterion.optional === true) {
+            normalizedCriterion.optional = true;
+        }
+        return normalizedCriterion;
+    });
+    return {
+        id,
+        name: config.name?.trim() || id,
+        outcome,
+        acceptanceCriteria,
+    };
+}
+function assertWorkId(value) {
+    const id = assertNonEmptyString(value, "Work id");
+    if (!/^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(id)) {
+        throwWorkConfigError("Work id must be a path-safe single segment using letters, numbers, underscores, or hyphens.");
+    }
+    return id;
+}
+function assertNonEmptyString(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throwWorkConfigError(`${label} cannot be empty.`);
+    }
+    return value.trim();
+}
+function throwWorkConfigError(message) {
+    throw toError(createError({
+        type: "agent",
+        message,
+    }));
+}

package/esm/src/work/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Declare source-backed Work definitions for business process observability.
+ *
+ * @module work
+ *
+ * @example
+ * ```ts
+ * import { work } from "veryfront/work";
+ *
+ * export default work({
+ *   id: "supplier-invoice-processing",
+ *   name: "Supplier invoice processing",
+ *   outcome: "Resolve all open supplier invoices.",
+ *   acceptanceCriteria: [
+ *     {
+ *       id: "invoices_discovered",
+ *       description: "Open supplier invoices have been discovered.",
+ *     },
+ *   ],
+ * });
+ * ```
+ */
+import "../../_dnt.polyfills.js";
+export type { WorkAcceptanceCriterion, WorkConfig, WorkDefinition, WorkReference, } from "./types.js";
+export { work } from "./factory.js";
+export { workRegistry } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/src/work/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/work/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,yBAAyB,CAAC;AAGjC,YAAY,EACV,uBAAuB,EACvB,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}