@gyral/core 0.2.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

@@ -0,0 +1,26 @@
+import type { Rule, Scope } from 'eslint';
+export type Node = Rule.Node;
+export type NodeOf<T extends Node['type']> = Extract<Node, {
+    type: T;
+}>;
+/** The default template sources, as in the Vite preset's `sources` option. */
+export declare const DEFAULT_SOURCES: readonly string[];
+/** The options both rules take. */
+export declare const OPTIONS_SCHEMA: {
+    type: string;
+    properties: {
+        sources: {
+            type: string;
+            items: {
+                type: string;
+            };
+        };
+    };
+    additionalProperties: boolean;
+}[];
+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

@@ -0,0 +1,78 @@
+// 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
+// and tests import from core's modules by relative path; those count too.
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** The default template sources, as in the Vite preset's `sources` option. */
+export const DEFAULT_SOURCES = ['@gyral/core'];
+/** The options both rules take. */
+export const OPTIONS_SCHEMA = [
+    {
+        type: 'object',
+        properties: { sources: { type: 'array', items: { type: 'string' } } },
+        additionalProperties: false,
+    },
+];
+/** Core's modules that export `html` and `each` (this file is src/eslint/ or dist/eslint/). */
+const CORE_MODULES = ['../index', '../view/index', '../view/template', '../view/render/values']
+    .flatMap((name) => ['.ts', '.js'].map((ext) => new URL(`${name}${ext}`, import.meta.url)))
+    .map((url) => fileURLToPath(url));
+export function sourcesOf(context) {
+    const options = context.options[0];
+    const sources = typeof options === 'object' && options !== null && 'sources' in options
+        ? options.sources
+        : undefined;
+    return Array.isArray(sources)
+        ? sources.filter((s) => typeof s === 'string')
+        : DEFAULT_SOURCES;
+}
+function isSource(context, specifier) {
+    if (sourcesOf(context).includes(specifier))
+        return true;
+    if (!specifier.startsWith('.'))
+        return false;
+    return CORE_MODULES.includes(resolve(dirname(context.filename), specifier));
+}
+/** typescript-eslint's `import type` marker (not in ESTree). */
+const typeOnly = (node) => 'importKind' in node && node.importKind === 'type';
+export function findVariable(scope, name) {
+    for (let s = scope; s !== null; s = s.upper) {
+        const v = s.set.get(name);
+        if (v !== undefined)
+            return v;
+    }
+    return undefined;
+}
+/** How `id` was imported from a template source: the export's name, or `*`. */
+export function importedAs(context, id) {
+    const variable = findVariable(context.sourceCode.getScope(id), id.name);
+    const def = variable?.defs[0];
+    if (def?.type !== 'ImportBinding')
+        return undefined;
+    const declaration = def.parent;
+    if (typeOnly(declaration) || !isSource(context, String(declaration.source.value))) {
+        return undefined;
+    }
+    const spec = def.node;
+    if (spec.type === 'ImportNamespaceSpecifier')
+        return '*';
+    if (spec.type !== 'ImportSpecifier' || typeOnly(spec))
+        return undefined;
+    const { imported } = spec;
+    return imported.type === 'Identifier' ? imported.name : String(imported.value);
+}
+/** Whether `node` (a tag or callee) is the template sources' `name` export. */
+export function isGyral(context, node, name) {
+    if (node.type === 'Identifier')
+        return importedAs(context, node) === name;
+    if (node.type !== 'MemberExpression' || node.computed || node.object.type !== 'Identifier') {
+        return false;
+    }
+    const { property } = node;
+    return (property.type === 'Identifier' &&
+        property.name === name &&
+        importedAs(context, node.object) === '*');
+}
+//# sourceMappingURL=imports.js.map

package/dist/eslint/imports.js.map

@@ -0,0 +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`, `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

@@ -0,0 +1,16 @@
+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;
+    };
+}
+declare const plugin: GyralPlugin;
+export default plugin;

package/dist/eslint/index.js

