@gyral/core 0.3.0 → 0.3.1

package/dist/errors.json

@@ -0,0 +1,289 @@
+[
+  {
+    "code": "G0001",
+    "group": "Components",
+    "message": "<{tag}> is a browser element (render it on the server with @gyral/ssr).",
+    "arguments": ["tag"],
+    "url": "https://gyral.dev/errors/#G0001"
+  },
+  {
+    "code": "G0010",
+    "group": "Components",
+    "message": "<{tag}> has no update for message \"{message}\".",
+    "arguments": ["tag", "message"],
+    "url": "https://gyral.dev/errors/#G0010"
+  },
+  {
+    "code": "G0011",
+    "group": "Components",
+    "message": "<{tag}> has no intent parser for data-intent=\"{intent}\".",
+    "arguments": ["tag", "intent"],
+    "url": "https://gyral.dev/errors/#G0011"
+  },
+  {
+    "code": "G0012",
+    "group": "Components",
+    "message": "<{tag}> intent parser for \"{intent}\" failed",
+    "arguments": ["tag", "intent"],
+    "url": "https://gyral.dev/errors/#G0012"
+  },
+  {
+    "code": "G0013",
+    "group": "Components",
+    "message": "<{tag}> focus(\"{selector}\") matched no focusable element.",
+    "arguments": ["tag", "selector"],
+    "url": "https://gyral.dev/errors/#G0013"
+  },
+  {
+    "code": "G0020",
+    "group": "Props",
+    "message": "<{tag}> prop \"{prop}\" has an asynchronous schema; it must be synchronous.",
+    "arguments": ["tag", "prop"],
+    "url": "https://gyral.dev/errors/#G0020"
+  },
+  {
+    "code": "G0021",
+    "group": "Props",
+    "message": "<{tag}> prop \"{prop}\" got an invalid value from {source}, so it is treated as missing: {issues}",
+    "arguments": ["tag", "prop", "source", "issues"],
+    "url": "https://gyral.dev/errors/#G0021"
+  },
+  {
+    "code": "G0022",
+    "group": "Props",
+    "message": "<{tag}> is missing required prop(s): {props}.",
+    "arguments": ["tag", "props"],
+    "url": "https://gyral.dev/errors/#G0022"
+  },
+  {
+    "code": "G0023",
+    "group": "Props",
+    "message": "<{tag}> declares prop(s) that shadow built-in element properties: {props}. Setting them changes platform behaviour (a prop named \"hidden\" hides the element). Rename them (view/05-element.md).",
+    "arguments": ["tag", "props"],
+    "url": "https://gyral.dev/errors/#G0023"
+  },
+  {
+    "code": "G0030",
+    "group": "Scheduling",
+    "message": "gyral: a deferred callback failed",
+    "arguments": [],
+    "url": "https://gyral.dev/errors/#G0030"
+  },
+  {
+    "code": "G0031",
+    "group": "Scheduling",
+    "message": "<{tag}> view failed; it shows its error view, or its previous DOM stays.",
+    "arguments": ["tag"],
+    "url": "https://gyral.dev/errors/#G0031"
+  },
+  {
+    "code": "G0032",
+    "group": "Scheduling",
+    "message": "gyral: post-render work failed",
+    "arguments": [],
+    "url": "https://gyral.dev/errors/#G0032"
+  },
+  {
+    "code": "G0033",
+    "group": "Scheduling",
+    "message": "gyral: rendering did not settle in one flush (a cycle between {tags}). Components are probably feeding each other props or messages; break the cycle with a condition in update (docs/design-docs/view/04-scheduler.md \"Loop guard\").",
+    "arguments": ["tags"],
+    "url": "https://gyral.dev/errors/#G0033"
+  },
+  {
+    "code": "G0034",
+    "group": "Scheduling",
+    "message": "settled(): the page did not settle after {rounds} flushes or busy turns. A stream is emitting without pause, or components (or drivers) are feeding each other messages in a cycle.",
+    "arguments": ["rounds"],
+    "url": "https://gyral.dev/errors/#G0034"
+  },
+  {
+    "code": "G0040",
+    "group": "Commands",
+    "message": "{owner}: the onSuccess or onFailure mapper for driver \"{driver}\" threw; no message was sent.",
+    "arguments": ["owner", "driver"],
+    "url": "https://gyral.dev/errors/#G0040"
+  },
+  {
+    "code": "G0041",
+    "group": "Commands",
+    "message": "{owner}: driver \"{driver}\" failed and the command has no onFailure.",
+    "arguments": ["owner", "driver"],
+    "url": "https://gyral.dev/errors/#G0041"
+  },
+  {
+    "code": "G0042",
+    "group": "Commands",
+    "message": "gyral: subscription \"{name}\" failed to unsubscribe",
+    "arguments": ["name"],
+    "url": "https://gyral.dev/errors/#G0042"
+  },
+  {
+    "code": "G0043",
+    "group": "Commands",
+    "message": "{owner}: no driver provides \"{driver}\". It is a driver token: provide an implementation by name with provideDrivers(root, { {driver}: … }) or el.drivers (ADR 0006 \"Driver tokens\").",
+    "arguments": ["owner", "driver"],
+    "url": "https://gyral.dev/errors/#G0043"
+  },
+  {
+    "code": "G0050",
+    "group": "Stores",
+    "message": "<{tag}> uses store \"{store}\" without declaring it. Add it to the spec: stores: [{store}] (ADR 0013), so the component subscribes to its changes.",
+    "arguments": ["tag", "store"],
+    "url": "https://gyral.dev/errors/#G0050"
+  },
+  {
+    "code": "G0051",
+    "group": "Stores",
+    "message": "store \"{store}\": the server's seed failed its schema, so it starts from init. Issues: {issues}",
+    "arguments": ["store", "issues"],
+    "url": "https://gyral.dev/errors/#G0051"
+  },
+  {
+    "code": "G0052",
+    "group": "Stores",
+    "message": "unreadable {attribute} seed on {where}",
+    "arguments": ["attribute", "where"],
+    "url": "https://gyral.dev/errors/#G0052"
+  },
+  {
+    "code": "G0053",
+    "group": "Stores",
+    "message": "<{tag}> reads store \"{store}\" during a server render without a store scope. Pass the request's store instances to renderPage({ stores }) or renderToString(value, { stores }).",
+    "arguments": ["tag", "store"],
+    "url": "https://gyral.dev/errors/#G0053"
+  },
+  {
+    "code": "G0054",
+    "group": "Stores",
+    "message": "store \"{store}\" sends to \"{target}\" but is not held by a store scope (a registry, <gyral-stores> or the page default), so the message is dropped.",
+    "arguments": ["store", "target"],
+    "url": "https://gyral.dev/errors/#G0054"
+  },
+  {
+    "code": "G0055",
+    "group": "Stores",
+    "message": "store \"{store}\" has no update for message \"{message}\".",
+    "arguments": ["store", "message"],
+    "url": "https://gyral.dev/errors/#G0055"
+  },
+  {
+    "code": "G0060",
+    "group": "Hydration",
+    "message": "<{tag}> has an unreadable {attribute}",
+    "arguments": ["tag", "attribute"],
+    "url": "https://gyral.dev/errors/#G0060"
+  },
+  {
+    "code": "G0061",
+    "group": "Hydration",
+    "message": "gyral: hydration code failed to load; rendering fresh",
+    "arguments": [],
+    "url": "https://gyral.dev/errors/#G0061"
+  },
+  {
+    "code": "G0062",
+    "group": "Hydration",
+    "message": "gyral: hydration mismatch in {host} at {path}: expected {expected}, found {found}. The server's HTML differs from the first client render: a view that isn't deterministic (Date.now(), locale), a third party that changed the DOM before scripts ran, or a stale cached page (docs/design-docs/view/07-hydration.md \"Mismatches\").",
+    "arguments": ["host", "path", "expected", "found"],
+    "url": "https://gyral.dev/errors/#G0062"
+  },
+  {
+    "code": "G0063",
+    "group": "Hydration",
+    "message": "<{tag}> was rendered fresh after a hydration mismatch:",
+    "arguments": ["tag"],
+    "url": "https://gyral.dev/errors/#G0063"
+  },
+  {
+    "code": "G0070",
+    "group": "Templates",
+    "message": "gyral: an html template was not compiled: `{start}`. Under the gyral-compiled condition every html`…` must be compiled by the Gyral Vite preset (view/01-templates.md).",
+    "arguments": ["start"],
+    "url": "https://gyral.dev/errors/#G0070"
+  },
+  {
+    "code": "G0071",
+    "group": "Templates",
+    "message": "gyral: template rule 11: a page shell rendered in the browser.",
+    "arguments": [],
+    "url": "https://gyral.dev/errors/#G0071"
+  },
+  {
+    "code": "G0072",
+    "group": "Templates",
+    "message": "gyral: this page's Trusted Types policy list does not allow the policy \"gyral\", so templates are parsed from plain strings, which works only while Trusted Types are not enforced. Add `trusted-types gyral` to the Content-Security-Policy.",
+    "arguments": [],
+    "url": "https://gyral.dev/errors/#G0072"
+  },
+  {
+    "code": "G0073",
+    "group": "Errors (ADR 0024)",
+    "message": "<{tag}> update for \"{message}\" failed; the state is unchanged.",
+    "arguments": ["tag", "message"],
+    "url": "https://gyral.dev/errors/#G0073"
+  },
+  {
+    "code": "G0074",
+    "group": "Errors (ADR 0024)",
+    "message": "<{tag}> init failed; it shows its error view, or stays empty.",
+    "arguments": ["tag"],
+    "url": "https://gyral.dev/errors/#G0074"
+  },
+  {
+    "code": "G0075",
+    "group": "Errors (ADR 0024)",
+    "message": "<{tag}> element hook failed; the other hooks still ran.",
+    "arguments": ["tag"],
+    "url": "https://gyral.dev/errors/#G0075"
+  },
+  {
+    "code": "G0076",
+    "group": "Errors (ADR 0024)",
+    "message": "store \"{store}\": update for \"{message}\" failed; the state is unchanged.",
+    "arguments": ["store", "message"],
+    "url": "https://gyral.dev/errors/#G0076"
+  },
+  {
+    "code": "G0077",
+    "group": "Errors (ADR 0024)",
+    "message": "store \"{store}\": a subscriber failed; the other subscribers were still notified.",
+    "arguments": ["store"],
+    "url": "https://gyral.dev/errors/#G0077"
+  },
+  {
+    "code": "G0078",
+    "group": "Errors (ADR 0024)",
+    "message": "<{tag}> failed to render on the server; it renders its error view (or nothing) and starts fresh in the browser.",
+    "arguments": ["tag"],
+    "url": "https://gyral.dev/errors/#G0078"
+  },
+  {
+    "code": "G0079",
+    "group": "Subscriptions (ADR 0025)",
+    "message": "<{tag}> subscriptions returned two commands for lane \"{lane}\"; only the first runs. Give each its own `key`.",
+    "arguments": ["tag", "lane"],
+    "url": "https://gyral.dev/errors/#G0079"
+  },
+  {
+    "code": "G0080",
+    "group": "Subscriptions (ADR 0025)",
+    "message": "<{tag}> subscriptions kept restarting: a subscription's input data changes with every message it sends (for example a timestamp or a counter in the input). Keep inputs to what should restart it; functions are ignored, so to restart on a new selector, change the key.",
+    "arguments": ["tag"],
+    "url": "https://gyral.dev/errors/#G0080"
+  },
+  {
+    "code": "G0085",
+    "group": "Element calls (gyral-1zd.27)",
+    "message": "<{tag}> call(\"{selector}\", \"{method}\") failed",
+    "arguments": ["tag", "selector", "method"],
+    "url": "https://gyral.dev/errors/#G0085"
+  },
+  {
+    "code": "G0086",
+    "group": "Element calls (gyral-1zd.27)",
+    "message": "call(\"{selector}\", \"{method}\"): arguments must be plain data.",
+    "arguments": ["selector", "method"],
+    "url": "https://gyral.dev/errors/#G0086"
+  }
+]

