@stream-mdx/react 0.4.0 → 0.5.0

package/dist/renderer/patch-commit-scheduler.cjs

@@ -24,6 +24,7 @@ __export(patch_commit_scheduler_exports, {
   PatchCommitScheduler: () => PatchCommitScheduler
 });
 module.exports = __toCommonJS(patch_commit_scheduler_exports);
+var import_patch_batching = require("@stream-mdx/core/perf/patch-batching");
 
 // src/renderer/patch-coalescing.ts
 var import_core = require("@stream-mdx/core");
@@ -35,6 +36,9 @@ var COALESCING_DURATION_ACTIVATE_MS = 6;
 var COALESCING_DURATION_DEACTIVATE_MS = 4;
 var RETAIN_TOUCHED_IN_HISTORY = typeof process !== "undefined" && process.env ? process.env.NODE_ENV !== "production" : true;
 var EMPTY_TOUCHED_SET = /* @__PURE__ */ new Set();
+function shouldSkipCoalescing(patches) {
+  return patches.length <= 1;
+}
 function getDefaultNow() {
   if (typeof performance !== "undefined" && typeof performance.now === "function") {
     return () => performance.now();
@@ -61,8 +65,9 @@ function getDefaultCancelRaf() {
 }
 var PatchCommitScheduler = class {
   constructor(params) {
-    this.highQueue = [];
-    this.lowQueue = [];
+    this.semanticQueue = [];
+    this.enrichmentHighQueue = [];
+    this.enrichmentLowQueue = [];
     this.scheduled = false;
     this.flushing = false;
     this.scheduledHandle = null;
@@ -74,6 +79,7 @@ var PatchCommitScheduler = class {
     this.scheduleToken = 0;
     this.coalescingDurationSamples = [];
     this.adaptiveBudgetActive = false;
+    this.flushCount = 0;
     this.store = params.store;
     this.onFlush = params.onFlush;
     this.frameBudgetMs = Math.max(1, params.options?.frameBudgetMs ?? 10);
@@ -89,6 +95,8 @@ var PatchCommitScheduler = class {
     this.maxLowPriorityBatchesPerFlush = params.options?.maxLowPriorityBatchesPerFlush ?? 2;
     this.urgentQueueThreshold = Math.max(1, params.options?.urgentQueueThreshold ?? 4);
     this.historyLimit = Math.max(1, params.options?.historyLimit ?? 200);
+    this.startupMicrotaskFlushes = Math.max(0, Math.floor(params.options?.startupMicrotaskFlushes ?? 0));
+    this.adaptiveBudgeting = params.options?.adaptiveBudgeting ?? true;
     const requestedBatch = params.options?.batch;
     if (requestedBatch === "microtask") {
       this.batchStrategy = "microtask";
@@ -115,19 +123,23 @@ var PatchCommitScheduler = class {
       patches: input.patches,
       meta: input.meta ?? {},
       receivedAt: input.meta?.receivedAt ?? this.now(),
+      kind: input.meta?.kind === "semantic" || input.meta?.kind === "enrichment" ? input.meta.kind : input.patches.some((patch) => (0, import_patch_batching.getPatchKind)(patch) === "semantic") ? "semantic" : "enrichment",
       priority: input.meta?.priority === "low" ? "low" : "high"
     };
-    if (batch.priority === "low") {
-      this.lowQueue.push(batch);
+    if (batch.kind === "semantic") {
+      batch.priority = "high";
+      this.semanticQueue.push(batch);
+    } else if (batch.priority === "low") {
+      this.enrichmentLowQueue.push(batch);
     } else {
-      this.highQueue.push(batch);
+      this.enrichmentHighQueue.push(batch);
     }
     if (!this.paused) {
       this.schedule();
     }
   }
   flushAll() {
-    if (this.highQueue.length === 0 && this.lowQueue.length === 0 && !this.flushing) {
+    if (this.semanticQueue.length === 0 && this.enrichmentHighQueue.length === 0 && this.enrichmentLowQueue.length === 0 && !this.flushing) {
       return null;
     }
     this.cancelScheduled();
@@ -137,9 +149,11 @@ var PatchCommitScheduler = class {
   }
   clear() {
     this.cancelScheduled();
-    this.highQueue = [];
-    this.lowQueue = [];
+    this.semanticQueue = [];
+    this.enrichmentHighQueue = [];
+    this.enrichmentLowQueue = [];
     this.flushing = false;
+    this.flushCount = 0;
     this.coalescingDurationSamples = [];
     this.adaptiveBudgetActive = false;
     this.adaptiveHighBatchCap = void 0;
@@ -147,10 +161,10 @@ var PatchCommitScheduler = class {
     this.maybeResolveIdle();
   }
   getPendingCount() {
-    return this.highQueue.length + this.lowQueue.length;
+    return this.semanticQueue.length + this.enrichmentHighQueue.length + this.enrichmentLowQueue.length;
   }
   isIdle() {
-    return !this.flushing && !this.scheduled && this.highQueue.length === 0 && this.lowQueue.length === 0;
+    return !this.flushing && !this.scheduled && this.semanticQueue.length === 0 && this.enrichmentHighQueue.length === 0 && this.enrichmentLowQueue.length === 0;
   }
   awaitIdle() {
     if (this.isIdle()) {
@@ -190,7 +204,8 @@ var PatchCommitScheduler = class {
       this.runFlush(this.frameBudgetMs, false);
       this.maybeResolveIdle();
     };
-    if (this.batchStrategy === "microtask" && typeof queueMicrotask === "function") {
+    const useStartupMicrotask = this.batchStrategy !== "microtask" && this.startupMicrotaskFlushes > 0 && this.flushCount < this.startupMicrotaskFlushes && typeof queueMicrotask === "function";
+    if ((this.batchStrategy === "microtask" || useStartupMicrotask) && typeof queueMicrotask === "function") {
       this.scheduledViaRaf = false;
       this.scheduledHandle = token;
       queueMicrotask(execute);
@@ -220,12 +235,14 @@ var PatchCommitScheduler = class {
     if (this.paused && !manual) {
       return null;
     }
-    if (this.highQueue.length === 0 && this.lowQueue.length === 0) {
+    if (this.semanticQueue.length === 0 && this.enrichmentHighQueue.length === 0 && this.enrichmentLowQueue.length === 0) {
       return null;
     }
     this.flushing = true;
     const startedAt = this.now();
-    const initialQueueSize = this.highQueue.length + this.lowQueue.length;
+    const initialSemanticQueueSize = this.semanticQueue.length;
+    const initialEnrichmentQueueSize = this.enrichmentHighQueue.length + this.enrichmentLowQueue.length;
+    const initialQueueSize = initialSemanticQueueSize + initialEnrichmentQueueSize;
     const batches = [];
     let totalInputPatches = 0;
     let totalAppliedPatches = 0;
@@ -240,7 +257,15 @@ var PatchCommitScheduler = class {
         consumed += 1;
         const applyStart = this.now();
         const queueDelayMs = Math.max(0, applyStart - next.receivedAt);
-        const { patches: coalesced, metrics: coalescingMetrics } = (0, import_core.coalescePatchesWithMetrics)(next.patches, import_core.DEFAULT_COALESCE_CONFIG);
+        let coalesced;
+        let coalescingMetrics;
+        if (shouldSkipCoalescing(next.patches)) {
+          coalesced = next.patches;
+        } else {
+          const result = (0, import_core.coalescePatchesWithMetrics)(next.patches, import_core.DEFAULT_COALESCE_CONFIG);
+          coalesced = result.patches;
+          coalescingMetrics = result.metrics;
+        }
         const touched = this.store.applyPatches(coalesced, {
           coalesced: true,
           metrics: coalescingMetrics
@@ -260,6 +285,7 @@ var PatchCommitScheduler = class {
           receivedAt: next.receivedAt,
           appliedAt: applyStart,
           priority: next.priority,
+          kind: next.kind,
           coalescing: coalescingMetrics
         });
         if (maxBatches && batches.length - startingBatchCount >= maxBatches) {
@@ -276,27 +302,32 @@ var PatchCommitScheduler = class {
         queue.splice(0, consumed);
       }
     };
-    const initialHighQueueSize = this.highQueue.length;
+    processQueue(this.semanticQueue, void 0, Number.POSITIVE_INFINITY);
+    const initialHighQueueSize = this.enrichmentHighQueue.length;
     const configuredHighLimit = manual || !this.maxBatchesPerFlush ? void 0 : initialHighQueueSize > this.maxBatchesPerFlush ? void 0 : this.maxBatchesPerFlush;
-    const highBatchLimit = this.adaptiveHighBatchCap ?? configuredHighLimit;
-    processQueue(this.highQueue, highBatchLimit, budgetMs);
+    const highBatchLimit = this.adaptiveBudgeting ? this.adaptiveHighBatchCap ?? configuredHighLimit : configuredHighLimit;
+    processQueue(this.enrichmentHighQueue, highBatchLimit, budgetMs);
     if (manual) {
-      processQueue(this.lowQueue, void 0, Number.POSITIVE_INFINITY);
-    } else if (this.lowQueue.length > 0) {
+      processQueue(this.enrichmentLowQueue, void 0, Number.POSITIVE_INFINITY);
+    } else if (this.enrichmentLowQueue.length > 0) {
       elapsed = this.now() - startedAt;
       const budgetForLow = Math.max(0, this.lowPriorityFrameBudgetMs - elapsed);
-      if (budgetForLow > 0) {
-        const initialLowQueueSize = this.lowQueue.length;
+      const processedHigherPriorityWork = batches.length > 0;
+      if (budgetForLow > 0 || !processedHigherPriorityWork) {
+        const initialLowQueueSize = this.enrichmentLowQueue.length;
         const configuredLowLimit = manual || !this.maxLowPriorityBatchesPerFlush ? void 0 : initialLowQueueSize > this.maxLowPriorityBatchesPerFlush ? void 0 : this.maxLowPriorityBatchesPerFlush;
-        const lowBatchLimit = this.adaptiveLowBatchCap ?? configuredLowLimit;
-        processQueue(this.lowQueue, lowBatchLimit, budgetForLow);
+        const lowBatchLimit = this.adaptiveBudgeting ? this.adaptiveLowBatchCap ?? configuredLowLimit : configuredLowLimit;
+        processQueue(this.enrichmentLowQueue, lowBatchLimit, budgetForLow);
       }
     }
     this.flushing = false;
     const completedAt = this.now();
     const totalDurationMs = completedAt - startedAt;
-    const remaining = this.highQueue.length + this.lowQueue.length;
+    const remainingSemantic = this.semanticQueue.length;
+    const remainingEnrichment = this.enrichmentHighQueue.length + this.enrichmentLowQueue.length;
+    const remaining = remainingSemantic + remainingEnrichment;
     if (batches.length > 0) {
+      this.flushCount += 1;
       try {
         this.onFlush({
           batches,
@@ -304,7 +335,11 @@ var PatchCommitScheduler = class {
           totalAppliedPatches,
           totalDurationMs,
           remainingQueueSize: remaining,
+          remainingSemanticQueueSize: remainingSemantic,
+          remainingEnrichmentQueueSize: remainingEnrichment,
           queueDepthBefore: initialQueueSize,
+          semanticQueueDepthBefore: initialSemanticQueueSize,
+          enrichmentQueueDepthBefore: initialEnrichmentQueueSize,
           flushStartedAt: startedAt,
           flushCompletedAt: completedAt
         });
@@ -315,21 +350,27 @@ var PatchCommitScheduler = class {
     if (remaining > 0 && !this.paused) {
       this.schedule();
     }
-    const coalescingStats = this.computeCoalescingDurationStats();
-    this.updateAdaptiveBudget(coalescingStats.p95);
-    const adaptiveState = this.snapshotAdaptiveBudget(coalescingStats.p95 ?? null);
+    const coalescingStats = this.adaptiveBudgeting ? this.computeCoalescingDurationStats() : { sampleCount: this.coalescingDurationSamples.length, p95: null };
+    if (this.adaptiveBudgeting) {
+      this.updateAdaptiveBudget(coalescingStats.p95);
+    }
+    const adaptiveState = this.adaptiveBudgeting ? this.snapshotAdaptiveBudget(coalescingStats.p95 ?? null) : void 0;
     const flushResult = batches.length > 0 ? {
       batches,
       totalPatches: totalInputPatches,
       totalAppliedPatches,
       totalDurationMs,
       remainingQueueSize: remaining,
+      remainingSemanticQueueSize: remainingSemantic,
+      remainingEnrichmentQueueSize: remainingEnrichment,
       queueDepthBefore: initialQueueSize,
+      semanticQueueDepthBefore: initialSemanticQueueSize,
+      enrichmentQueueDepthBefore: initialEnrichmentQueueSize,
       flushStartedAt: startedAt,
       flushCompletedAt: completedAt,
       coalescingDurationP95: coalescingStats.p95 ?? void 0,
       coalescingDurationSampleCount: coalescingStats.sampleCount,
-      adaptiveBudgetActive: adaptiveState.active,
+      adaptiveBudgetActive: adaptiveState?.active,
       adaptiveBudgetState: adaptiveState
     } : null;
     if (flushResult) {
@@ -365,6 +406,9 @@ var PatchCommitScheduler = class {
     };
   }
   updateAdaptiveBudget(p95) {
+    if (!this.adaptiveBudgeting) {
+      return;
+    }
     if (p95 !== null && p95 > COALESCING_DURATION_ACTIVATE_MS) {
       if (!this.adaptiveBudgetActive) {
         this.adaptiveBudgetActive = true;
@@ -438,11 +482,13 @@ var PatchCommitScheduler = class {
   }
   restart() {
     this.cancelScheduled();
-    this.highQueue = [];
-    this.lowQueue = [];
+    this.semanticQueue = [];
+    this.enrichmentHighQueue = [];
+    this.enrichmentLowQueue = [];
     this.flushing = false;
     this.sequence = 0;
     this.history = [];
+    this.flushCount = 0;
     this.scheduleToken++;
     this.paused = false;
     this.coalescingDurationSamples = [];
@@ -489,6 +535,12 @@ var PatchCommitScheduler = class {
     if (typeof options.historyLimit !== "undefined") {
       this.setHistoryLimit(options.historyLimit);
     }
+    if (typeof options.startupMicrotaskFlushes !== "undefined") {
+      this.startupMicrotaskFlushes = Math.max(0, Math.floor(options.startupMicrotaskFlushes));
+    }
+    if (typeof options.adaptiveBudgeting !== "undefined") {
+      this.adaptiveBudgeting = options.adaptiveBudgeting;
+    }
     if (typeof options.batch !== "undefined") {
       const requestedBatch = options.batch;
       if (requestedBatch === "microtask") {

package/dist/renderer/patch-commit-scheduler.d.cts

@@ -1,4 +1,4 @@
-import { PatchMetrics, CoalescingMetrics, Patch } from '@stream-mdx/core';
+import { PatchMetrics, PatchKind, CoalescingMetrics, Patch } from '@stream-mdx/core';
 import { RendererStore } from './store.cjs';
 
 type NowFn = () => number;
@@ -21,6 +21,7 @@ interface PatchBatchMeta {
     metrics?: PatchMetrics;
     receivedAt?: number;
     priority?: "high" | "low";
+    kind?: PatchKind;
 }
 interface PatchBatchInput {
     patches: Patch[];
@@ -37,6 +38,7 @@ interface PatchFlushBatchResult {
     receivedAt: number;
     appliedAt: number;
     priority: "high" | "low";
+    kind: PatchKind;
     coalescing?: CoalescingMetrics;
 }
 interface PatchFlushResult {
@@ -45,7 +47,11 @@ interface PatchFlushResult {
     totalAppliedPatches: number;
     totalDurationMs: number;
     remainingQueueSize: number;
+    remainingSemanticQueueSize: number;
+    remainingEnrichmentQueueSize: number;
     queueDepthBefore: number;
+    semanticQueueDepthBefore: number;
+    enrichmentQueueDepthBefore: number;
     flushStartedAt: number;
     flushCompletedAt: number;
     coalescingDurationP95?: number | null;
@@ -65,6 +71,8 @@ interface PatchCommitSchedulerOptions {
     urgentQueueThreshold?: number;
     batch?: "rAF" | "microtask" | "timeout";
     historyLimit?: number;
+    startupMicrotaskFlushes?: number;
+    adaptiveBudgeting?: boolean;
 }
 declare class PatchCommitScheduler {
     private readonly store;
@@ -78,8 +86,10 @@ declare class PatchCommitScheduler {
     private lowPriorityFrameBudgetMs;
     private maxLowPriorityBatchesPerFlush?;
     private urgentQueueThreshold;
-    private highQueue;
-    private lowQueue;
+    private adaptiveBudgeting;
+    private semanticQueue;
+    private enrichmentHighQueue;
+    private enrichmentLowQueue;
     private scheduled;
     private flushing;
     private scheduledHandle;
@@ -95,6 +105,8 @@ declare class PatchCommitScheduler {
     private adaptiveBudgetActive;
     private adaptiveHighBatchCap;
     private adaptiveLowBatchCap;
+    private startupMicrotaskFlushes;
+    private flushCount;
     constructor(params: {
         store: RendererStore;
         onFlush: (result: PatchFlushResult) => void;

package/dist/renderer/patch-commit-scheduler.d.ts

@@ -1,4 +1,4 @@
-import { PatchMetrics, CoalescingMetrics, Patch } from '@stream-mdx/core';
+import { PatchMetrics, PatchKind, CoalescingMetrics, Patch } from '@stream-mdx/core';
 import { RendererStore } from './store.js';
 
 type NowFn = () => number;
@@ -21,6 +21,7 @@ interface PatchBatchMeta {
     metrics?: PatchMetrics;
     receivedAt?: number;
     priority?: "high" | "low";
+    kind?: PatchKind;
 }
 interface PatchBatchInput {
     patches: Patch[];
@@ -37,6 +38,7 @@ interface PatchFlushBatchResult {
     receivedAt: number;
     appliedAt: number;
     priority: "high" | "low";
+    kind: PatchKind;
     coalescing?: CoalescingMetrics;
 }
 interface PatchFlushResult {
@@ -45,7 +47,11 @@ interface PatchFlushResult {
     totalAppliedPatches: number;
     totalDurationMs: number;
     remainingQueueSize: number;
+    remainingSemanticQueueSize: number;
+    remainingEnrichmentQueueSize: number;
     queueDepthBefore: number;
+    semanticQueueDepthBefore: number;
+    enrichmentQueueDepthBefore: number;
     flushStartedAt: number;
     flushCompletedAt: number;
     coalescingDurationP95?: number | null;
@@ -65,6 +71,8 @@ interface PatchCommitSchedulerOptions {
     urgentQueueThreshold?: number;
     batch?: "rAF" | "microtask" | "timeout";
     historyLimit?: number;
+    startupMicrotaskFlushes?: number;
+    adaptiveBudgeting?: boolean;
 }
 declare class PatchCommitScheduler {
     private readonly store;
@@ -78,8 +86,10 @@ declare class PatchCommitScheduler {
     private lowPriorityFrameBudgetMs;
     private maxLowPriorityBatchesPerFlush?;
     private urgentQueueThreshold;
-    private highQueue;
-    private lowQueue;
+    private adaptiveBudgeting;
+    private semanticQueue;
+    private enrichmentHighQueue;
+    private enrichmentLowQueue;
     private scheduled;
     private flushing;
     private scheduledHandle;
@@ -95,6 +105,8 @@ declare class PatchCommitScheduler {
     private adaptiveBudgetActive;
     private adaptiveHighBatchCap;
     private adaptiveLowBatchCap;
+    private startupMicrotaskFlushes;
+    private flushCount;
     constructor(params: {
         store: RendererStore;
         onFlush: (result: PatchFlushResult) => void;

package/dist/renderer/patch-commit-scheduler.mjs

@@ -1,5 +1,8 @@
 "use client";
 
+// src/renderer/patch-commit-scheduler.ts
+import { getPatchKind } from "@stream-mdx/core/perf/patch-batching";
+
 // src/renderer/patch-coalescing.ts
 import {
   DEFAULT_COALESCE_CONFIG,
@@ -16,6 +19,9 @@ var COALESCING_DURATION_ACTIVATE_MS = 6;
 var COALESCING_DURATION_DEACTIVATE_MS = 4;
 var RETAIN_TOUCHED_IN_HISTORY = typeof process !== "undefined" && process.env ? process.env.NODE_ENV !== "production" : true;
 var EMPTY_TOUCHED_SET = /* @__PURE__ */ new Set();
+function shouldSkipCoalescing(patches) {
+  return patches.length <= 1;
+}
 function getDefaultNow() {
   if (typeof performance !== "undefined" && typeof performance.now === "function") {
     return () => performance.now();
@@ -42,8 +48,9 @@ function getDefaultCancelRaf() {
 }
 var PatchCommitScheduler = class {
   constructor(params) {
-    this.highQueue = [];
-    this.lowQueue = [];
+    this.semanticQueue = [];
+    this.enrichmentHighQueue = [];
+    this.enrichmentLowQueue = [];
     this.scheduled = false;
     this.flushing = false;
     this.scheduledHandle = null;
@@ -55,6 +62,7 @@ var PatchCommitScheduler = class {
     this.scheduleToken = 0;
     this.coalescingDurationSamples = [];
     this.adaptiveBudgetActive = false;
+    this.flushCount = 0;
     this.store = params.store;
     this.onFlush = params.onFlush;
     this.frameBudgetMs = Math.max(1, params.options?.frameBudgetMs ?? 10);
@@ -70,6 +78,8 @@ var PatchCommitScheduler = class {
     this.maxLowPriorityBatchesPerFlush = params.options?.maxLowPriorityBatchesPerFlush ?? 2;
     this.urgentQueueThreshold = Math.max(1, params.options?.urgentQueueThreshold ?? 4);
     this.historyLimit = Math.max(1, params.options?.historyLimit ?? 200);
+    this.startupMicrotaskFlushes = Math.max(0, Math.floor(params.options?.startupMicrotaskFlushes ?? 0));
+    this.adaptiveBudgeting = params.options?.adaptiveBudgeting ?? true;
     const requestedBatch = params.options?.batch;
     if (requestedBatch === "microtask") {
       this.batchStrategy = "microtask";
@@ -96,19 +106,23 @@ var PatchCommitScheduler = class {
       patches: input.patches,
       meta: input.meta ?? {},
       receivedAt: input.meta?.receivedAt ?? this.now(),
+      kind: input.meta?.kind === "semantic" || input.meta?.kind === "enrichment" ? input.meta.kind : input.patches.some((patch) => getPatchKind(patch) === "semantic") ? "semantic" : "enrichment",
       priority: input.meta?.priority === "low" ? "low" : "high"
     };
-    if (batch.priority === "low") {
-      this.lowQueue.push(batch);
+    if (batch.kind === "semantic") {
+      batch.priority = "high";
+      this.semanticQueue.push(batch);
+    } else if (batch.priority === "low") {
+      this.enrichmentLowQueue.push(batch);
     } else {
-      this.highQueue.push(batch);
+      this.enrichmentHighQueue.push(batch);
     }
     if (!this.paused) {
       this.schedule();
     }
   }
   flushAll() {
-    if (this.highQueue.length === 0 && this.lowQueue.length === 0 && !this.flushing) {
+    if (this.semanticQueue.length === 0 && this.enrichmentHighQueue.length === 0 && this.enrichmentLowQueue.length === 0 && !this.flushing) {
       return null;
     }
     this.cancelScheduled();
@@ -118,9 +132,11 @@ var PatchCommitScheduler = class {
   }
   clear() {
     this.cancelScheduled();
-    this.highQueue = [];
-    this.lowQueue = [];
+    this.semanticQueue = [];
+    this.enrichmentHighQueue = [];
+    this.enrichmentLowQueue = [];
     this.flushing = false;
+    this.flushCount = 0;
     this.coalescingDurationSamples = [];
     this.adaptiveBudgetActive = false;
     this.adaptiveHighBatchCap = void 0;
@@ -128,10 +144,10 @@ var PatchCommitScheduler = class {
     this.maybeResolveIdle();
   }
   getPendingCount() {
-    return this.highQueue.length + this.lowQueue.length;
+    return this.semanticQueue.length + this.enrichmentHighQueue.length + this.enrichmentLowQueue.length;
   }
   isIdle() {
-    return !this.flushing && !this.scheduled && this.highQueue.length === 0 && this.lowQueue.length === 0;
+    return !this.flushing && !this.scheduled && this.semanticQueue.length === 0 && this.enrichmentHighQueue.length === 0 && this.enrichmentLowQueue.length === 0;
   }
   awaitIdle() {
     if (this.isIdle()) {
@@ -171,7 +187,8 @@ var PatchCommitScheduler = class {
       this.runFlush(this.frameBudgetMs, false);
       this.maybeResolveIdle();
     };
-    if (this.batchStrategy === "microtask" && typeof queueMicrotask === "function") {
+    const useStartupMicrotask = this.batchStrategy !== "microtask" && this.startupMicrotaskFlushes > 0 && this.flushCount < this.startupMicrotaskFlushes && typeof queueMicrotask === "function";
+    if ((this.batchStrategy === "microtask" || useStartupMicrotask) && typeof queueMicrotask === "function") {
       this.scheduledViaRaf = false;
       this.scheduledHandle = token;
       queueMicrotask(execute);
@@ -201,12 +218,14 @@ var PatchCommitScheduler = class {
     if (this.paused && !manual) {
       return null;
     }
-    if (this.highQueue.length === 0 && this.lowQueue.length === 0) {
+    if (this.semanticQueue.length === 0 && this.enrichmentHighQueue.length === 0 && this.enrichmentLowQueue.length === 0) {
       return null;
     }
     this.flushing = true;
     const startedAt = this.now();
-    const initialQueueSize = this.highQueue.length + this.lowQueue.length;
+    const initialSemanticQueueSize = this.semanticQueue.length;
+    const initialEnrichmentQueueSize = this.enrichmentHighQueue.length + this.enrichmentLowQueue.length;
+    const initialQueueSize = initialSemanticQueueSize + initialEnrichmentQueueSize;
     const batches = [];
     let totalInputPatches = 0;
     let totalAppliedPatches = 0;
@@ -221,7 +240,15 @@ var PatchCommitScheduler = class {
         consumed += 1;
         const applyStart = this.now();
         const queueDelayMs = Math.max(0, applyStart - next.receivedAt);
-        const { patches: coalesced, metrics: coalescingMetrics } = coalescePatchesWithMetrics(next.patches, DEFAULT_COALESCE_CONFIG);
+        let coalesced;
+        let coalescingMetrics;
+        if (shouldSkipCoalescing(next.patches)) {
+          coalesced = next.patches;
+        } else {
+          const result = coalescePatchesWithMetrics(next.patches, DEFAULT_COALESCE_CONFIG);
+          coalesced = result.patches;
+          coalescingMetrics = result.metrics;
+        }
         const touched = this.store.applyPatches(coalesced, {
           coalesced: true,
           metrics: coalescingMetrics
@@ -241,6 +268,7 @@ var PatchCommitScheduler = class {
           receivedAt: next.receivedAt,
           appliedAt: applyStart,
           priority: next.priority,
+          kind: next.kind,
           coalescing: coalescingMetrics
         });
         if (maxBatches && batches.length - startingBatchCount >= maxBatches) {
@@ -257,27 +285,32 @@ var PatchCommitScheduler = class {
         queue.splice(0, consumed);
       }
     };
-    const initialHighQueueSize = this.highQueue.length;
+    processQueue(this.semanticQueue, void 0, Number.POSITIVE_INFINITY);
+    const initialHighQueueSize = this.enrichmentHighQueue.length;
     const configuredHighLimit = manual || !this.maxBatchesPerFlush ? void 0 : initialHighQueueSize > this.maxBatchesPerFlush ? void 0 : this.maxBatchesPerFlush;
-    const highBatchLimit = this.adaptiveHighBatchCap ?? configuredHighLimit;
-    processQueue(this.highQueue, highBatchLimit, budgetMs);
+    const highBatchLimit = this.adaptiveBudgeting ? this.adaptiveHighBatchCap ?? configuredHighLimit : configuredHighLimit;
+    processQueue(this.enrichmentHighQueue, highBatchLimit, budgetMs);
     if (manual) {
-      processQueue(this.lowQueue, void 0, Number.POSITIVE_INFINITY);
-    } else if (this.lowQueue.length > 0) {
+      processQueue(this.enrichmentLowQueue, void 0, Number.POSITIVE_INFINITY);
+    } else if (this.enrichmentLowQueue.length > 0) {
       elapsed = this.now() - startedAt;
       const budgetForLow = Math.max(0, this.lowPriorityFrameBudgetMs - elapsed);
-      if (budgetForLow > 0) {
-        const initialLowQueueSize = this.lowQueue.length;
+      const processedHigherPriorityWork = batches.length > 0;
+      if (budgetForLow > 0 || !processedHigherPriorityWork) {
+        const initialLowQueueSize = this.enrichmentLowQueue.length;
         const configuredLowLimit = manual || !this.maxLowPriorityBatchesPerFlush ? void 0 : initialLowQueueSize > this.maxLowPriorityBatchesPerFlush ? void 0 : this.maxLowPriorityBatchesPerFlush;
-        const lowBatchLimit = this.adaptiveLowBatchCap ?? configuredLowLimit;
-        processQueue(this.lowQueue, lowBatchLimit, budgetForLow);
+        const lowBatchLimit = this.adaptiveBudgeting ? this.adaptiveLowBatchCap ?? configuredLowLimit : configuredLowLimit;
+        processQueue(this.enrichmentLowQueue, lowBatchLimit, budgetForLow);
       }
     }
     this.flushing = false;
     const completedAt = this.now();
     const totalDurationMs = completedAt - startedAt;
-    const remaining = this.highQueue.length + this.lowQueue.length;
+    const remainingSemantic = this.semanticQueue.length;
+    const remainingEnrichment = this.enrichmentHighQueue.length + this.enrichmentLowQueue.length;
+    const remaining = remainingSemantic + remainingEnrichment;
     if (batches.length > 0) {
+      this.flushCount += 1;
       try {
         this.onFlush({
           batches,
@@ -285,7 +318,11 @@ var PatchCommitScheduler = class {
           totalAppliedPatches,
           totalDurationMs,
           remainingQueueSize: remaining,
+          remainingSemanticQueueSize: remainingSemantic,
+          remainingEnrichmentQueueSize: remainingEnrichment,
           queueDepthBefore: initialQueueSize,
+          semanticQueueDepthBefore: initialSemanticQueueSize,
+          enrichmentQueueDepthBefore: initialEnrichmentQueueSize,
           flushStartedAt: startedAt,
           flushCompletedAt: completedAt
         });
@@ -296,21 +333,27 @@ var PatchCommitScheduler = class {
     if (remaining > 0 && !this.paused) {
       this.schedule();
     }
-    const coalescingStats = this.computeCoalescingDurationStats();
-    this.updateAdaptiveBudget(coalescingStats.p95);
-    const adaptiveState = this.snapshotAdaptiveBudget(coalescingStats.p95 ?? null);
+    const coalescingStats = this.adaptiveBudgeting ? this.computeCoalescingDurationStats() : { sampleCount: this.coalescingDurationSamples.length, p95: null };
+    if (this.adaptiveBudgeting) {
+      this.updateAdaptiveBudget(coalescingStats.p95);
+    }
+    const adaptiveState = this.adaptiveBudgeting ? this.snapshotAdaptiveBudget(coalescingStats.p95 ?? null) : void 0;
     const flushResult = batches.length > 0 ? {
       batches,
       totalPatches: totalInputPatches,
       totalAppliedPatches,
       totalDurationMs,
       remainingQueueSize: remaining,
+      remainingSemanticQueueSize: remainingSemantic,
+      remainingEnrichmentQueueSize: remainingEnrichment,
       queueDepthBefore: initialQueueSize,
+      semanticQueueDepthBefore: initialSemanticQueueSize,
+      enrichmentQueueDepthBefore: initialEnrichmentQueueSize,
       flushStartedAt: startedAt,
       flushCompletedAt: completedAt,
       coalescingDurationP95: coalescingStats.p95 ?? void 0,
       coalescingDurationSampleCount: coalescingStats.sampleCount,
-      adaptiveBudgetActive: adaptiveState.active,
+      adaptiveBudgetActive: adaptiveState?.active,
       adaptiveBudgetState: adaptiveState
     } : null;
     if (flushResult) {
@@ -346,6 +389,9 @@ var PatchCommitScheduler = class {
     };
   }
   updateAdaptiveBudget(p95) {
+    if (!this.adaptiveBudgeting) {
+      return;
+    }
     if (p95 !== null && p95 > COALESCING_DURATION_ACTIVATE_MS) {
       if (!this.adaptiveBudgetActive) {
         this.adaptiveBudgetActive = true;
@@ -419,11 +465,13 @@ var PatchCommitScheduler = class {
   }
   restart() {
     this.cancelScheduled();
-    this.highQueue = [];
-    this.lowQueue = [];
+    this.semanticQueue = [];
+    this.enrichmentHighQueue = [];
+    this.enrichmentLowQueue = [];
     this.flushing = false;
     this.sequence = 0;
     this.history = [];
+    this.flushCount = 0;
     this.scheduleToken++;
     this.paused = false;
     this.coalescingDurationSamples = [];
@@ -470,6 +518,12 @@ var PatchCommitScheduler = class {
     if (typeof options.historyLimit !== "undefined") {
       this.setHistoryLimit(options.historyLimit);
     }
+    if (typeof options.startupMicrotaskFlushes !== "undefined") {
+      this.startupMicrotaskFlushes = Math.max(0, Math.floor(options.startupMicrotaskFlushes));
+    }
+    if (typeof options.adaptiveBudgeting !== "undefined") {
+      this.adaptiveBudgeting = options.adaptiveBudgeting;
+    }
     if (typeof options.batch !== "undefined") {
       const requestedBatch = options.batch;
       if (requestedBatch === "microtask") {