@@ -0,0 +1,23 @@
+import { rowPurityRule } from './row-purity-rule.js';
+import { templateRule } from './template-rule.js';
+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
+// `gyral` too (ESLint rejects two different objects under one plugin name).
+configs.recommended = {
+    name: 'gyral/recommended',
+    plugins: { gyral: plugin },
+    rules: {
+        'gyral/template': 'error',
+        'gyral/each-row-purity': 'error',
+        'gyral/unused-intent': 'warn',
+    },
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/eslint/index.js.map

@@ -0,0 +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;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/locate.d.ts

@@ -0,0 +1,33 @@
+/** One quasi of a template literal: where its text starts in the file, and its offset map. */
+export interface Quasi {
+    /** File offset of the quasi's first character (after the backtick or `}`). */
+    readonly start: number;
+    /** File offset where the quasi's text ends (at the closing backtick or `${`). */
+    readonly end: number;
+    /** For each cooked offset (and one past the end), the offset in the source text. */
+    readonly map: readonly number[];
+}
+/**
+ * Maps each offset of the cooked string to the source text it came from. Returns undefined when
+ * decoding `text` doesn't give `cooked` (the caller then points at the quasi's start).
+ */
+export declare function cookedMap(text: string, cooked: string): number[] | undefined;
+/**
+ * Maps each offset of `minified` (and one past its end) to `original`. The minifier only
+ * collapses a whitespace run to one space or drops it, and copies everything else.
+ */
+export declare function minifiedMap(original: string, minified: string): number[];
+/** A source range, as file offsets. */
+export interface Span {
+    readonly start: number;
+    readonly end: number;
+}
+/** A position in the normalizer's minified strings: string index, offset (view/normalize/check.ts). */
+type At = readonly [index: number, offset: number];
+/**
+ * The range to report for a template's first error: the token the tree builder was handling
+ * (a tag, an end tag, text) when it has one; the whole `${…}` when the error is at a hole
+ * (including `<${…}>`, where the tag name would be); else the character the tokenizer stopped at.
+ */
+export declare function errorSpan(quasis: readonly Quasi[], originals: readonly string[], minified: readonly string[], at: At, from: At | undefined): Span;
+export {};

package/dist/eslint/locate.js

@@ -0,0 +1,132 @@
+// Where a template rule error is in the source (@gyral/core/eslint, view/09-template-rules.md).
+// The normalizer reports the string and offset it stopped at, in the whitespace-minified cooked
+// strings. Three maps lead back to the file: minified → cooked (whitespace runs the minifier
+// collapsed or dropped), cooked → source text (escapes, line continuations and CRLF, which the
+// cooked string spells differently), and the quasi's place in the file.
+const SIMPLE = {
+    n: '\n',
+    t: '\t',
+    r: '\r',
+    b: '\b',
+    f: '\f',
+    v: '\v',
+};
+const LINE_END = /[\n\r\u2028\u2029]/;
+/** The length of the escape sequence at `k` (after its backslash) and the text it cooks to. */
+function escape(text, k) {
+    const c = text.charAt(k);
+    const simple = SIMPLE[c];
+    if (simple !== undefined)
+        return { length: 1, value: simple };
+    if (c === '\r')
+        return { length: text.charAt(k + 1) === '\n' ? 2 : 1, value: '' };
+    if (LINE_END.test(c))
+        return { length: 1, value: '' };
+    if (c === '0' && !/[0-9]/.test(text.charAt(k + 1)))
+        return { length: 1, value: '\0' };
+    const hex = c === 'x'
+        ? /^x([0-9a-fA-F]{2})/.exec(text.slice(k))
+        : c === 'u'
+            ? /^u(?:([0-9a-fA-F]{4})|\{([0-9a-fA-F]+)\})/.exec(text.slice(k))
+            : null;
+    if (hex !== null) {
+        const code = Number.parseInt(hex[1] ?? hex[2] ?? '0', 16);
+        return { length: hex[0].length, value: String.fromCodePoint(code) };
+    }
+    return { length: c.length, value: c };
+}
+/**
+ * Maps each offset of the cooked string to the source text it came from. Returns undefined when
+ * decoding `text` doesn't give `cooked` (the caller then points at the quasi's start).
+ */
+export function cookedMap(text, cooked) {
+    const map = [];
+    let out = '';
+    let k = 0;
+    while (k < text.length) {
+        const c = text.charAt(k);
+        let length = 1;
+        let value = c;
+        if (c === '\\') {
+            const e = escape(text, k + 1);
+            length = 1 + e.length;
+            value = e.value;
+        }
+        else if (c === '\r') {
+            length = text.charAt(k + 1) === '\n' ? 2 : 1;
+            value = '\n';
+        }
+        for (let n = 0; n < value.length; n++)
+            map.push(k);
+        out += value;
+        k += length;
+    }
+    map.push(text.length);
+    return out === cooked ? map : undefined;
+}
+const isWs = (c) => c === ' ' || c === '\t' || c === '\n' || c === '\r' || c === '\f';
+/**
+ * Maps each offset of `minified` (and one past its end) to `original`. The minifier only
+ * collapses a whitespace run to one space or drops it, and copies everything else.
+ */
+export function minifiedMap(original, minified) {
+    const map = [];
+    let a = 0;
+    for (let b = 0; b < minified.length; b++) {
+        const c = minified.charAt(b);
+        // A dropped run: skip it.
+        while (c !== ' ' && isWs(original.charAt(a)) && original.charAt(a) !== c)
+            a++;
+        map.push(a);
+        // A run collapsed to this space (one that starts with a space is copied char by char,
+        // and its rest skipped as dropped before the next character).
+        if (c === ' ' && original.charAt(a) !== ' ' && isWs(original.charAt(a))) {
+            while (isWs(original.charAt(a)))
+                a++;
+        }
+        else if (a < original.length)
+            a++;
+    }
+    map.push(original.length);
+    return map;
+}
+/**
+ * The range to report for a template's first error: the token the tree builder was handling
+ * (a tag, an end tag, text) when it has one; the whole `${…}` when the error is at a hole
+ * (including `<${…}>`, where the tag name would be); else the character the tokenizer stopped at.
+ */
+export function errorSpan(quasis, originals, minified, at, from) {
+    const maps = minified.map((m, i) => minifiedMap(originals[i] ?? '', m));
+    /** File offset where minified character `off` of string `i` starts. */
+    const startOf = (i, off) => {
+        const q = quasis[i];
+        return q === undefined ? 0 : q.start + (q.map[maps[i]?.[off] ?? 0] ?? 0);
+    };
+    /** File offset just after minified character `off - 1` of string `i`. */
+    const endOf = (i, off) => {
+        const q = quasis[i];
+        if (q === undefined)
+            return 0;
+        if (off <= 0)
+            return q.start;
+        return q.start + (q.map[(maps[i]?.[off - 1] ?? 0) + 1] ?? 0);
+    };
+    const [index, offset] = at;
+    const s = minified[index] ?? '';
+    const quasi = quasis[index];
+    const next = quasis[index + 1];
+    if (quasi === undefined)
+        return { start: 0, end: 0 };
+    if (from !== undefined && (from[0] < index || from[1] < offset)) {
+        return { start: startOf(from[0], from[1]), end: endOf(index, offset) };
+    }
+    if (next !== undefined && /^(<\/?)?$/.test(s.slice(offset))) {
+        return { start: offset < s.length ? startOf(index, offset) : quasi.end, end: next.start };
+    }
+    if (offset < s.length)
+        return { start: startOf(index, offset), end: endOf(index, offset + 1) };
+    return s.length > 0
+        ? { start: startOf(index, s.length - 1), end: endOf(index, s.length) }
+        : { start: quasi.end, end: quasi.end + 1 };
+}
+//# sourceMappingURL=locate.js.map

package/dist/eslint/locate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.js","sourceRoot":"","sources":["../../src/eslint/locate.ts"],"names":[],"mappings":"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","sourcesContent":["// Where a template rule error is in the source (@gyral/core/eslint, view/09-template-rules.md).\n// The normalizer reports the string and offset it stopped at, in the whitespace-minified cooked\n// strings. Three maps lead back to the file: minified → cooked (whitespace runs the minifier\n// collapsed or dropped), cooked → source text (escapes, line continuations and CRLF, which the\n// cooked string spells differently), and the quasi's place in the file.\n\n/** One quasi of a template literal: where its text starts in the file, and its offset map. */\nexport interface Quasi {\n  /** File offset of the quasi's first character (after the backtick or `}`). */\n  readonly start: number;\n  /** File offset where the quasi's text ends (at the closing backtick or `${`). */\n  readonly end: number;\n  /** For each cooked offset (and one past the end), the offset in the source text. */\n  readonly map: readonly number[];\n}\n\nconst SIMPLE: Readonly<Record<string, string>> = {\n  n: '\\n',\n  t: '\\t',\n  r: '\\r',\n  b: '\\b',\n  f: '\\f',\n  v: '\\v',\n};\nconst LINE_END = /[\\n\\r\\u2028\\u2029]/;\n\n/** The length of the escape sequence at `k` (after its backslash) and the text it cooks to. */\nfunction escape(text: string, k: number): { length: number; value: string } {\n  const c = text.charAt(k);\n  const simple = SIMPLE[c];\n  if (simple !== undefined) return { length: 1, value: simple };\n  if (c === '\\r') return { length: text.charAt(k + 1) === '\\n' ? 2 : 1, value: '' };\n  if (LINE_END.test(c)) return { length: 1, value: '' };\n  if (c === '0' && !/[0-9]/.test(text.charAt(k + 1))) return { length: 1, value: '\\0' };\n  const hex =\n    c === 'x'\n      ? /^x([0-9a-fA-F]{2})/.exec(text.slice(k))\n      : c === 'u'\n        ? /^u(?:([0-9a-fA-F]{4})|\\{([0-9a-fA-F]+)\\})/.exec(text.slice(k))\n        : null;\n  if (hex !== null) {\n    const code = Number.parseInt(hex[1] ?? hex[2] ?? '0', 16);\n    return { length: hex[0].length, value: String.fromCodePoint(code) };\n  }\n  return { length: c.length, value: c };\n}\n\n/**\n * Maps each offset of the cooked string to the source text it came from. Returns undefined when\n * decoding `text` doesn't give `cooked` (the caller then points at the quasi's start).\n */\nexport function cookedMap(text: string, cooked: string): number[] | undefined {\n  const map: number[] = [];\n  let out = '';\n  let k = 0;\n  while (k < text.length) {\n    const c = text.charAt(k);\n    let length = 1;\n    let value = c;\n    if (c === '\\\\') {\n      const e = escape(text, k + 1);\n      length = 1 + e.length;\n      value = e.value;\n    } else if (c === '\\r') {\n      length = text.charAt(k + 1) === '\\n' ? 2 : 1;\n      value = '\\n';\n    }\n    for (let n = 0; n < value.length; n++) map.push(k);\n    out += value;\n    k += length;\n  }\n  map.push(text.length);\n  return out === cooked ? map : undefined;\n}\n\nconst isWs = (c: string): boolean =>\n  c === ' ' || c === '\\t' || c === '\\n' || c === '\\r' || c === '\\f';\n\n/**\n * Maps each offset of `minified` (and one past its end) to `original`. The minifier only\n * collapses a whitespace run to one space or drops it, and copies everything else.\n */\nexport function minifiedMap(original: string, minified: string): number[] {\n  const map: number[] = [];\n  let a = 0;\n  for (let b = 0; b < minified.length; b++) {\n    const c = minified.charAt(b);\n    // A dropped run: skip it.\n    while (c !== ' ' && isWs(original.charAt(a)) && original.charAt(a) !== c) a++;\n    map.push(a);\n    // A run collapsed to this space (one that starts with a space is copied char by char,\n    // and its rest skipped as dropped before the next character).\n    if (c === ' ' && original.charAt(a) !== ' ' && isWs(original.charAt(a))) {\n      while (isWs(original.charAt(a))) a++;\n    } else if (a < original.length) a++;\n  }\n  map.push(original.length);\n  return map;\n}\n\n/** A source range, as file offsets. */\nexport interface Span {\n  readonly start: number;\n  readonly end: number;\n}\n\n/** A position in the normalizer's minified strings: string index, offset (view/normalize/check.ts). */\ntype At = readonly [index: number, offset: number];\n\n/**\n * The range to report for a template's first error: the token the tree builder was handling\n * (a tag, an end tag, text) when it has one; the whole `${…}` when the error is at a hole\n * (including `<${…}>`, where the tag name would be); else the character the tokenizer stopped at.\n */\nexport function errorSpan(\n  quasis: readonly Quasi[],\n  originals: readonly string[],\n  minified: readonly string[],\n  at: At,\n  from: At | undefined,\n): Span {\n  const maps = minified.map((m, i) => minifiedMap(originals[i] ?? '', m));\n  /** File offset where minified character `off` of string `i` starts. */\n  const startOf = (i: number, off: number): number => {\n    const q = quasis[i];\n    return q === undefined ? 0 : q.start + (q.map[maps[i]?.[off] ?? 0] ?? 0);\n  };\n  /** File offset just after minified character `off - 1` of string `i`. */\n  const endOf = (i: number, off: number): number => {\n    const q = quasis[i];\n    if (q === undefined) return 0;\n    if (off <= 0) return q.start;\n    return q.start + (q.map[(maps[i]?.[off - 1] ?? 0) + 1] ?? 0);\n  };\n  const [index, offset] = at;\n  const s = minified[index] ?? '';\n  const quasi = quasis[index];\n  const next = quasis[index + 1];\n  if (quasi === undefined) return { start: 0, end: 0 };\n  if (from !== undefined && (from[0] < index || from[1] < offset)) {\n    return { start: startOf(from[0], from[1]), end: endOf(index, offset) };\n  }\n  if (next !== undefined && /^(<\\/?)?$/.test(s.slice(offset))) {\n    return { start: offset < s.length ? startOf(index, offset) : quasi.end, end: next.start };\n  }\n  if (offset < s.length) return { start: startOf(index, offset), end: endOf(index, offset + 1) };\n  return s.length > 0\n    ? { start: startOf(index, s.length - 1), end: endOf(index, s.length) }\n    : { start: quasi.end, end: quasi.end + 1 };\n}\n"]}