package/dist/eslint/imports.d.ts

@@ -20,5 +20,7 @@ export declare const OPTIONS_SCHEMA: {
 }[];
 export declare function sourcesOf(context: Rule.RuleContext): readonly string[];
 export declare function findVariable(scope: Scope.Scope | null, name: string): Scope.Variable | undefined;
+/** How `id` was imported from a template source: the export's name, or `*`. */
+export declare function importedAs(context: Rule.RuleContext, id: NodeOf<'Identifier'>): string | undefined;
 /** Whether `node` (a tag or callee) is the template sources' `name` export. */
 export declare function isGyral(context: Rule.RuleContext, node: Node, name: string): boolean;

package/dist/eslint/imports.js

@@ -1,4 +1,4 @@
-// Which identifiers are Gyral's `html` and `each` (@gyral/core/eslint). Like the template
+// Which identifiers are Gyral's `html`, `svg` and `each` (@gyral/core/eslint). Like the template
 // compiler (compiler/scan.ts), a binding counts only when it is imported from a template
 // source: `import { html } from '@gyral/core'` (any local name) or `import * as g` used as
 // `g.html`. ESLint's scope analysis resolves the name, so shadowing is handled. Core's own code
@@ -46,7 +46,7 @@ export function findVariable(scope, name) {
     return undefined;
 }
 /** How `id` was imported from a template source: the export's name, or `*`. */
