@tiaforge-ui/sinter 0.3.0 → 0.3.1

package/dist/cache.js

@@ -68,22 +68,29 @@ const cache = {
             loaded(def, r, url, items, total, appended) {
                 let t = tracked.get(def.name);
                 if (!t) {
-                    const entry = (t = { def, r, url, dirty: false, appended });
+                    const entry = (t = { def, r, url, dirty: false, appended, off: false });
                     // confirmed changes after the load (server events, action results); layers never fire this
                     r.subscribe(() => { entry.dirty = true; });
                     tracked.set(def.name, t);
                 }
                 t.url = url;
                 t.appended = appended;
+                t.off = false;
                 // `append` caches only its first page: later pages would be shown as if they were it
                 if (!appended)
                     write(def, url, items, total);
                 t.dirty = false;
             },
+            // the emptied resource must not replace the entry of its last URL
+            cleared(def) {
+                const t = tracked.get(def.name);
+                if (t)
+                    t.off = true;
+            },
         };
         app.addCleanup(app.env.listen('pagehide', () => {
             for (const t of tracked.values()) {
-                if (!t.dirty || t.appended || t.def.paginate?.mode == 'append')
+                if (!t.dirty || t.off || t.appended || t.def.paginate?.mode == 'append')
                     continue;
                 const b = t.r.base();
                 write(t.def, t.url, b.items, b.total);

package/dist/check/shadow.js

@@ -103,7 +103,7 @@ export function shadow(o) {
     line('/** @type {string} */');
     line('let $locale = $any;');
     line(`/** @type {${decl('Store')}<{ ${types.join('; ')} }>} */`);
-    line(`const { ${STORE_FNS.join(', ')} } = $any;`);
+    line(`const { ${STORE_FNS.filter((f) => !unit.resources.some((r) => r.name === f)).join(', ')} } = $any;`);
     line(`/** @template T @param {T} list @returns {${decl('Item')}<T>} */`);
     line('function $item(list) { return $any; }');
     /** a JSDoc tag with a type; a type the app wrote maps its errors to where it was written */

package/dist/compiler/compile.js

@@ -3,7 +3,7 @@
 import * as parse5 from 'parse5';
 import { parseExpressionAt } from 'acorn';
 import { didYouMean, severityOf } from './diagnostics.js';
-import { analyze } from './expr.js';
+import { analyze, STORE_FNS } from './expr.js';
 import { ATTRIBUTES, ELEMENTS } from './vocabulary.js';
 import { matchOperation, matchResource, queryNames, walk } from './openapi.js';
 const ATTRS = ATTRIBUTES.map((a) => a.name);
@@ -340,6 +340,10 @@ class Compiler {
                     this.report(child, 'name', 'SN302', `resource \`${name}\` is declared twice`, 0);
                     continue;
                 }
+                if (STORE_FNS.includes(name)) {
+                    this.report(child, 'name', 'SN209', `\`${name}\` is a store function (\`${name}()\`); a resource cannot take its name`, 0);
+                    continue;
+                }
                 const key = attr(child, 'key');
                 const paginate = attr(child, 'paginate');
                 const info = { name, key: key ? key.split(',').map((s) => s.trim()).filter(Boolean) : null, paginate: paginate ?? null, used: false };
@@ -1006,8 +1010,10 @@ class Compiler {
         if (lit)
             parts.push(lit);
         const first = parts[0];
-        if (typeof first !== 'string' || !(/^\/[^/\\]/.test(first) || first === '/' || /^https?:\/\/[^/{}]+(\/|$)/i.test(first))) {
-            this.report(el, attrName, 'SN207', 'a URL template must start with a literal same-origin path (`/api/…`) or a literal `https://` origin', 0, 'a leading interpolation or `//` lets a value choose the host');
+        // a literal origin followed by a value needs its `/`: `https://api.example.com{x}` lets `x` extend the host
+        const origin = parts.length > 1 ? /^https?:\/\/[^/{}]+\//i : /^https?:\/\/[^/{}]+(\/|$)/i;
+        if (typeof first !== 'string' || !(/^\/[^/\\]/.test(first) || first === '/' || origin.test(first))) {
+            this.report(el, attrName, 'SN207', 'a URL template must start with a literal same-origin path (`/api/…`) or a literal `https://` origin (with a `/` after the host when a value follows)', 0, 'a leading interpolation or `//` lets a value choose the host');
         }
         return parts;
     }

package/dist/compiler/diagnostic-docs.js

@@ -41,7 +41,7 @@ export const DIAGNOSTIC_DOCS = {
     },
     SN205: {
         example: '`m.is_read = true` mutates a resource. Use `patch(\'messages\', m, {is_read: true})`',
-        means: 'Resource data is read-only in expressions: it mirrors the server, and a direct write would be lost on the next refresh or event.',
+        means: 'Resource data is read-only in expressions: it mirrors the server, and a direct write (an assignment, a mutating method such as `push()`, or `Object.assign()` on an item) would be lost on the next refresh or event.',
         fix: 'Use the `patch()` call from the message, or copy the item with `structuredClone(c)` to edit it in state.',
     },
     SN206: {
@@ -51,8 +51,8 @@ export const DIAGNOSTIC_DOCS = {
     },
     SN207: {
         example: '`onclick` cannot be bound with `data-sn-attr`; use `data-sn-on-click`',
-        means: 'The binding could run script or inject markup from data: event-handler attributes, `style`, `srcdoc`, `innerHTML`, bindings on `<script>` and similar elements, URL templates that do not start with a literal path, or persisted password fields.',
-        fix: 'Use the safe equivalent the message names: `data-sn-on-*` for events, `data-sn-style` for styles, a literal `/path` at the start of a URL template.',
+        means: 'The binding could run script or inject markup from data: event-handler attributes, `style`, `srcdoc`, `innerHTML`, bindings on `<script>` and similar elements, URL templates that do not start with a literal path (or with a literal origin that lacks its `/` before a value), persisted password fields, or `constructor`, `__proto__` and `prototype` named in an expression.',
+        fix: 'Use the safe equivalent the message names: `data-sn-on-*` for events, `data-sn-style` for styles, a literal `/path` (or `https://host/`) at the start of a URL template.',
     },
     SN208: {
         example: 'Property \'nmae\' does not exist on type \'Contact\'. (TS2339)',
@@ -61,8 +61,8 @@ export const DIAGNOSTIC_DOCS = {
     },
     SN209: {
         example: '`s` is already defined here by `data-sn-let`; use another name',
-        means: 'A `data-sn-let` name is inlined wherever it is read, so it cannot share a name with a state variable or loop variable in its scope, or be redeclared inside it.',
-        fix: 'Rename the let, or the state or loop variable.',
+        means: 'A `data-sn-let` name is inlined wherever it is read, so it cannot share a name with a state variable or loop variable in its scope, or be redeclared inside it. A resource cannot take the name of a store function (`refresh`, `upsert`, `patch`, `remove`, `page`, `showModal`, `close`, `reset`, `emit`).',
+        fix: 'Rename the let, the state or loop variable, or the resource.',
     },
     SN301: {
         example: 'resource `mesages` is not declared on this page',

package/dist/compiler/expr.js

@@ -40,6 +40,8 @@ const READ_ONLY = new Set([
     'getMinutes', 'getSeconds', 'test', 'exec',
 ]);
 const MUTATORS = new Set(['push', 'pop', 'splice', 'sort', 'reverse', 'shift', 'unshift', 'fill', 'copyWithin', 'add', 'delete', 'clear', 'set']);
+/** `Object.<static>(target, …)` calls that change their first argument */
+const OBJECT_MUTATORS = new Set(['assign', 'defineProperty', 'defineProperties', 'setPrototypeOf']);
 /** callbacks of these methods receive elements of the receiver as first parameter */
 const ELEMENT_CALLBACKS = new Set(['forEach', 'map', 'filter', 'find', 'findIndex', 'findLast', 'findLastIndex', 'some', 'every', 'flatMap', 'toSorted', 'sort']);
 export function analyze(src, scope, page, opts) {
@@ -548,6 +550,26 @@ export function analyze(src, scope, page, opts) {
                         }
                     }
                 }
+                // `Object.assign(target, …)` and friends write to their first argument like `target.x = …` would;
+                // a forbidden key named literally in an `Object.*` call reaches what `.constructor` is refused for
+                if (m.object.type === 'Identifier' && m.object.name === 'Object' && !locals.has('Object') && method) {
+                    for (const a of n.arguments) {
+                        if (a.type === 'Literal' && FORBIDDEN_KEYS.has(String(a.value)))
+                            report('SN207', `\`${a.raw}\` is not allowed as an argument of \`Object.${method}()\``, a.start);
+                    }
+                    const target = n.arguments[0];
+                    const cp = OBJECT_MUTATORS.has(method) && target && (target.type === 'Identifier' || target.type === 'MemberExpression') ? chainPath(target, locals) : null;
+                    if (cp) {
+                        if (cp.resource)
+                            report('SN205', `\`Object.${method}(${src.slice(target.start, target.end)}, …)\` mutates a resource. Use \`patch('${cp.resource}', …)\` or copy with structuredClone()`, n.start);
+                        else if (cp.segs && cp.res.kind === 'state') {
+                            if (mode === 'value')
+                                report('SN203', `value expressions cannot change state; move \`Object.${method}()\` to \`data-sn-on-*\``, n.start);
+                            else if (mode === 'handler')
+                                writes.add(track(cp, cp.segs, n).join('.'));
+                        }
+                    }
+                }
                 // time and randomness
                 if (mode === 'value' && m.object.type === 'Identifier' && !m.computed) {
                     const o = m.object.name, p = m.property.name;

package/dist/ir.js

@@ -35,7 +35,14 @@ export function validateIR(ir, fnCount) {
         if (names.has(r.name))
             errs.push(`${at}: duplicate name ${r.name}`);
         names.add(r.name);
-        url(r.src, `${at}.src`);
+        if (r.call) {
+            fn(r.call.args, `${at}.call.args`, false);
+            fn(r.call.run, `${at}.call.run`, false);
+            if (r.src.length)
+                errs.push(`${at}: a call resource has no src`);
+        }
+        else
+            url(r.src, `${at}.src`);
         fn(r.when, `${at}.when`);
         if (r.paginate) {
             if (!['keyset', 'offset', 'append'].includes(r.paginate.mode))
@@ -109,11 +116,22 @@ export function validateIR(ir, fnCount) {
     });
     o.actions.forEach((a, i) => {
         const at = `actions[${i}]`;
-        if (!['GET', 'POST', 'PUT', 'PATCH', 'DELETE'].includes(a.method))
+        if (!['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'CALL'].includes(a.method))
             errs.push(`${at}: bad method`);
         if (!['block', 'queue', 'latest'].includes(a.concurrency))
             errs.push(`${at}: bad concurrency`);
-        url(a.url, `${at}.url`);
+        if (a.method === 'CALL') {
+            if (!a.call)
+                errs.push(`${at}: CALL needs call`);
+            else {
+                fn(a.call.args, `${at}.call.args`, false);
+                fn(a.call.run, `${at}.call.run`, false);
+            }
+            if (a.url.length)
+                errs.push(`${at}: a call action has no url`);
+        }
+        else
+            url(a.url, `${at}.url`);
         for (const k of ['body', 'optimistic', 'then', 'catch'])
             fn(a[k], `${at}.${k}`);
     });

package/dist/paginate.js

@@ -64,10 +64,16 @@ class PagerImpl {
                 n = target;
             else if (target === 'first')
                 n = 1;
-            else if (target === 'prev')
+            else if (target === 'prev') {
+                if (page <= 1)
+                    return;
                 n = page - 1;
-            else if (target === 'next')
+            }
+            else if (target === 'next') {
+                if (meta.pages != null && page >= meta.pages)
+                    return;
                 n = page + 1;
+            }
             else if (target === 'last') {
                 if (meta.pages == null) {
                     this.loader.app.warn(`page('${this.loader.def.name}', 'last') needs a known total`);
@@ -141,8 +147,9 @@ class PagerImpl {
                     hasNext = full;
                     break;
                 }
-                from = move.to != null ? move.to + 1 : null;
-                to = from != null ? from + n - 1 : null;
+                // past the end: nothing to count (`to` would come before `from`)
+                from = n && move.to != null ? move.to + 1 : n ? null : 0;
+                to = n ? (from != null ? from + n - 1 : null) : 0;
                 hasPrev = true;
                 hasNext = full;
                 break;

package/dist/persist.js

@@ -47,9 +47,12 @@ const persist = {
 };
 function overlaps(a, b) {
     const n = Math.min(a.length, b.length);
-    for (let i = 0; i < n; i++)
+    for (let i = 0; i < n; i++) {
+        if (b[i] === '**')
+            return true;
         if (a[i] !== b[i] && a[i] !== '*' && b[i] !== '*')
             return false;
+    }
     return true;
 }
 export default persist;

package/dist/runtime/app.d.ts

@@ -112,6 +112,8 @@ export interface App {
             } | null;
             /** a load (or embedded data) stored `items`: cache them, and the resource's later changes */
             loaded(def: ResourceDef, r: Resource, url: string, items: unknown, total: number | null, appended: boolean): void;
+            /** the resource was emptied (`when` is false): nothing to write until the next load */
+            cleared(def: ResourceDef): void;
         };
     };
     readonly beforeFlush: Array<(dirty: string[][]) => void>;

package/dist/runtime/app.js

@@ -58,7 +58,7 @@ export function mount(root, o) {
     /** `showModal(id)`, `close(id)`: the dialog of this mount root with that id */
     const dialog = (id) => [...root.querySelectorAll('dialog')].find((d) => d.id === id);
     const rootRbs = [], rootScopes = [], found = new Map();
-    let dirty = [], cur = [], scheduled = false, flushing = false, round = 0;
+    let dirty = [], cur = [], scheduled = false, flushing = false, round = 0, destroyed = false;
     const res = (name) => {
         const r = resources.get(name);
         if (!r)
@@ -105,16 +105,19 @@ export function mount(root, o) {
      * absent) and dirty path `d` are prefixes of each other; `*` matches any segment. A change
      * that ends above a row's own element, or only changes the list structure (`#`), does not
      * reach it: reconcile re-evaluates rows whose item or index changed. `~` reaches only rows
-     * whose element was marked.
+     * whose element was marked. A path ending in `**` (an island's `update()`) reaches everything
+     * under its prefix, at any depth.
      */
     const overlaps = (dep, d, s) => reach(dep, d, s) > 0;
     /** 0: no overlap; 1: only through a marked element (`~`) of the row; 2: overlap. */
     function reach({ p, n, a, t }, d, s) {
-        if (a >= 0 && d.length <= a)
+        if (a >= 0 && d.length <= a && d[d.length - 1] != '**')
             return 0;
         let via = 2;
         for (let i = 0, len = Math.min(p.length, d.length); i < len; i++) {
             const y = d[i];
+            if (y == '**')
+                return 2;
             // a list's structure dependency: reached by changes to the list itself or a whole element, not element fields
             if (p[i] == '#')
                 return d.length <= i + 1 ? 2 : 0;
@@ -158,7 +161,14 @@ export function mount(root, o) {
             $r: {}, $meta: {}, $url: readUrl(), $now: new Date(env.now()),
             $m: (el, v) => (marked.add(el), v),
             get $locale() { return config.locale?.get(); },
-            set $locale(v) { config.locale?.set(v); app.mark('$locale'); },
+            set $locale(v) {
+                config.locale?.set(v);
+                app.mark('$locale');
+                // ordered lists sort strings by locale
+                for (const def of ir.resources)
+                    if (def.order)
+                        app.mark('$r.' + def.name);
+            },
         },
         resource: res,
         request: (url, init) => req.send(url, init),
@@ -182,12 +192,14 @@ export function mount(root, o) {
         state(el) {
             for (let e = el; e; e = e.parentElement) {
                 const s = e[STATE];
+                // `**`: the island may have changed anything under the state, rows included
                 if (s)
-                    return { get: () => s[1], update: (fn) => { fn(s[1]); app.mark('$s' + s[0]); } };
+                    return { get: () => s[1], update: (fn) => { fn(s[1]); app.mark('$s' + s[0] + '.**'); } };
             }
             throw Error('sinter: no data-sn-state scope');
         },
         destroy() {
+            destroyed = true;
             for (const c of cleanups.splice(0))
                 c();
             instances.delete(root);
@@ -304,7 +316,8 @@ export function mount(root, o) {
                     console.error(e);
                 }
         },
-        addCleanup: (fn) => void cleanups.push(fn),
+        // after destroy(), nothing waits for the next one: run it now
+        addCleanup: (fn) => void (destroyed ? fn() : cleanups.push(fn)),
     };
     app.page.$f = app.storeFns(null);
     instances.set(root, app);
@@ -901,7 +914,9 @@ export function mount(root, o) {
             app.busy--;
         }
         app.busy++;
-        timers.set(rb, env.setTimeout(() => { timers.delete(rb); app.busy--; handle(rb, rb.b.f, e, rb.b.w); }, rb.b.ms, 'debounce'));
+        // the element may have left the page (its row removed) while the handler waited
+        timers.set(rb, env.setTimeout(() => { timers.delete(rb); app.busy--; if (rb.el.isConnected)
+            handle(rb, rb.b.f, e, rb.b.w); }, rb.b.ms, 'debounce'));
     }
     // ---- actions
     function trigger(rb, e) {
@@ -936,7 +951,8 @@ export function mount(root, o) {
             else {
                 url = app.url(a.url, s);
                 const fields = a.form && !get && a.method != 'DELETE';
-                body = a.body != null ? fns[a.body](s) : fields ? (a.enc == 'form' ? formFields(rb.el) : serialize(rb.el)) : undefined;
+                // form encoding: the fields as the browser would submit them (FormData), then as one of its bodies
+                body = a.body != null ? fns[a.body](s) : fields ? (a.enc == 'form' ? new FormData(rb.el) : serialize(rb.el)) : undefined;
                 if (a.enc == 'form')
                     body = formBody(body);
             }
@@ -1151,6 +1167,8 @@ export function mount(root, o) {
                     return void l.load();
                 c?.abort();
                 r.replace(r.isCollection ? [] : null);
+                if (def.cache != null)
+                    app.ext.cache?.cleared(def);
                 loading(false);
             },
             /** Repeats the current request; several calls in one task share one request. */
@@ -1228,7 +1246,7 @@ export function mount(root, o) {
 export function withParams(url, params) {
     if (!params)
         return url;
-    const [path, hash] = url.split('#'), [base, query] = path.split('?'), q = new URLSearchParams(query);
+    const [path, hash] = url.split('#'), i = path.indexOf('?'), base = i < 0 ? path : path.slice(0, i), q = new URLSearchParams(i < 0 ? '' : path.slice(i + 1));
     for (const k in params)
         q.set(k, params[k]);
     return `${base}?${q}${hash ? '#' + hash : ''}`;
@@ -1279,21 +1297,6 @@ export function formBody(body) {
     }
     return out;
 }
-/** A form's fields as browsers submit them; with a file input, multipart. */
-function formFields(form) {
-    const out = new URLSearchParams();
-    for (const c of form.elements) {
-        if (!c.name || c.disabled || /^(submit|button|reset|image|fieldset|output)$/.test(c.type))
-            continue;
-        if (c.type == 'file')
-            return new FormData(form);
-        if ((c.type == 'checkbox' || c.type == 'radio') && !c.checked)
-            continue;
-        for (const v of c.type == 'select-multiple' ? [...c.selectedOptions].map((o) => o.value) : [c.value])
-            out.append(c.name, v);
-    }
-    return out;
-}
 export function serialize(form) {
     const controls = [...form.elements];
     if (controls.some((c) => c.type == 'file'))
@@ -1308,7 +1311,8 @@ export function serialize(form) {
             continue;
         const k = segs.pop();
         let o = out;
-        segs.forEach((s, i) => (o = o[s] ??= /^\d+$/.test(segs[i + 1] ?? k) ? [] : Object.create(null)));
+        // a container at each step; a scalar written there earlier (`a`, then `a.b`) is replaced
+        segs.forEach((s, i) => (o = typeof o[s] == 'object' && o[s] ? o[s] : (o[s] = /^\d+$/.test(segs[i + 1] ?? k) ? [] : Object.create(null))));
         if (type == 'checkbox' && boxes[name] > 1)
             (o[k] ??= []).push(...(c.checked ? [c.value] : []));
         else

package/dist/runtime/helpers.js

@@ -44,7 +44,7 @@ export function number(v, opts) {
 const BYTE_UNITS = ['byte', 'kilobyte', 'megabyte', 'gigabyte', 'terabyte'];
 export function bytes(v) {
     let n = Number(v);
-    if (v == null || Number.isNaN(n))
+    if (v == null || v === '' || Number.isNaN(n))
         return '';
     let i = 0;
     while (Math.abs(n) >= 1024 && i < BYTE_UNITS.length - 1) {

package/dist/runtime/request.js

@@ -54,8 +54,8 @@ export function createRequestLayer(env, chain) {
         }
         headers.has('Accept') || headers.set('Accept', 'application/json');
         // mutations outlive the page: a navigation right after a click must not cancel the write
-        // (keepalive bodies are limited to 64 KB; larger ones and uploads go without it)
-        const keepalive = method != 'GET' && method != 'HEAD' && (body == null || (typeof body == 'string' && body.length < 60_000));
+        // (keepalive bodies are limited to 64 KiB; larger ones and uploads go without it)
+        const keepalive = method != 'GET' && method != 'HEAD' && (body == null || (typeof body == 'string' && bytes(body) < 60_000));
         inflight++;
         try {
             const res = await run(new Request(target, { method, headers, body: body ?? null, credentials: 'same-origin', signal: init.signal ?? null, keepalive }));
@@ -82,6 +82,8 @@ export function createRequestLayer(env, chain) {
     }
     return { send, raw, get inflight() { return inflight; } };
 }
+/** UTF-8 size of a string; a short one cannot reach the limit (at most 3 bytes per UTF-16 unit). */
+const bytes = (s) => (s.length < 20_000 ? s.length : new TextEncoder().encode(s).length);
 /** 204 or empty → null; JSON content type → parsed; anything else → text. */
 export async function parseBody(res) {
     const text = res.status == 204 ? '' : await res.text();

package/dist/runtime/store.js

@@ -160,7 +160,8 @@ export function createResource(name, o) {
         }
     };
     function visible() {
-        if (view)
+        // a locale change re-sorts strings: a view sorted for another locale is stale
+        if (view && !(coll && field && o.locale?.() !== sortedFor))
             return view;
         if (!coll)
             return (view = { l: [], get: () => undefined, s: over ? over.s : single });

package/dist/sse.js

@@ -199,10 +199,13 @@ class Connection {
 const sse = {
     name: 'sse',
     install(app) {
-        // connect after mount has created resources and loaders
+        // connect after mount has created resources and loaders, unless the app is gone by then
+        let alive = true;
+        app.addCleanup(() => { alive = false; });
         app.env.queueMicrotask(() => {
-            for (const def of app.ir.syncs)
-                new Connection(app, def).start();
+            if (alive)
+                for (const def of app.ir.syncs)
+                    new Connection(app, def).start();
         });
     },
 };

package/docs/diagnostics.md

@@ -88,7 +88,7 @@ Error, for example:
 
 > `m.is_read = true` mutates a resource. Use `patch('messages', m, {is_read: true})`
 
-Resource data is read-only in expressions: it mirrors the server, and a direct write would be lost on the next refresh or event.
+Resource data is read-only in expressions: it mirrors the server, and a direct write (an assignment, a mutating method such as `push()`, or `Object.assign()` on an item) would be lost on the next refresh or event.
 
 **Fix:** Use the `patch()` call from the message, or copy the item with `structuredClone(c)` to edit it in state.
 
@@ -108,9 +108,9 @@ Error, for example:
 
 > `onclick` cannot be bound with `data-sn-attr`; use `data-sn-on-click`
 
-The binding could run script or inject markup from data: event-handler attributes, `style`, `srcdoc`, `innerHTML`, bindings on `<script>` and similar elements, URL templates that do not start with a literal path, or persisted password fields.
+The binding could run script or inject markup from data: event-handler attributes, `style`, `srcdoc`, `innerHTML`, bindings on `<script>` and similar elements, URL templates that do not start with a literal path (or with a literal origin that lacks its `/` before a value), persisted password fields, or `constructor`, `__proto__` and `prototype` named in an expression.
 
-**Fix:** Use the safe equivalent the message names: `data-sn-on-*` for events, `data-sn-style` for styles, a literal `/path` at the start of a URL template.
+**Fix:** Use the safe equivalent the message names: `data-sn-on-*` for events, `data-sn-style` for styles, a literal `/path` (or `https://host/`) at the start of a URL template.
 
 ## SN208 type-error
 
@@ -128,9 +128,9 @@ Error, for example:
 
 > `s` is already defined here by `data-sn-let`; use another name
 
-A `data-sn-let` name is inlined wherever it is read, so it cannot share a name with a state variable or loop variable in its scope, or be redeclared inside it.
+A `data-sn-let` name is inlined wherever it is read, so it cannot share a name with a state variable or loop variable in its scope, or be redeclared inside it. A resource cannot take the name of a store function (`refresh`, `upsert`, `patch`, `remove`, `page`, `showModal`, `close`, `reset`, `emit`).
 
-**Fix:** Rename the let, or the state or loop variable.
+**Fix:** Rename the let, the state or loop variable, or the resource.
 
 ## SN301 unknown-resource
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiaforge-ui/sinter",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Bind JSON APIs to plain HTML: keyed resources, SSE sync, template bindings and optimistic mutations, compiled at build time.",
   "license": "MIT",
   "author": "Tia Heinrich",