@adecore/intelligent-ui 0.33.2 → 0.34.0

package/dist/budget.js

@@ -1,12 +1,14 @@
+const BLOCK_CHARACTERS = 65536;
 export const UI_LIMITS = {
-    characters: 65536,
+    characters: BLOCK_CHARACTERS,
     depth: 32,
     nodes: 512,
     diagnostics: 20,
-    steps: 20000,
+    // Parsing and validating a string literal can account for each character four times.
+    steps: 4 * BLOCK_CHARACTERS,
     iterations: 2000,
     stringLength: 16384,
-    milliseconds: 30
+    milliseconds: 0
 };
 export class UiFailure extends Error {
     code;
@@ -26,16 +28,16 @@ export class UiBudget {
     constructor(limits = {}, now = Date.now) {
         this.now = now;
         this.limits = { ...UI_LIMITS, ...limits };
-        for (const value of Object.values(this.limits)) {
-            if (!Number.isSafeInteger(value) || value <= 0) {
-                throw new UiFailure('invalid_limits', 'Budgets must be positive safe integers.');
+        for (const [name, value] of Object.entries(this.limits)) {
+            if (!Number.isSafeInteger(value) || value < 0 || (value === 0 && name !== 'milliseconds')) {
+                throw new UiFailure('invalid_limits', 'Budgets must be positive safe integers, except milliseconds may be zero.');
             }
         }
-        this.started = now();
+        this.started = this.limits.milliseconds > 0 ? now() : 0;
     }
     step(count = 1) {
         this.steps += count;
-        if (this.steps > this.limits.steps || this.now() - this.started > this.limits.milliseconds) {
+        if (this.steps > this.limits.steps || (this.limits.milliseconds > 0 && this.now() - this.started > this.limits.milliseconds)) {
             throw new UiFailure('budget_exceeded', 'The operation exceeded its work budget.');
         }
     }

package/dist/compiler.d.ts

@@ -7,7 +7,7 @@ export declare const UI_REPLY_LIMITS: {
     readonly blocks: 16;
     readonly characters: 262144;
     readonly nodes: 2048;
-    readonly milliseconds: 60;
+    readonly milliseconds: 0;
 };
 export declare const UI_HOST_LIMITS: {
     readonly queries: 8;

package/dist/compiler.js

@@ -9,7 +9,7 @@ import { parseUiSyntax, uiDiagnostic } from './syntax.js';
 import {} from 'zod';
 // The info string a fence carries when the host names none of its own.
 export const UI_FENCE_LANGUAGE = 'ui';
-export const UI_REPLY_LIMITS = { blocks: 16, characters: 262144, nodes: 2048, milliseconds: 60 };
+export const UI_REPLY_LIMITS = { blocks: 16, characters: 262144, nodes: 2048, milliseconds: 0 };
 // What a host reads for one block: its queries, its link targets, the places it looks up and how often a visible block reads again.
 export const UI_HOST_LIMITS = { queries: 8, links: 64, places: 50, refreshMilliseconds: 10_000 };
 /* A Place that names an address, whose tag may hold quoted text with a `>` before it. */
@@ -361,7 +361,7 @@ export class UiCompiler {
         const now = this.options.now ?? Date.now;
         const language = this.options.fenceLanguage ?? UI_FENCE_LANGUAGE;
         const diagnostics = this.options.limits?.diagnostics ?? UI_LIMITS.diagnostics;
-        const started = now();
+        const started = UI_REPLY_LIMITS.milliseconds > 0 ? now() : 0;
         const nodeCount = (items) => items.reduce((count, node) => count + 1 + nodeCount(node.children), 0);
         const rejected = (start, codeStart, codeEnd, end, complete) => ({
             id: `${this.options.id}:ui:${start}`,
@@ -393,7 +393,7 @@ export class UiCompiler {
             }
             const complete = closed || update.final === true;
             characters += codeEnd - codeStart;
-            if (characters > UI_REPLY_LIMITS.characters || now() - started > UI_REPLY_LIMITS.milliseconds) {
+            if (characters > UI_REPLY_LIMITS.characters || (UI_REPLY_LIMITS.milliseconds > 0 && now() - started > UI_REPLY_LIMITS.milliseconds)) {
                 blocks.push(rejected(start, codeStart, codeEnd, end, complete));
                 exhausted = true;
                 return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/intelligent-ui",
-  "version": "0.33.2",
+  "version": "0.34.0",
   "description": "A streaming UI catalog, compiler and bounded expression interpreter without a framework or DOM.",
   "license": "FSL-1.1-MIT",
   "author": "Bas Milius",

package/src/budget.ts

@@ -6,18 +6,22 @@ export interface UiLimits {
     steps: number;
     iterations: number;
     stringLength: number;
+    /* Zero leaves admission to deterministic work limits; a positive value also bounds elapsed time. */
     milliseconds: number;
 }
 
+const BLOCK_CHARACTERS = 65536;
+
 export const UI_LIMITS: Readonly<UiLimits> = {
-    characters: 65536,
+    characters: BLOCK_CHARACTERS,
     depth: 32,
     nodes: 512,
     diagnostics: 20,
-    steps: 20000,
+    // Parsing and validating a string literal can account for each character four times.
+    steps: 4 * BLOCK_CHARACTERS,
     iterations: 2000,
     stringLength: 16384,
-    milliseconds: 30
+    milliseconds: 0
 };
 
 export class UiFailure extends Error {
@@ -41,17 +45,17 @@ export class UiBudget {
     constructor(limits: Partial<UiLimits> = {}, now: () => number = Date.now) {
         this.now = now;
         this.limits = { ...UI_LIMITS, ...limits };
-        for (const value of Object.values(this.limits)) {
-            if (!Number.isSafeInteger(value) || value <= 0) {
-                throw new UiFailure('invalid_limits', 'Budgets must be positive safe integers.');
+        for (const [name, value] of Object.entries(this.limits)) {
+            if (!Number.isSafeInteger(value) || value < 0 || (value === 0 && name !== 'milliseconds')) {
+                throw new UiFailure('invalid_limits', 'Budgets must be positive safe integers, except milliseconds may be zero.');
             }
         }
-        this.started = now();
+        this.started = this.limits.milliseconds > 0 ? now() : 0;
     }
 
     step(count = 1): void {
         this.steps += count;
-        if (this.steps > this.limits.steps || this.now() - this.started > this.limits.milliseconds) {
+        if (this.steps > this.limits.steps || (this.limits.milliseconds > 0 && this.now() - this.started > this.limits.milliseconds)) {
             throw new UiFailure('budget_exceeded', 'The operation exceeded its work budget.');
         }
     }

package/src/compiler.ts

@@ -11,7 +11,7 @@ import { type z } from 'zod';
 // The info string a fence carries when the host names none of its own.
 export const UI_FENCE_LANGUAGE = 'ui';
 
-export const UI_REPLY_LIMITS = { blocks: 16, characters: 262144, nodes: 2048, milliseconds: 60 } as const;
+export const UI_REPLY_LIMITS = { blocks: 16, characters: 262144, nodes: 2048, milliseconds: 0 } as const;
 
 // What a host reads for one block: its queries, its link targets, the places it looks up and how often a visible block reads again.
 export const UI_HOST_LIMITS = { queries: 8, links: 64, places: 50, refreshMilliseconds: 10_000 } as const;
@@ -456,7 +456,7 @@ export class UiCompiler {
         const now = this.options.now ?? Date.now;
         const language = this.options.fenceLanguage ?? UI_FENCE_LANGUAGE;
         const diagnostics = this.options.limits?.diagnostics ?? UI_LIMITS.diagnostics;
-        const started = now();
+        const started = UI_REPLY_LIMITS.milliseconds > 0 ? now() : 0;
         const nodeCount = (items: readonly UiNode[]): number => items.reduce((count, node) => count + 1 + nodeCount(node.children), 0);
         const rejected = (start: number, codeStart: number, codeEnd: number, end: number, complete: boolean): UiBlock => ({
             id: `${this.options.id}:ui:${start}`,
@@ -488,7 +488,7 @@ export class UiCompiler {
             }
             const complete = closed || update.final === true;
             characters += codeEnd - codeStart;
-            if (characters > UI_REPLY_LIMITS.characters || now() - started > UI_REPLY_LIMITS.milliseconds) {
+            if (characters > UI_REPLY_LIMITS.characters || (UI_REPLY_LIMITS.milliseconds > 0 && now() - started > UI_REPLY_LIMITS.milliseconds)) {
                 blocks.push(rejected(start, codeStart, codeEnd, end, complete));
                 exhausted = true;
                 return;