-function importedAs(context, id) {
+export function importedAs(context, id) {
     const variable = findVariable(context.sourceCode.getScope(id), id.name);
     const def = variable?.defs[0];
     if (def?.type !== 'ImportBinding')

package/dist/eslint/imports.js.map

@@ -1 +1 @@
-{"version":3,"file":"imports.js","sourceRoot":"","sources":["../../src/eslint/imports.ts"],"names":[],"mappings":"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","sourcesContent":["// Which identifiers are Gyral's `html` and `each` (@gyral/core/eslint). Like the template\n// compiler (compiler/scan.ts), a binding counts only when it is imported from a template\n// source: `import { html } from '@gyral/core'` (any local name) or `import * as g` used as\n// `g.html`. ESLint's scope analysis resolves the name, so shadowing is handled. Core's own code\n// and tests import from core's modules by relative path; those count too.\nimport { dirname, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { Rule, Scope } from 'eslint';\n\nexport type Node = Rule.Node;\nexport type NodeOf<T extends Node['type']> = Extract<Node, { type: T }>;\n\n/** The default template sources, as in the Vite preset's `sources` option. */\nexport const DEFAULT_SOURCES: readonly string[] = ['@gyral/core'];\n\n/** The options both rules take. */\nexport const OPTIONS_SCHEMA = [\n  {\n    type: 'object',\n    properties: { sources: { type: 'array', items: { type: 'string' } } },\n    additionalProperties: false,\n  },\n];\n\n/** Core's modules that export `html` and `each` (this file is src/eslint/ or dist/eslint/). */\nconst CORE_MODULES = ['../index', '../view/index', '../view/template', '../view/render/values']\n  .flatMap((name) => ['.ts', '.js'].map((ext) => new URL(`${name}${ext}`, import.meta.url)))\n  .map((url) => fileURLToPath(url));\n\nexport function sourcesOf(context: Rule.RuleContext): readonly string[] {\n  const options: unknown = context.options[0];\n  const sources =\n    typeof options === 'object' && options !== null && 'sources' in options\n      ? options.sources\n      : undefined;\n  return Array.isArray(sources)\n    ? sources.filter((s): s is string => typeof s === 'string')\n    : DEFAULT_SOURCES;\n}\n\nfunction isSource(context: Rule.RuleContext, specifier: string): boolean {\n  if (sourcesOf(context).includes(specifier)) return true;\n  if (!specifier.startsWith('.')) return false;\n  return CORE_MODULES.includes(resolve(dirname(context.filename), specifier));\n}\n\n/** typescript-eslint's `import type` marker (not in ESTree). */\nconst typeOnly = (node: object): boolean => 'importKind' in node && node.importKind === 'type';\n\nexport function findVariable(scope: Scope.Scope | null, name: string): Scope.Variable | undefined {\n  for (let s = scope; s !== null; s = s.upper) {\n    const v = s.set.get(name);\n    if (v !== undefined) return v;\n  }\n  return undefined;\n}\n\n/** How `id` was imported from a template source: the export's name, or `*`. */\nfunction importedAs(context: Rule.RuleContext, id: NodeOf<'Identifier'>): string | undefined {\n  const variable = findVariable(context.sourceCode.getScope(id), id.name);\n  const def = variable?.defs[0];\n  if (def?.type !== 'ImportBinding') return undefined;\n  const declaration = def.parent;\n  if (typeOnly(declaration) || !isSource(context, String(declaration.source.value))) {\n    return undefined;\n  }\n  const spec = def.node;\n  if (spec.type === 'ImportNamespaceSpecifier') return '*';\n  if (spec.type !== 'ImportSpecifier' || typeOnly(spec)) return undefined;\n  const { imported } = spec;\n  return imported.type === 'Identifier' ? imported.name : String(imported.value);\n}\n\n/** Whether `node` (a tag or callee) is the template sources' `name` export. */\nexport function isGyral(context: Rule.RuleContext, node: Node, name: string): boolean {\n  if (node.type === 'Identifier') return importedAs(context, node) === name;\n  if (node.type !== 'MemberExpression' || node.computed || node.object.type !== 'Identifier') {\n    return false;\n  }\n  const { property } = node;\n  return (\n    property.type === 'Identifier' &&\n    property.name === name &&\n    importedAs(context, node.object as NodeOf<'Identifier'>) === '*'\n  );\n}\n"]}
+{"version":3,"file":"imports.js","sourceRoot":"","sources":["../../src/eslint/imports.ts"],"names":[],"mappings":"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","sourcesContent":["// Which identifiers are Gyral's `html`, `svg` and `each` (@gyral/core/eslint). Like the template\n// compiler (compiler/scan.ts), a binding counts only when it is imported from a template\n// source: `import { html } from '@gyral/core'` (any local name) or `import * as g` used as\n// `g.html`. ESLint's scope analysis resolves the name, so shadowing is handled. Core's own code\n// and tests import from core's modules by relative path; those count too.\nimport { dirname, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { Rule, Scope } from 'eslint';\n\nexport type Node = Rule.Node;\nexport type NodeOf<T extends Node['type']> = Extract<Node, { type: T }>;\n\n/** The default template sources, as in the Vite preset's `sources` option. */\nexport const DEFAULT_SOURCES: readonly string[] = ['@gyral/core'];\n\n/** The options both rules take. */\nexport const OPTIONS_SCHEMA = [\n  {\n    type: 'object',\n    properties: { sources: { type: 'array', items: { type: 'string' } } },\n    additionalProperties: false,\n  },\n];\n\n/** Core's modules that export `html` and `each` (this file is src/eslint/ or dist/eslint/). */\nconst CORE_MODULES = ['../index', '../view/index', '../view/template', '../view/render/values']\n  .flatMap((name) => ['.ts', '.js'].map((ext) => new URL(`${name}${ext}`, import.meta.url)))\n  .map((url) => fileURLToPath(url));\n\nexport function sourcesOf(context: Rule.RuleContext): readonly string[] {\n  const options: unknown = context.options[0];\n  const sources =\n    typeof options === 'object' && options !== null && 'sources' in options\n      ? options.sources\n      : undefined;\n  return Array.isArray(sources)\n    ? sources.filter((s): s is string => typeof s === 'string')\n    : DEFAULT_SOURCES;\n}\n\nfunction isSource(context: Rule.RuleContext, specifier: string): boolean {\n  if (sourcesOf(context).includes(specifier)) return true;\n  if (!specifier.startsWith('.')) return false;\n  return CORE_MODULES.includes(resolve(dirname(context.filename), specifier));\n}\n\n/** typescript-eslint's `import type` marker (not in ESTree). */\nconst typeOnly = (node: object): boolean => 'importKind' in node && node.importKind === 'type';\n\nexport function findVariable(scope: Scope.Scope | null, name: string): Scope.Variable | undefined {\n  for (let s = scope; s !== null; s = s.upper) {\n    const v = s.set.get(name);\n    if (v !== undefined) return v;\n  }\n  return undefined;\n}\n\n/** How `id` was imported from a template source: the export's name, or `*`. */\nexport function importedAs(\n  context: Rule.RuleContext,\n  id: NodeOf<'Identifier'>,\n): string | undefined {\n  const variable = findVariable(context.sourceCode.getScope(id), id.name);\n  const def = variable?.defs[0];\n  if (def?.type !== 'ImportBinding') return undefined;\n  const declaration = def.parent;\n  if (typeOnly(declaration) || !isSource(context, String(declaration.source.value))) {\n    return undefined;\n  }\n  const spec = def.node;\n  if (spec.type === 'ImportNamespaceSpecifier') return '*';\n  if (spec.type !== 'ImportSpecifier' || typeOnly(spec)) return undefined;\n  const { imported } = spec;\n  return imported.type === 'Identifier' ? imported.name : String(imported.value);\n}\n\n/** Whether `node` (a tag or callee) is the template sources' `name` export. */\nexport function isGyral(context: Rule.RuleContext, node: Node, name: string): boolean {\n  if (node.type === 'Identifier') return importedAs(context, node) === name;\n  if (node.type !== 'MemberExpression' || node.computed || node.object.type !== 'Identifier') {\n    return false;\n  }\n  const { property } = node;\n  return (\n    property.type === 'Identifier' &&\n    property.name === name &&\n    importedAs(context, node.object as NodeOf<'Identifier'>) === '*'\n  );\n}\n"]}

package/dist/eslint/index.d.ts

@@ -1,10 +1,12 @@
 import type { ESLint, Linter } from 'eslint';
 import { rowPurityRule } from './row-purity-rule.js';
 import { templateRule } from './template-rule.js';
+import { unusedIntentRule } from './unused-intent-rule.js';
 export interface GyralPlugin extends ESLint.Plugin {
     readonly rules: {
         readonly template: typeof templateRule;
         readonly 'each-row-purity': typeof rowPurityRule;
+        readonly 'unused-intent': typeof unusedIntentRule;
     };
     readonly configs: {
         readonly recommended: Linter.Config;
@@ -12,4 +14,3 @@ export interface GyralPlugin extends ESLint.Plugin {
 }
 declare const plugin: GyralPlugin;
 export default plugin;
-export { rowPurityRule, templateRule };

package/dist/eslint/index.js

@@ -1,6 +1,11 @@
 import { rowPurityRule } from './row-purity-rule.js';
 import { templateRule } from './template-rule.js';
-const rules = { template: templateRule, 'each-row-purity': rowPurityRule };
+import { unusedIntentRule } from './unused-intent-rule.js';
+const rules = {
+    template: templateRule,
+    'each-row-purity': rowPurityRule,
+    'unused-intent': unusedIntentRule,
+};
 const configs = { recommended: {} };
 const plugin = { meta: { name: '@gyral/core/eslint' }, rules, configs };
 // The config names the plugin object itself, so it can be combined with configs that register
@@ -8,8 +13,11 @@ const plugin = { meta: { name: '@gyral/core/eslint' }, rules, configs };
 configs.recommended = {
     name: 'gyral/recommended',
     plugins: { gyral: plugin },
-    rules: { 'gyral/template': 'error', 'gyral/each-row-purity': 'error' },
+    rules: {
+        'gyral/template': 'error',
+        'gyral/each-row-purity': 'error',
+        'gyral/unused-intent': 'warn',
+    },
 };
 export default plugin;
-export { rowPurityRule, templateRule };
 //# sourceMappingURL=index.js.map

package/dist/eslint/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/eslint/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUlD,MAAM,KAAK,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,CAAC;AAC3E,MAAM,OAAO,GAAmC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;AAEpE,MAAM,MAAM,GAAgB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAErF,8FAA8F;AAC9F,4EAA4E;AAC5E,OAAO,CAAC,WAAW,GAAG;IACpB,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;IAC1B,KAAK,EAAE,EAAE,gBAAgB,EAAE,OAAO,EAAE,uBAAuB,EAAE,OAAO,EAAE;CACvE,CAAC;AAEF,eAAe,MAAM,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC","sourcesContent":["// @gyral/core/eslint: the template rules (view/09-template-rules.md) in the editor, as an\n// ESLint flat-config plugin. ESLint is an optional peer dependency; nothing here reaches a\n// browser or server bundle.\n//\n//   import gyral from '@gyral/core/eslint';\n//   export default [gyral.configs.recommended];\nimport type { ESLint, Linter } from 'eslint';\nimport { rowPurityRule } from './row-purity-rule.js';\nimport { templateRule } from './template-rule.js';\n\nexport interface GyralPlugin extends ESLint.Plugin {\n  readonly rules: {\n    readonly template: typeof templateRule;\n    readonly 'each-row-purity': typeof rowPurityRule;\n  };\n  readonly configs: { readonly recommended: Linter.Config };\n}\n\nconst rules = { template: templateRule, 'each-row-purity': rowPurityRule };\nconst configs: { recommended: Linter.Config } = { recommended: {} };\n\nconst plugin: GyralPlugin = { meta: { name: '@gyral/core/eslint' }, rules, configs };\n\n// The config names the plugin object itself, so it can be combined with configs that register\n// `gyral` too (ESLint rejects two different objects under one plugin name).\nconfigs.recommended = {\n  name: 'gyral/recommended',\n  plugins: { gyral: plugin },\n  rules: { 'gyral/template': 'error', 'gyral/each-row-purity': 'error' },\n};\n\nexport default plugin;\nexport { rowPurityRule, templateRule };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/eslint/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAW3D,MAAM,KAAK,GAAG;IACZ,QAAQ,EAAE,YAAY;IACtB,iBAAiB,EAAE,aAAa;IAChC,eAAe,EAAE,gBAAgB;CAClC,CAAC;AACF,MAAM,OAAO,GAAmC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;AAEpE,MAAM,MAAM,GAAgB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAErF,8FAA8F;AAC9F,4EAA4E;AAC5E,OAAO,CAAC,WAAW,GAAG;IACpB,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;IAC1B,KAAK,EAAE;QACL,gBAAgB,EAAE,OAAO;QACzB,uBAAuB,EAAE,OAAO;QAChC,qBAAqB,EAAE,MAAM;KAC9B;CACF,CAAC;AAEF,eAAe,MAAM,CAAC","sourcesContent":["// @gyral/core/eslint: the template rules (view/09-template-rules.md) in the editor, as an\n// ESLint flat-config plugin. ESLint is an optional peer dependency; nothing here reaches a\n// browser or server bundle.\n//\n//   import gyral from '@gyral/core/eslint';\n//   export default [gyral.configs.recommended];\nimport type { ESLint, Linter } from 'eslint';\nimport { rowPurityRule } from './row-purity-rule.js';\nimport { templateRule } from './template-rule.js';\nimport { unusedIntentRule } from './unused-intent-rule.js';\n\nexport interface GyralPlugin extends ESLint.Plugin {\n  readonly rules: {\n    readonly template: typeof templateRule;\n    readonly 'each-row-purity': typeof rowPurityRule;\n    readonly 'unused-intent': typeof unusedIntentRule;\n  };\n  readonly configs: { readonly recommended: Linter.Config };\n}\n\nconst rules = {\n  template: templateRule,\n  'each-row-purity': rowPurityRule,\n  'unused-intent': unusedIntentRule,\n};\nconst configs: { recommended: Linter.Config } = { recommended: {} };\n\nconst plugin: GyralPlugin = { meta: { name: '@gyral/core/eslint' }, rules, configs };\n\n// The config names the plugin object itself, so it can be combined with configs that register\n// `gyral` too (ESLint rejects two different objects under one plugin name).\nconfigs.recommended = {\n  name: 'gyral/recommended',\n  plugins: { gyral: plugin },\n  rules: {\n    'gyral/template': 'error',\n    'gyral/each-row-purity': 'error',\n    'gyral/unused-intent': 'warn',\n  },\n};\n\nexport default plugin;\n"]}

package/dist/eslint/template-rule.d.ts

@@ -2,4 +2,5 @@ import type { Rule } from 'eslint';
 import { TemplateError } from '../view/index.js';
 /** The message ESLint shows: the TemplateError's first line (rule, fix and spec section). */
 export declare const messageOf: (error: TemplateError) => string;
+export declare const CLOSURE: string;
 export declare const templateRule: Rule.RuleModule;

package/dist/eslint/template-rule.js

@@ -3,7 +3,10 @@ import { isGyral, OPTIONS_SCHEMA } from './imports.js';
 import { cookedMap, errorSpan } from './locate.js';
 /** The message ESLint shows: the TemplateError's first line (rule, fix and spec section). */
 export const messageOf = (error) => error.message.split('\n')[0] ?? '';
-const INVALID_ESCAPE = 'This html template has an invalid escape sequence, so it has no string value at runtime. ' +
+export const CLOSURE = 'Views attach no closures: a function in a template hole is an event handler or a callback. ' +
+    'Name an intent with data-intent=${i.Name} for events, pass data to components (they answer ' +
+    'with outputs), and put behaviour on an element in a hook (view/02-bindings.md "Properties").';
+const INVALID_ESCAPE = 'This template has an invalid escape sequence, so it has no string value at runtime. ' +
     'Fix the escape (write \\\\ for a backslash).';
 function quasisOf(context, node) {
     const text = context.sourceCode.text;
@@ -28,25 +31,32 @@ export const templateRule = {
     meta: {
         type: 'problem',
         docs: {
-            description: 'Template rules for html`…` (view/09-template-rules.md): the same checks and messages ' +
+            description: 'Template rules for html`…` and svg`…` (view/09-template-rules.md): the same checks and messages ' +
                 'as the template compiler and the development runtime.',
             recommended: true,
             url: 'https://github.com/gyraljs/gyral/blob/main/docs/design-docs/view/09-template-rules.md',
         },
         schema: OPTIONS_SCHEMA,
-        messages: { rule: '{{message}}', escape: INVALID_ESCAPE },
+        messages: { rule: '{{message}}', escape: INVALID_ESCAPE, closure: CLOSURE },
     },
     create(context) {
         return {
             TaggedTemplateExpression(node) {
-                if (!isGyral(context, node.tag, 'html'))
+                const tag = node.tag;
+                const svg = isGyral(context, tag, 'svg');
+                if (!svg && !isGyral(context, tag, 'html'))
                     return;
+                for (const value of node.quasi.expressions) {
+                    if (value.type === 'ArrowFunctionExpression' || value.type === 'FunctionExpression') {
+                        context.report({ node: value, messageId: 'closure' });
+                    }
+                }
                 const parts = quasisOf(context, node.quasi);
                 if (parts === undefined) {
                     context.report({ node: node.quasi, messageId: 'escape' });
                     return;
                 }
-                const issue = checkTemplate(parts.cooked);
+                const issue = checkTemplate(parts.cooked, svg);
                 if (issue === undefined)
                     return;
                 const span = errorSpan(parts.quasis, parts.cooked, issue.strings, issue.at, issue.from);

package/dist/eslint/template-rule.js.map

@@ -1 +1 @@
-{"version":3,"file":"template-rule.js","sourceRoot":"","sources":["../../src/eslint/template-rule.ts"],"names":[],"mappings":"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","sourcesContent":["// gyral/template: the template rules of view/09-template-rules.md, in the editor. Every html`…`\n// whose tag is imported from a template source goes through the normalizer's own check\n// (view/normalize/check.ts), the one rule set the compiler and the development runtime use, so\n// the message is the same TemplateError message (minus the `near:`/`at` context, which the\n// editor's location replaces). Not checked here: rule 7's parse5 comparison (compiler only) and\n// the browser's own parse (runtime only); rule 11 (a page shell is fine on the server).\nimport type { Rule } from 'eslint';\nimport { checkTemplate, TemplateError } from '../view/index.js';\nimport { isGyral, OPTIONS_SCHEMA } from './imports.js';\nimport { cookedMap, errorSpan, type Quasi } from './locate.js';\n\n/** The message ESLint shows: the TemplateError's first line (rule, fix and spec section). */\nexport const messageOf = (error: TemplateError): string => error.message.split('\\n')[0] ?? '';\n\nconst INVALID_ESCAPE =\n  'This html template has an invalid escape sequence, so it has no string value at runtime. ' +\n  'Fix the escape (write \\\\\\\\ for a backslash).';\n\n/** What this rule reads of a TemplateElement (ESTree's, or typescript-eslint's). */\ninterface QuasiNode {\n  readonly value: { readonly cooked?: string | null | undefined };\n  readonly range?: [number, number] | undefined;\n  readonly tail: boolean;\n}\n\nfunction quasisOf(\n  context: Rule.RuleContext,\n  node: { readonly quasis: readonly QuasiNode[] },\n): { quasis: Quasi[]; cooked: string[] } | undefined {\n  const text = context.sourceCode.text;\n  const quasis: Quasi[] = [];\n  const cooked: string[] = [];\n  for (const q of node.quasis) {\n    const value = q.value.cooked;\n    if (typeof value !== 'string') return undefined;\n    const [from, to] = q.range ?? [0, 0];\n    // Parsers include the delimiters (` or } before, ` or ${ after) in the element's range.\n    const start = text.charAt(from) === '`' || text.charAt(from) === '}' ? from + 1 : from;\n    const end = q.tail ? to - 1 : to - 2;\n    // Undecodable (it shouldn't be): point at the quasi's start.\n    const map = cookedMap(text.slice(start, end), value) ?? Array<number>(value.length + 1).fill(0);\n    quasis.push({ start, end, map });\n    cooked.push(value);\n  }\n  return { quasis, cooked };\n}\n\nexport const templateRule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Template rules for html`…` (view/09-template-rules.md): the same checks and messages ' +\n        'as the template compiler and the development runtime.',\n      recommended: true,\n      url: 'https://github.com/gyraljs/gyral/blob/main/docs/design-docs/view/09-template-rules.md',\n    },\n    schema: OPTIONS_SCHEMA,\n    messages: { rule: '{{message}}', escape: INVALID_ESCAPE },\n  },\n  create(context) {\n    return {\n      TaggedTemplateExpression(node) {\n        if (!isGyral(context, node.tag as Rule.Node, 'html')) return;\n        const parts = quasisOf(context, node.quasi);\n        if (parts === undefined) {\n          context.report({ node: node.quasi, messageId: 'escape' });\n          return;\n        }\n        const issue = checkTemplate(parts.cooked);\n        if (issue === undefined) return;\n        const span = errorSpan(parts.quasis, parts.cooked, issue.strings, issue.at, issue.from);\n        const { sourceCode } = context;\n        context.report({\n          loc: {\n            start: sourceCode.getLocFromIndex(span.start),\n            end: sourceCode.getLocFromIndex(Math.max(span.end, span.start)),\n          },\n          messageId: 'rule',\n          data: { message: messageOf(issue.error) },\n        });\n      },\n    };\n  },\n};\n"]}
+{"version":3,"file":"template-rule.js","sourceRoot":"","sources":["../../src/eslint/template-rule.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAc,MAAM,aAAa,CAAC;AAE/D,6FAA6F;AAC7F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAoB,EAAU,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAE9F,MAAM,CAAC,MAAM,OAAO,GAClB,6FAA6F;IAC7F,6FAA6F;IAC7F,8FAA8F,CAAC;AAEjG,MAAM,cAAc,GAClB,sFAAsF;IACtF,8CAA8C,CAAC;AASjD,SAAS,QAAQ,CACf,OAAyB,EACzB,IAA+C;IAE/C,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;IACrC,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;QAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChD,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,wFAAwF;QACxF,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACvF,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACrC,6DAA6D;QAC7D,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,IAAI,KAAK,CAAS,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChG,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EACT,kGAAkG;gBAClG,uDAAuD;YACzD,WAAW,EAAE,IAAI;YACjB,GAAG,EAAE,uFAAuF;SAC7F;QACD,MAAM,EAAE,cAAc;QACtB,QAAQ,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE;KAC5E;IACD,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,wBAAwB,CAAC,IAAI;gBAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAgB,CAAC;gBAClC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;gBACzC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC;oBAAE,OAAO;gBACnD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;oBAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,yBAAyB,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;wBACpF,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;oBACxD,CAAC;gBACH,CAAC;gBACD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC5C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;oBAC1D,OAAO;gBACT,CAAC;gBACD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAC/C,IAAI,KAAK,KAAK,SAAS;oBAAE,OAAO;gBAChC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBACxF,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;gBAC/B,OAAO,CAAC,MAAM,CAAC;oBACb,GAAG,EAAE;wBACH,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;wBAC7C,GAAG,EAAE,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;qBAChE;oBACD,SAAS,EAAE,MAAM;oBACjB,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;iBAC1C,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC","sourcesContent":["// gyral/template: the template rules of view/09-template-rules.md, in the editor. Every html`…`\n// (and svg`…`) whose tag is imported from a template source goes through the normalizer's own check\n// (view/normalize/check.ts), the one rule set the compiler and the development runtime use, so\n// the message is the same TemplateError message (minus the `near:`/`at` context, which the\n// editor's location replaces). Not checked here: rule 7's parse5 comparison (compiler only) and\n// the browser's own parse (runtime only); rule 11 (a page shell is fine on the server). Also\n// reported: a function written directly in a hole (`.onclick=${() => …}`), since views attach\n// no closures (view/02-bindings.md \"Properties\"; the runtime warns for property bindings).\nimport type { Rule } from 'eslint';\nimport { checkTemplate, TemplateError } from '../view/index.js';\nimport { isGyral, OPTIONS_SCHEMA } from './imports.js';\nimport { cookedMap, errorSpan, type Quasi } from './locate.js';\n\n/** The message ESLint shows: the TemplateError's first line (rule, fix and spec section). */\nexport const messageOf = (error: TemplateError): string => error.message.split('\\n')[0] ?? '';\n\nexport const CLOSURE =\n  'Views attach no closures: a function in a template hole is an event handler or a callback. ' +\n  'Name an intent with data-intent=${i.Name} for events, pass data to components (they answer ' +\n  'with outputs), and put behaviour on an element in a hook (view/02-bindings.md \"Properties\").';\n\nconst INVALID_ESCAPE =\n  'This template has an invalid escape sequence, so it has no string value at runtime. ' +\n  'Fix the escape (write \\\\\\\\ for a backslash).';\n\n/** What this rule reads of a TemplateElement (ESTree's, or typescript-eslint's). */\ninterface QuasiNode {\n  readonly value: { readonly cooked?: string | null | undefined };\n  readonly range?: [number, number] | undefined;\n  readonly tail: boolean;\n}\n\nfunction quasisOf(\n  context: Rule.RuleContext,\n  node: { readonly quasis: readonly QuasiNode[] },\n): { quasis: Quasi[]; cooked: string[] } | undefined {\n  const text = context.sourceCode.text;\n  const quasis: Quasi[] = [];\n  const cooked: string[] = [];\n  for (const q of node.quasis) {\n    const value = q.value.cooked;\n    if (typeof value !== 'string') return undefined;\n    const [from, to] = q.range ?? [0, 0];\n    // Parsers include the delimiters (` or } before, ` or ${ after) in the element's range.\n    const start = text.charAt(from) === '`' || text.charAt(from) === '}' ? from + 1 : from;\n    const end = q.tail ? to - 1 : to - 2;\n    // Undecodable (it shouldn't be): point at the quasi's start.\n    const map = cookedMap(text.slice(start, end), value) ?? Array<number>(value.length + 1).fill(0);\n    quasis.push({ start, end, map });\n    cooked.push(value);\n  }\n  return { quasis, cooked };\n}\n\nexport const templateRule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Template rules for html`…` and svg`…` (view/09-template-rules.md): the same checks and messages ' +\n        'as the template compiler and the development runtime.',\n      recommended: true,\n      url: 'https://github.com/gyraljs/gyral/blob/main/docs/design-docs/view/09-template-rules.md',\n    },\n    schema: OPTIONS_SCHEMA,\n    messages: { rule: '{{message}}', escape: INVALID_ESCAPE, closure: CLOSURE },\n  },\n  create(context) {\n    return {\n      TaggedTemplateExpression(node) {\n        const tag = node.tag as Rule.Node;\n        const svg = isGyral(context, tag, 'svg');\n        if (!svg && !isGyral(context, tag, 'html')) return;\n        for (const value of node.quasi.expressions) {\n          if (value.type === 'ArrowFunctionExpression' || value.type === 'FunctionExpression') {\n            context.report({ node: value, messageId: 'closure' });\n          }\n        }\n        const parts = quasisOf(context, node.quasi);\n        if (parts === undefined) {\n          context.report({ node: node.quasi, messageId: 'escape' });\n          return;\n        }\n        const issue = checkTemplate(parts.cooked, svg);\n        if (issue === undefined) return;\n        const span = errorSpan(parts.quasis, parts.cooked, issue.strings, issue.at, issue.from);\n        const { sourceCode } = context;\n        context.report({\n          loc: {\n            start: sourceCode.getLocFromIndex(span.start),\n            end: sourceCode.getLocFromIndex(Math.max(span.end, span.start)),\n          },\n          messageId: 'rule',\n          data: { message: messageOf(issue.error) },\n        });\n      },\n    };\n  },\n};\n"]}

package/dist/eslint/unused-intent-rule.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from 'eslint';
+export declare const unusedIntentRule: Rule.RuleModule;