@nisli/core 0.54.1 → 0.55.0

package/dist/signal.js

@@ -2,10 +2,26 @@
  * signal.ts — Reactive primitives: signal(), computed(), effect()
  *
  * Push-pull hybrid model:
- * - Writes push "dirty" flags up the dependency graph
+ * - Writes push dirty flags up the dependency graph in two flavors: a signal
+ *   write pushes Dirty (the value definitely changed), a computed propagates
+ *   MaybeDirty (recompute to find out). Flags never downgrade.
  * - Reads pull fresh values lazily (computed only recalculates when read)
  * - Multiple synchronous writes coalesce into one microtask flush
  *
+ * Scheduler invariants (ADR 0030.2 T5):
+ * - An effect re-runs iff a value it read changed. Before a MaybeDirty
+ *   effect runs, its computed sources are polled (recomputed via the
+ *   node→impl back-pointer); if no source's change-epoch advanced past the
+ *   effect's last completed run, the run is skipped. A computed's
+ *   change-epoch also bumps on every error-state TRANSITION (enter and
+ *   exit), so effects never skip across error entry or equal-value recovery
+ *   (issue 0003 containment happens at the effect's own read).
+ * - Pending effects flush in creation order (monotonic index), so identical
+ *   writes produce identical run order. Documented cost: a later-created
+ *   writer effect costs one deterministic extra run vs. topological order.
+ * - The loop guard is clock-free: an effect that re-schedules ITSELF on
+ *   MAX_EFFECT_RERUNS consecutive runs is diagnosed (N301) and disposed.
+ *
  * Dependency tracking is automatic: reading a signal inside a computed
  * or effect registers it as a dependency. Dependencies are re-tracked
  * on every execution (dynamic/conditional tracking).
@@ -31,11 +47,34 @@ export const SIGNAL_BRAND = Symbol.for('backlog.signal');
  */
 let activeObserver = null;
 /**
- * Global epoch counter. Incremented on every signal write.
- * Used to determine if a computed needs recalculation: if a dependency's
- * lastChanged > this computed's lastChecked, the computed is stale.
+ * The effect whose fn frame is currently executing. Unlike activeObserver
+ * (which switches to a computed during its recompute, and to null under
+ * untrack()), this stays pinned to the running effect — it exists solely to
+ * attribute writes to the effect that performed them (N302).
+ */
+let runningEffect = null;
+/**
+ * Global epoch counter. Incremented on every observable change: a signal
+ * write, a computed recomputing to a different value, and a computed's
+ * error-state transitions (enter and exit). A node's `lastChanged` epoch is
+ * compared against an observer's last-validated/last-run epoch to decide
+ * staleness.
  */
 let globalEpoch = 0;
+/** Monotonic effect creation index — pending effects flush in this order. */
+let nextEffectOrder = 0;
+// ── Dev diagnostics ─────────────────────────────────────────────────
+// Reporting goes through the diagnostics leaf (its dev gate governs);
+// guard BEHAVIOR (loop disposal, rejection containment) is never gated —
+// only the reporting. Assigned codes: N301 effect loop, N302
+// write-in-own-effect, N303 flush/tick cap, N310 effect(async).
+import { diag as emitDiag, isDev } from './diagnostics.js';
+import { disposable } from './disposable.js';
+function diag(code, message, detail) {
+    if (!isDev())
+        return;
+    emitDiag(code, message, detail);
+}
 // ── Effect scheduling ────────────────────────────────────────────────
 const pendingEffects = new Set();
 let flushScheduled = false;
@@ -47,8 +86,9 @@ function scheduleFlush() {
 }
 function flushPendingEffects() {
     flushScheduled = false;
-    // Copy to avoid mutation during iteration
-    const effects = [...pendingEffects];
+    // Copy to avoid mutation during iteration; sort by creation index so
+    // identical writes produce identical run order forever (ADR 0030.2 T5).
+    const effects = [...pendingEffects].sort((a, b) => a.order - b.order);
     pendingEffects.clear();
     for (const effect of effects) {
         if (!effect.disposed) {
@@ -86,9 +126,23 @@ class SignalImpl {
     set value(newValue) {
         if (Object.is(this._node.value, newValue))
             return;
+        // N302: write-in-own-sources — the running effect wrote a signal it also
+        // reads this run, so this write re-triggers it. Attribution-only (never
+        // disposes; the loop guard owns disposal). Placed AFTER the Object.is
+        // cutoff so certified converging writers — registry reflect effects,
+        // each() item-signal reuse — never warn on equal-value writes.
+        if (runningEffect !== null &&
+            runningEffect.sources.has(this._node)) {
+            diag('N302', 'Effect wrote to a signal it also reads — the write re-schedules the ' +
+                'effect. If this does not converge to an equal value it is an ' +
+                'infinite loop. Derive the value with computed() instead.', runningEffect.createdAt ? { effect: runningEffect.createdAt } : undefined);
+        }
         this._node.value = newValue;
         this._node.lastChanged = ++globalEpoch;
-        notifyObservers(this._node.observers);
+        notifyObservers(this._node.observers, NodeState.Dirty);
+    }
+    peek() {
+        return this._node.value;
     }
     subscribe(fn) {
         return effect(() => {
@@ -100,9 +154,9 @@ class SignalImpl {
         });
     }
 }
-function notifyObservers(observers) {
+function notifyObservers(observers, flavor) {
     for (const observer of observers) {
-        observer.notify();
+        observer.notify(flavor);
     }
 }
 class ComputedImpl {
@@ -114,12 +168,19 @@ class ComputedImpl {
     sources = new Set();
     computing = false;
     error = NO_COMPUTED_ERROR;
+    /**
+     * globalEpoch snapshot at the end of the last update()/validation pass.
+     * A MaybeDirty computed recomputes only if some source's lastChanged
+     * advanced past this — otherwise it revalidates to Clean for free.
+     */
+    lastValidated = 0;
     constructor(fn) {
         this.compute = fn;
         this._node = {
             value: undefined,
             lastChanged: 0,
             observers: new Set(),
+            pull: () => { this.peek(); },
         };
     }
     get value() {
@@ -131,7 +192,7 @@ class ComputedImpl {
             activeObserver.sources.add(this._node);
             this._node.observers.add(activeObserver);
         }
-        // Pull: recalculate if dirty
+        // Pull: recalculate if (maybe) dirty
         if (this.state !== NodeState.Clean) {
             this.update();
         }
@@ -140,7 +201,47 @@ class ComputedImpl {
         }
         return this._node.value;
     }
+    peek() {
+        if (this.computing) {
+            throw new Error('Circular dependency detected in computed()');
+        }
+        // Same pull as `get value`, minus dependency registration.
+        if (this.state !== NodeState.Clean) {
+            this.update();
+        }
+        if (this.error !== NO_COMPUTED_ERROR) {
+            throw this.error;
+        }
+        return this._node.value;
+    }
+    /**
+     * MaybeDirty validation: pull each source (computeds recompute lazily) and
+     * report whether any source's change-epoch advanced past our last
+     * validation. A pulled source may throw — its error-state transition
+     * already bumped its change-epoch, so the epoch comparison decides.
+     */
+    sourcesChanged() {
+        for (const source of this.sources) {
+            if ('pull' in source) {
+                try {
+                    source.pull();
+                }
+                catch (_) { /* transition bumped lastChanged */ }
+            }
+            if (source.lastChanged > this.lastValidated)
+                return true;
+        }
+        return false;
+    }
     update() {
+        // MaybeDirty means "an upstream computed MAY have changed". Validate
+        // first: if no polled source advanced, revalidate to Clean without
+        // recomputing (the half of push-pull that was previously unimplemented).
+        if (this.state === NodeState.MaybeDirty && !this.sourcesChanged()) {
+            this.state = NodeState.Clean;
+            this.lastValidated = globalEpoch;
+            return;
+        }
         // Unsubscribe from previous sources (for dynamic dependency tracking)
         for (const source of this.sources) {
             source.observers.delete(this);
@@ -150,6 +251,7 @@ class ComputedImpl {
         const prevObserver = activeObserver;
         activeObserver = this;
         this.computing = true;
+        const wasError = this.error !== NO_COMPUTED_ERROR;
         try {
             const newValue = this.compute();
             this.error = NO_COMPUTED_ERROR;
@@ -163,9 +265,21 @@ class ComputedImpl {
                 // re-schedule the very effect performing this read — a spurious
                 // double-run that only surfaced once flush() began draining cascades.
             }
+            else if (wasError) {
+                // Error-state TRANSITION (exit) recovering to an EQUAL value: the
+                // epoch must still advance, or downstream effects would skip the
+                // recovery in their pre-run poll (ADR 0030.2 §8 T5 error rule).
+                this._node.lastChanged = ++globalEpoch;
+            }
         }
         catch (error) {
             this.error = error;
+            if (!wasError) {
+                // Error-state TRANSITION (enter) counts as a change: polls must see
+                // the epoch advance so the effect re-runs and its own read rethrows
+                // into the effect's containment (issue 0003 semantics).
+                this._node.lastChanged = ++globalEpoch;
+            }
             throw error;
         }
         finally {
@@ -175,15 +289,22 @@ class ComputedImpl {
             // notify(): the next dependency write then marks it dirty and propagates
             // to downstream observers so the computation can recover (issue 0003).
             this.state = NodeState.Clean;
+            this.lastValidated = globalEpoch;
         }
     }
     /** @internal — called by the ReactiveNode interface when a source changes */
-    notify() {
-        if (this.state === NodeState.Clean) {
-            this.state = NodeState.Dirty;
-            // Propagate dirty flags to downstream observers
-            // (they need to re-check if this computed's value actually changed)
-            notifyObservers(this._node.observers);
+    notify(flavor) {
+        // Never downgrade: a Dirty mark (definite signal change) survives a
+        // later MaybeDirty from a parallel computed path.
+        if (flavor > this.state) {
+            const wasClean = this.state === NodeState.Clean;
+            this.state = flavor;
+            // Propagate once per dirty episode. Downstream observers always get
+            // MaybeDirty — through a computed, "changed" is only knowable after a
+            // recompute, which stays lazy (pull-based).
+            if (wasClean) {
+                notifyObservers(this._node.observers, NodeState.MaybeDirty);
+            }
         }
     }
     subscribe(fn) {
@@ -201,29 +322,18 @@ class ComputedImpl {
 Object.defineProperty(ComputedImpl.prototype, 'sources', {
     enumerable: false,
 });
-// Bridge ComputedImpl to ReactiveNode — the observer interface.
-// We cast in notify() above; here we make the computed usable as a ReactiveNode
-// by defining the properties the tracker expects.
-const computedAsReactiveNode = (c) => ({
-    get state() { return c['state']; },
-    set state(v) { c['state'] = v; },
-    get sources() { return c['sources']; },
-    notify: () => c.notify(),
-});
 // ── Effect (side-effect, auto-tracks, auto-disposes) ────────────────
 /**
- * Maximum consecutive re-runs within a time window before we assume an infinite loop.
- * An effect that writes to a signal it reads will re-trigger itself
- * on every flush. This guard prevents silent UI freezes.
- * See ADR 0008 Gap 2 / ADR 0009.
+ * Maximum CONSECUTIVE self-re-schedules before we assume an infinite loop.
+ * An effect that writes to a signal it reads re-schedules itself on every
+ * run; when that happens MAX_EFFECT_RERUNS times in a row (the counter
+ * resets whenever a run does NOT re-schedule the effect), the effect is
+ * diagnosed (N301) and disposed. Clock-free — deterministic under CI and
+ * fake timers, and convergent clamps pass because their second run writes
+ * an equal value (Object.is cutoff → no re-schedule → counter reset).
+ * See ADR 0008 Gap 2 / ADR 0009 / ADR 0030.2 T5.
  */
 const MAX_EFFECT_RERUNS = 100;
-/**
- * Time window (ms) for counting consecutive re-runs.
- * If an effect runs MAX_EFFECT_RERUNS times within this window, it's a loop.
- * Resets when the effect hasn't been re-triggered for longer than this window.
- */
-const LOOP_WINDOW_MS = 2000;
 function createEffectNode(fn) {
     return {
         state: NodeState.Dirty,
@@ -232,41 +342,55 @@ function createEffectNode(fn) {
         disposed: false,
         sources: new Set(),
         disposers: [],
-        runCount: 0,
-        windowStart: 0,
-        notify() {
+        order: nextEffectOrder++,
+        lastRunEpoch: 0,
+        selfReschedules: 0,
+        notify(flavor) {
             if (this.disposed)
                 return;
-            this.state = NodeState.Dirty;
+            // Never downgrade Dirty (definite signal change) to MaybeDirty.
+            if (flavor > this.state)
+                this.state = flavor;
             pendingEffects.add(this);
             scheduleFlush();
         },
     };
 }
+/**
+ * Pre-run poll (ADR 0030.2 T5): the effect was notified MaybeDirty, meaning
+ * only computed sources MAY have changed. Pull each computed source (via the
+ * node back-pointer) so its change-epoch is fresh, then compare every
+ * source's epoch against the effect's last completed run. A pull may throw:
+ * the computed's error-state transition already bumped its epoch, so the
+ * comparison decides — a NEW error re-runs the effect (whose own read
+ * rethrows into its containment, issue 0003), while an error the effect
+ * already observed does not.
+ */
+function effectSourcesChanged(node) {
+    for (const source of node.sources) {
+        if ('pull' in source) {
+            try {
+                source.pull();
+            }
+            catch (_) { /* transition bumped lastChanged */ }
+        }
+        if (source.lastChanged > node.lastRunEpoch)
+            return true;
+    }
+    return false;
+}
+function isThenable(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        typeof value.then === 'function');
+}
 function runEffect(node) {
     if (node.disposed)
         return;
-    // Loop detection: count consecutive re-runs within a time window.
-    // If the effect runs MAX_EFFECT_RERUNS times within LOOP_WINDOW_MS,
-    // it's almost certainly a write-to-own-dependency loop. Dispose it.
-    const now = Date.now();
-    if (now - node.windowStart > LOOP_WINDOW_MS) {
-        // New window — reset counter
-        node.runCount = 0;
-        node.windowStart = now;
-    }
-    node.runCount++;
-    if (node.runCount > MAX_EFFECT_RERUNS) {
-        console.error(`Effect exceeded maximum re-run limit (${MAX_EFFECT_RERUNS}). ` +
-            `This usually means the effect writes to a signal it reads. ` +
-            `The effect has been disposed to prevent a UI freeze.`);
-        node.disposed = true;
-        // Unsubscribe from all sources to stop further notifications
-        for (const source of node.sources) {
-            source.observers.delete(node);
-        }
-        node.sources.clear();
-        pendingEffects.delete(node);
+    // MaybeDirty: poll sources — skip the run when no value the effect read
+    // actually changed (equal recomputes through a computed chain stop here).
+    if (node.state === NodeState.MaybeDirty && !effectSourcesChanged(node)) {
+        node.state = NodeState.Clean;
         return;
     }
     // Run cleanup from previous execution
@@ -282,14 +406,33 @@ function runEffect(node) {
         source.observers.delete(node);
     }
     node.sources.clear();
+    // Reset state BEFORE running: a notify fired by the effect's own writes
+    // must survive into the next flush pass, not be clobbered afterwards.
+    node.state = NodeState.Clean;
     // Run effect with tracking
     const prevObserver = activeObserver;
+    const prevRunning = runningEffect;
     activeObserver = node;
+    runningEffect = node;
     try {
         const result = node.fn();
         if (typeof result === 'function') {
             node.cleanup = result;
         }
+        else if (isThenable(result)) {
+            // effect(async …) — rejected at the type level, guarded at runtime for
+            // JS callers (ADR 0030.2 §3). The Promise is NOT a cleanup; route its
+            // rejection into the effect error path so nothing goes unhandled.
+            if (!node.asyncWarned) {
+                node.asyncWarned = true;
+                diag('N310', 'effect() callback returned a Promise — effects must be synchronous. ' +
+                    'Async state belongs in resource(). The returned Promise is not a ' +
+                    'cleanup function; its rejection is contained by the effect error path.', node.createdAt ? { effect: node.createdAt } : undefined);
+            }
+            result.then(undefined, (err) => {
+                console.error('Effect error:', err);
+            });
+        }
     }
     catch (err) {
         // Effect errors: log but don't crash the system.
@@ -298,8 +441,30 @@ function runEffect(node) {
     }
     finally {
         activeObserver = prevObserver;
+        runningEffect = prevRunning;
+        // Everything observable up to now — including epochs bumped by this
+        // run's own lazy computed pulls — counts as SEEN by this run.
+        node.lastRunEpoch = globalEpoch;
+    }
+    // Clock-free loop guard: this run re-scheduled the effect iff the effect
+    // is back in the pending set (only its own writes can do that mid-run).
+    if (pendingEffects.has(node)) {
+        if (++node.selfReschedules > MAX_EFFECT_RERUNS) {
+            diag('N301', `Effect exceeded maximum re-run limit (${MAX_EFFECT_RERUNS}). ` +
+                `This usually means the effect writes to a signal it reads. ` +
+                `The effect has been disposed to prevent a UI freeze.`, node.createdAt ? { effect: node.createdAt } : undefined);
+            // Dispose as today: unsubscribe everywhere and drop from the queue.
+            node.disposed = true;
+            for (const source of node.sources) {
+                source.observers.delete(node);
+            }
+            node.sources.clear();
+            pendingEffects.delete(node);
+        }
+    }
+    else {
+        node.selfReschedules = 0;
     }
-    node.state = NodeState.Clean;
 }
 // ── Public API ──────────────────────────────────────────────────────
 /**
@@ -309,6 +474,7 @@ function runEffect(node) {
  * const count = signal(0);
  * count.value;     // read (auto-tracks in reactive contexts)
  * count.value = 5; // write (notifies dependents)
+ * count.peek();    // read WITHOUT tracking
  * ```
  */
 export function signal(initialValue) {
@@ -331,7 +497,9 @@ export function computed(fn) {
  * Returns a dispose function to stop the effect.
  *
  * The effect function may return a cleanup callback that runs
- * before each re-execution and on disposal.
+ * before each re-execution and on disposal. It must be SYNCHRONOUS —
+ * async functions are rejected at the type level and diagnosed at
+ * runtime (N310); async state belongs in resource().
  *
  * ```ts
  * const dispose = effect(() => {
@@ -343,8 +511,12 @@ export function computed(fn) {
  * dispose(); // stop the effect
  * ```
  */
-export function effect(fn) {
+export function effect(fn, ..._rejectAsync) {
     const node = createEffectNode(fn);
+    if (isDev()) {
+        // Dev-captured effect identity: N301/N302 diagnostics name this site.
+        node.createdAt = new Error('effect() created here').stack;
+    }
     // Run immediately to establish initial dependencies
     runEffect(node);
     const dispose = () => {
@@ -371,7 +543,7 @@ export function effect(fn) {
             addDisposer(dispose);
         }
     }
-    return dispose;
+    return disposable(dispose, dispose);
 }
 /**
  * Check if a value is a signal (writable or computed).
@@ -385,7 +557,8 @@ export function isSignal(value) {
 // ── Observer isolation ───────────────────────────────────────────────
 /**
  * Run a function with activeObserver set to null, preventing any
- * signal reads inside `fn` from being tracked by an outer effect.
+ * signal reads inside `fn` from being tracked by an outer effect,
+ * and return the function's result.
  *
  * Used by component.ts to isolate connectedCallback: child component
  * setup signal reads must not leak into a parent effect's dependency
@@ -395,7 +568,7 @@ export function untrack(fn) {
     const prev = activeObserver;
     activeObserver = null;
     try {
-        fn();
+        return fn();
     }
     finally {
         activeObserver = prev;
@@ -419,8 +592,12 @@ export function flush() {
     let guard = 0;
     while (pendingEffects.size > 0) {
         flushPendingEffects();
-        if (++guard > 100000)
+        if (++guard > 100000) {
+            diag('N303', 'flush() cascade cap reached (100000 passes) — effects keep ' +
+                'scheduling more effects (a cross-effect write cycle?). Breaking out ' +
+                'to avoid a freeze; pending work remains unflushed.');
             break;
+        }
     }
 }
 /** Backward compat alias for tests. */
@@ -436,7 +613,7 @@ export { flush as flushEffects };
  * TASKS scheduled by that microtask work (e.g. a microtask calling
  * setTimeout) may fire after tick() resolves; awaiting arbitrary future
  * tasks is unbounded. Self-perpetuating schedulers are cut off at the
- * iteration cap.
+ * iteration cap (loudly — N303).
  *
  * ```ts
  * host.setProp('x', 1);
@@ -461,5 +638,8 @@ export async function tick() {
             return; // the microtask drain scheduled nothing
         flush();
     }
+    diag('N303', 'tick() iteration cap (50) reached with effects still pending — ' +
+        'something keeps scheduling reactive work every task (a ' +
+        'self-perpetuating scheduler?). Returning with work still queued.');
 }
 //# sourceMappingURL=signal.js.map

package/dist/signal.js.map

@@ -1 +1 @@
-{"version":3,"file":"signal.js","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"signal.js","sourceRoot":"","sources":["../src/signal.ts"],"names":[],"mappings":"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"}

package/dist/template-audit.d.ts

@@ -0,0 +1,64 @@
+/**
+ * template-audit.ts — First-parse static template audit (ADR 0030.2 T4).
+ *
+ * Attached to the parse-once cache in template.ts: runs ONCE per `html`
+ * callsite (keyed by TemplateStringsArray identity) at the first parse, and
+ * walks the parsed-but-never-mounted template element checking its STATIC
+ * parts. The silent-static-typo class — the no-build equivalent of a compile
+ * error — dies in the engine, amortized free.
+ *
+ * Checks (per ADR 0030.2 §2 T4 as amended by §8 "T4 (template)"):
+ * - N101 — a dash-tag with no customElements definition. Races
+ *   `customElements.whenDefined` against a microtask + macrotask grace so
+ *   ordinary lazy definition (module import order) never warns.
+ * - N102 — an `@event` name that is neither a known native event nor an
+ *   allowlisted component-dispatched event (`ui-*`, `nisli-*`).
+ * - N103 — an unknown `@event.modifier`.
+ * - N104 — an attribute on a component tag that declares attributes
+ *   (non-empty `static observedAttributes`) which is neither declared nor a
+ *   global HTML attribute. Components WITHOUT declared attributes get NO
+ *   attribute audit: pre-schema (T3) there is no truth source — auto-resolved
+ *   props are deliberately not attributes (§8).
+ *
+ * Suppression escape (designed for lazy islands, §8): a comment directive as
+ * the template's FIRST node (leading whitespace allowed):
+ *
+ *   html`<!-- nisli-audit off --><my-island>…</my-island>`
+ *     — disables the whole audit for this template.
+ *
+ *   html`<!-- nisli-audit allow-undefined: my-island other-tag --><…>`
+ *     — suppresses only N101 for the named tags (other checks stay live).
+ *
+ * The directive comment is static content: it survives into the mounted DOM
+ * (and SSG output) as an inert HTML comment. Documented, accepted for the
+ * prototype; the design gate may choose to strip it at parse.
+ *
+ * Dev gating: core has no build-time dev/prod define today — that mechanism
+ * is a named Wave-1 deliverable (§8). Until it exists this module is gated on
+ * the `devMode` flag below ONLY. SSG/happy-dom detection is deliberately NOT
+ * attempted (unreliable); an SSG build that wants silence must call
+ * `setTemplateAuditEnabled(false)` before rendering.
+ */
+/**
+ * Enable/disable the first-parse audit (and its callsite capture);
+ * `null` restores the dev-gate default.
+ */
+export declare function setTemplateAuditEnabled(enabled: boolean | null): void;
+/** Current audit gate state (exposed for template.ts and tests). */
+export declare function isTemplateAuditEnabled(): boolean;
+/** Emit a coded audit diagnostic through the diagnostics leaf (audit-gated). */
+export declare function diag(code: string, message: string, detail?: unknown): void;
+/**
+ * Remember the authoring callsite of an `html` template the first time its
+ * strings identity is seen. Must be called from `html()` itself — by the
+ * time the first parse happens (first mount), the authoring frame is gone
+ * from the stack. No-op when the audit is disabled or already captured.
+ */
+export declare function captureCallsite(strings: TemplateStringsArray): void;
+/**
+ * Run the one-time static audit over a freshly parsed template. Called by
+ * template.ts's parse-once cache on cache miss; idempotent per template
+ * identity, no-op when the audit is disabled. Read-only over the cached
+ * template element — mounting state is never touched.
+ */
+export declare function auditTemplate(strings: TemplateStringsArray, template: HTMLTemplateElement): void;