@gyral/core 0.1.0 → 0.3.0

package/dist/vite.js

@@ -1,37 +1,162 @@
-// Vite / Vitest settings every Gyral app needs (gyral-a7r, docs/references/consumer-setup.md).
-// Plain data, no imports: safe to load from vite.config.ts and vitest.config.ts.
-/** Every Lit package: resolve exactly one copy, even when Gyral is linked from elsewhere. */
-export const LIT_PACKAGES = [
-    'lit',
-    'lit-html',
-    'lit-element',
-    '@lit/reactive-element',
-    '@lit-labs/ssr',
-    '@lit-labs/ssr-client',
-];
+// Vite / Vitest settings every Gyral app needs (gyral-a7r, docs/references/consumer-setup.md):
+// the template compiler (view/01-templates.md "Compiled") and, in serve mode, development
+// output from the dev server's SSR (view/06-server.md "Development markers"). Only Node
+// built-ins are imported up front, so it loads from vite.config.ts and vitest.config.ts in any
+// way: bundled with the config, by Node from source (type stripping), or by a Vite module
+// runner. The compiler is a plugin applied in `vite build` only, so dev servers and test runs
+// keep the runtime template path; its implementation (./compiler/) loads on the first build
+// hook, with `require` (Node loads ES modules with it too): a module runner that loaded this
+// file may be closed by then, and would reject a dynamic import().
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Where the view layer's `html` comes from: core's main entry (ADR 0018, Phase 3). */
+export const DEFAULT_TEMPLATE_SOURCES = ['@gyral/core'];
+/** The resolve condition that maps core's `#prepare` to its stub (ADR 0017's mechanism). */
+export const COMPILED_CONDITION = 'gyral-compiled';
+/** Vite 8's default resolve conditions (`defaultClientConditions`, server ones without browser). */
+export const CLIENT_CONDITIONS = ['module', 'browser', 'development|production'];
+export const SERVER_CONDITIONS = ['module', 'node', 'development|production'];
 /**
- * Lit modules that Gyral imports or re-exports. Pre-bundling them up front stops Vite from
- * discovering them mid-run, which reloads the page and fails the first browser test run.
+ * Adds the `gyral-compiled` condition to an environment, on top of the app's conditions or
+ * Vite's defaults: Vite replaces the defaults when a config names any condition.
  */
-export const LIT_PREBUNDLE = [
-    'lit',
-    'lit/directive.js',
-    'lit/static-html.js',
-    'lit/directives/class-map.js',
-    'lit/directives/keyed.js',
-    'lit/directives/live.js',
-    'lit/directives/repeat.js',
-    'lit/directives/style-map.js',
-];
+function addCondition(name, config, env) {
+    const consumer = config.consumer ?? (name === 'client' ? 'client' : 'server');
+    const client = consumer === 'client' || env.isSsrTargetWebworker === true;
+    const current = config.resolve?.conditions ?? (client ? CLIENT_CONDITIONS : SERVER_CONDITIONS);
+    if (!current.includes(COMPILED_CONDITION)) {
+        config.resolve = { ...config.resolve, conditions: [...current, COMPILED_CONDITION] };
+    }
+}
+/**
+ * The compiler's hooks. From core's TypeScript source (this workspace, `link:` checkouts) they
+ * load through Vite's module runner, as a vite.config.ts would; from the published package,
+ * with require.
+ */
+async function loadHooks(options) {
+    const settings = {
+        sources: options.sources ?? DEFAULT_TEMPLATE_SOURCES,
+        parse5: options.parse5 === false
+            ? undefined
+            : typeof options.parse5 === 'string'
+                ? options.parse5
+                : 'parse5',
+    };
+    const require = createRequire(import.meta.url);
+    if (!import.meta.url.endsWith('.ts')) {
+        return require('./compiler/hooks.js').createCompiler(settings);
+    }
+    const { runnerImport } = require('vite');
+    const nodeEnv = process.env['NODE_ENV']; // the runner sets it when unset; the build owns it
+    const { module } = await runnerImport(fileURLToPath(new URL('./compiler/hooks.ts', import.meta.url)), { configFile: false, logLevel: 'silent' });
+    if (nodeEnv === undefined)
+        delete process.env['NODE_ENV'];
+    else
+        process.env['NODE_ENV'] = nodeEnv;
+    return module.createCompiler(settings);
+}
+/** The template compiler alone (`gyralVitePreset()` includes it). */
+export function gyralTemplateCompiler(options = {}) {
+    let hooks;
+    const ready = () => {
+        if (hooks === undefined)
+            throw new Error('gyral: the template compiler is not loaded yet');
+        return hooks;
+    };
+    return {
+        name: 'gyral:template-compiler',
+        enforce: 'pre',
+        apply: 'build',
+        configEnvironment: addCondition,
+        async configResolved(config) {
+            hooks = await loadHooks(options);
+            await hooks.configResolved.call(this, config);
+        },
+        buildStart(input) {
+            return ready().buildStart.call(this, input);
+        },
+        transform: {
+            filter: { id: /\.[cm]?[jt]sx?$/, code: 'html' },
+            handler(code, id, opts) {
+                return ready().transform.call(this, code, id, opts);
+            },
+        },
+        generateBundle(output, bundle, isWrite) {
+            return ready().generateBundle.call(this, output, bundle, isWrite);
+        },
+    };
+}
+/** Gyral's packages: the dev server runs them through Vite, never Node (view/06). */
+export const GYRAL_PACKAGES = /^@gyral\//;
+function manifest(file) {
+    try {
+        return JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The installed manifest of `name`, looked up from `root` the way Node does (no exports map). */
+function installed(root, name) {
+    for (let dir = root;; dir = dirname(dir)) {
+        const found = manifest(join(dir, 'node_modules', name, 'package.json'));
+        if (found !== undefined || dirname(dir) === dir)
+            return found;
+    }
+}
+/**
+ * The app's direct dependencies that depend on a Gyral package (a design system, say). They
+ * import @gyral/core, so they must share the copy the dev server runs.
+ */
+export function gyralDependents(root) {
+    const app = manifest(join(root, 'package.json'));
+    const names = Object.keys({ ...app?.dependencies, ...app?.devDependencies });
+    return names.filter((name) => {
+        if (GYRAL_PACKAGES.test(name))
+            return false;
+        const dep = installed(root, name);
+        return Object.keys({ ...dep?.dependencies, ...dep?.peerDependencies }).some((d) => GYRAL_PACKAGES.test(d));
+    });
+}
+/**
+ * Development output from the dev server's SSR (`ssrLoadModule`, view/06 "Development
+ * markers"). Vite externalizes installed packages there and Node imports them itself, resolving
+ * core's `#view-dev` without the `development` condition (Vite's `externalConditions` only pick
+ * the entry file, not the package's own imports), so the server rendered production output.
+ * In serve mode this plugin keeps Gyral's packages, and the app's dependencies that use them,
+ * out of externalization in server environments: Vite resolves them with its conditions
+ * (`development` in dev), and they all share one copy of core. `vite build` is unaffected.
+ */
+export function gyralDevServer() {
+    let root = process.cwd();
+    return {
+        name: 'gyral:dev-server',
+        apply: 'serve',
+        config(config) {
+            root = resolve(config.root ?? process.cwd());
+        },
+        configEnvironment(name, config) {
+            const consumer = config.consumer ?? (name === 'client' ? 'client' : 'server');
+            if (consumer === 'client')
+                return undefined;
+            return { resolve: { noExternal: [GYRAL_PACKAGES, ...gyralDependents(root)] } };
+        },
+    };
+}
 /**
  * Spread into a Vite config, or into each Vitest project:
  *
  *   export default defineConfig({ ...gyralVitePreset(), build: { … } });
+ *
+ * With plugins of your own, list both: `plugins: [...preset.plugins, mine()]`.
  */
 export function gyralVitePreset(options = {}) {
     return {
-        resolve: { dedupe: [...LIT_PACKAGES] },
-        optimizeDeps: { include: [...new Set([...LIT_PREBUNDLE, ...(options.optimize ?? [])])] },
+        plugins: [gyralTemplateCompiler(options.compiler), gyralDevServer()],
+        resolve: { dedupe: [] },
+        optimizeDeps: { include: [...new Set(options.optimize ?? [])] },
     };
 }
 //# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,iFAAiF;AAEjF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,KAAK;IACL,UAAU;IACV,aAAa;IACb,uBAAuB;IACvB,eAAe;IACf,sBAAsB;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,KAAK;IACL,kBAAkB;IAClB,oBAAoB;IACpB,6BAA6B;IAC7B,yBAAyB;IACzB,wBAAwB;IACxB,0BAA0B;IAC1B,6BAA6B;CAC9B,CAAC;AAYF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,UAA4B,EAAE;IAC5D,OAAO;QACL,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC,EAAE;QACtC,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;KACzF,CAAC;AACJ,CAAC","sourcesContent":["// Vite / Vitest settings every Gyral app needs (gyral-a7r, docs/references/consumer-setup.md).\n// Plain data, no imports: safe to load from vite.config.ts and vitest.config.ts.\n\n/** Every Lit package: resolve exactly one copy, even when Gyral is linked from elsewhere. */\nexport const LIT_PACKAGES: readonly string[] = [\n  'lit',\n  'lit-html',\n  'lit-element',\n  '@lit/reactive-element',\n  '@lit-labs/ssr',\n  '@lit-labs/ssr-client',\n];\n\n/**\n * Lit modules that Gyral imports or re-exports. Pre-bundling them up front stops Vite from\n * discovering them mid-run, which reloads the page and fails the first browser test run.\n */\nexport const LIT_PREBUNDLE: readonly string[] = [\n  'lit',\n  'lit/directive.js',\n  'lit/static-html.js',\n  'lit/directives/class-map.js',\n  'lit/directives/keyed.js',\n  'lit/directives/live.js',\n  'lit/directives/repeat.js',\n  'lit/directives/style-map.js',\n];\n\nexport interface GyralViteOptions {\n  /** More modules to pre-bundle (e.g. 'lit/directives/unsafe-html.js'). */\n  readonly optimize?: readonly string[];\n}\n\nexport interface GyralViteConfig {\n  readonly resolve: { readonly dedupe: string[] };\n  readonly optimizeDeps: { readonly include: string[] };\n}\n\n/**\n * Spread into a Vite config, or into each Vitest project:\n *\n *   export default defineConfig({ ...gyralVitePreset(), build: { … } });\n */\nexport function gyralVitePreset(options: GyralViteOptions = {}): GyralViteConfig {\n  return {\n    resolve: { dedupe: [...LIT_PACKAGES] },\n    optimizeDeps: { include: [...new Set([...LIT_PREBUNDLE, ...(options.optimize ?? [])])] },\n  };\n}\n"]}
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"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","sourcesContent":["// Vite / Vitest settings every Gyral app needs (gyral-a7r, docs/references/consumer-setup.md):\n// the template compiler (view/01-templates.md \"Compiled\") and, in serve mode, development\n// output from the dev server's SSR (view/06-server.md \"Development markers\"). Only Node\n// built-ins are imported up front, so it loads from vite.config.ts and vitest.config.ts in any\n// way: bundled with the config, by Node from source (type stripping), or by a Vite module\n// runner. The compiler is a plugin applied in `vite build` only, so dev servers and test runs\n// keep the runtime template path; its implementation (./compiler/) loads on the first build\n// hook, with `require` (Node loads ES modules with it too): a module runner that loaded this\n// file may be closed by then, and would reject a dynamic import().\nimport { readFileSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { ConfigEnv, EnvironmentOptions, Plugin } from 'vite';\nimport type { CompilerHooks } from './compiler/hooks.js';\n\nexport interface TemplateCompilerOptions {\n  /**\n   * Module specifiers whose `html` export is the view layer's tag (default\n   * `DEFAULT_TEMPLATE_SOURCES`). An import matches when its specifier is listed, or when it\n   * resolves to the same module as a listed one; core's own view modules always match. A\n   * source other than '@gyral/core' must also export `compiled`.\n   */\n  readonly sources?: readonly string[];\n  /**\n   * Rule 7's extra check with parse5 (an optional peer dependency): `true` (default) uses\n   * 'parse5' when it is installed, a string names the module to load, `false` skips it.\n   */\n  readonly parse5?: boolean | string;\n}\n\n/** Where the view layer's `html` comes from: core's main entry (ADR 0018, Phase 3). */\nexport const DEFAULT_TEMPLATE_SOURCES: readonly string[] = ['@gyral/core'];\n\n/** The resolve condition that maps core's `#prepare` to its stub (ADR 0017's mechanism). */\nexport const COMPILED_CONDITION = 'gyral-compiled';\n/** Vite 8's default resolve conditions (`defaultClientConditions`, server ones without browser). */\nexport const CLIENT_CONDITIONS: readonly string[] = ['module', 'browser', 'development|production'];\nexport const SERVER_CONDITIONS: readonly string[] = ['module', 'node', 'development|production'];\n\n/**\n * Adds the `gyral-compiled` condition to an environment, on top of the app's conditions or\n * Vite's defaults: Vite replaces the defaults when a config names any condition.\n */\nfunction addCondition(\n  name: string,\n  config: EnvironmentOptions,\n  env: ConfigEnv & { isSsrTargetWebworker?: boolean },\n): void {\n  const consumer = config.consumer ?? (name === 'client' ? 'client' : 'server');\n  const client = consumer === 'client' || env.isSsrTargetWebworker === true;\n  const current = config.resolve?.conditions ?? (client ? CLIENT_CONDITIONS : SERVER_CONDITIONS);\n  if (!current.includes(COMPILED_CONDITION)) {\n    config.resolve = { ...config.resolve, conditions: [...current, COMPILED_CONDITION] };\n  }\n}\n\n/**\n * The compiler's hooks. From core's TypeScript source (this workspace, `link:` checkouts) they\n * load through Vite's module runner, as a vite.config.ts would; from the published package,\n * with require.\n */\nasync function loadHooks(options: TemplateCompilerOptions): Promise<CompilerHooks> {\n  const settings = {\n    sources: options.sources ?? DEFAULT_TEMPLATE_SOURCES,\n    parse5:\n      options.parse5 === false\n        ? undefined\n        : typeof options.parse5 === 'string'\n          ? options.parse5\n          : 'parse5',\n  };\n  const require = createRequire(import.meta.url);\n  if (!import.meta.url.endsWith('.ts')) {\n    return (require('./compiler/hooks.js') as typeof import('./compiler/hooks.js')).createCompiler(\n      settings,\n    );\n  }\n  const { runnerImport } = require('vite') as typeof import('vite');\n  const nodeEnv = process.env['NODE_ENV']; // the runner sets it when unset; the build owns it\n  const { module } = await runnerImport<typeof import('./compiler/hooks.js')>(\n    fileURLToPath(new URL('./compiler/hooks.ts', import.meta.url)),\n    { configFile: false, logLevel: 'silent' },\n  );\n  if (nodeEnv === undefined) delete process.env['NODE_ENV'];\n  else process.env['NODE_ENV'] = nodeEnv;\n  return module.createCompiler(settings);\n}\n\n/** The template compiler alone (`gyralVitePreset()` includes it). */\nexport function gyralTemplateCompiler(options: TemplateCompilerOptions = {}): Plugin {\n  let hooks: CompilerHooks | undefined;\n  const ready = (): CompilerHooks => {\n    if (hooks === undefined) throw new Error('gyral: the template compiler is not loaded yet');\n    return hooks;\n  };\n  return {\n    name: 'gyral:template-compiler',\n    enforce: 'pre',\n    apply: 'build',\n    configEnvironment: addCondition,\n    async configResolved(config) {\n      hooks = await loadHooks(options);\n      await hooks.configResolved.call(this, config);\n    },\n    buildStart(input) {\n      return ready().buildStart.call(this, input);\n    },\n    transform: {\n      filter: { id: /\\.[cm]?[jt]sx?$/, code: 'html' },\n      handler(code, id, opts) {\n        return ready().transform.call(this, code, id, opts);\n      },\n    },\n    generateBundle(output, bundle, isWrite) {\n      return ready().generateBundle.call(this, output, bundle, isWrite);\n    },\n  };\n}\n\n/** Gyral's packages: the dev server runs them through Vite, never Node (view/06). */\nexport const GYRAL_PACKAGES = /^@gyral\\//;\n\ntype Manifest = Partial<Record<'dependencies' | 'devDependencies' | 'peerDependencies', object>>;\n\nfunction manifest(file: string): Manifest | undefined {\n  try {\n    return JSON.parse(readFileSync(file, 'utf8')) as Manifest;\n  } catch {\n    return undefined;\n  }\n}\n\n/** The installed manifest of `name`, looked up from `root` the way Node does (no exports map). */\nfunction installed(root: string, name: string): Manifest | undefined {\n  for (let dir = root; ; dir = dirname(dir)) {\n    const found = manifest(join(dir, 'node_modules', name, 'package.json'));\n    if (found !== undefined || dirname(dir) === dir) return found;\n  }\n}\n\n/**\n * The app's direct dependencies that depend on a Gyral package (a design system, say). They\n * import @gyral/core, so they must share the copy the dev server runs.\n */\nexport function gyralDependents(root: string): string[] {\n  const app = manifest(join(root, 'package.json'));\n  const names = Object.keys({ ...app?.dependencies, ...app?.devDependencies });\n  return names.filter((name) => {\n    if (GYRAL_PACKAGES.test(name)) return false;\n    const dep = installed(root, name);\n    return Object.keys({ ...dep?.dependencies, ...dep?.peerDependencies }).some((d) =>\n      GYRAL_PACKAGES.test(d),\n    );\n  });\n}\n\n/**\n * Development output from the dev server's SSR (`ssrLoadModule`, view/06 \"Development\n * markers\"). Vite externalizes installed packages there and Node imports them itself, resolving\n * core's `#view-dev` without the `development` condition (Vite's `externalConditions` only pick\n * the entry file, not the package's own imports), so the server rendered production output.\n * In serve mode this plugin keeps Gyral's packages, and the app's dependencies that use them,\n * out of externalization in server environments: Vite resolves them with its conditions\n * (`development` in dev), and they all share one copy of core. `vite build` is unaffected.\n */\nexport function gyralDevServer(): Plugin {\n  let root = process.cwd();\n  return {\n    name: 'gyral:dev-server',\n    apply: 'serve',\n    config(config) {\n      root = resolve(config.root ?? process.cwd());\n    },\n    configEnvironment(name, config) {\n      const consumer = config.consumer ?? (name === 'client' ? 'client' : 'server');\n      if (consumer === 'client') return undefined;\n      return { resolve: { noExternal: [GYRAL_PACKAGES, ...gyralDependents(root)] } };\n    },\n  };\n}\n\nexport interface GyralViteOptions {\n  /** Modules to pre-bundle in dev, so Vite doesn't discover them mid-run and reload. */\n  readonly optimize?: readonly string[];\n  /** Template compiler options (`vite build` only). */\n  readonly compiler?: TemplateCompilerOptions;\n}\n\nexport interface GyralViteConfig {\n  readonly plugins: Plugin[];\n  readonly resolve: { readonly dedupe: string[] };\n  readonly optimizeDeps: { readonly include: string[] };\n}\n\n/**\n * Spread into a Vite config, or into each Vitest project:\n *\n *   export default defineConfig({ ...gyralVitePreset(), build: { … } });\n *\n * With plugins of your own, list both: `plugins: [...preset.plugins, mine()]`.\n */\nexport function gyralVitePreset(options: GyralViteOptions = {}): GyralViteConfig {\n  return {\n    plugins: [gyralTemplateCompiler(options.compiler), gyralDevServer()],\n    resolve: { dedupe: [] },\n    optimizeDeps: { include: [...new Set(options.optimize ?? [])] },\n  };\n}\n"]}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@gyral/core",
-  "version": "0.1.0",
-  "description": "Gyral core: Model-View-Intent web components on Lit and the web platform. Inspired by Cycle.js.",
+  "version": "0.3.0",
+  "description": "Gyral core: Model-View-Intent web components on the web platform, with their own view layer. Inspired by Cycle.js.",
   "license": "MIT",
-  "author": "The Zoop Troop, Inc.",
+  "author": "Mike Zupper",
   "homepage": "https://github.com/gyraljs/gyral/tree/main/packages/core#readme",
   "repository": {
     "type": "git",
@@ -20,15 +20,35 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    },
     "./vite": {
       "types": "./dist/vite.d.ts",
       "default": "./dist/vite.js"
+    },
+    "./compiled": {
+      "types": "./dist/view/compiled.d.ts",
+      "default": "./dist/view/compiled.js"
+    },
+    "./eslint": {
+      "types": "./dist/eslint/index.d.ts",
+      "default": "./dist/eslint/index.js"
     }
   },
   "imports": {
     "#devtools": {
       "development": "./dist/devtools.js",
       "default": "./dist/devtools-off.js"
+    },
+    "#prepare": {
+      "gyral-compiled": "./dist/view/prepare-stub.js",
+      "default": "./dist/view/prepare.js"
+    },
+    "#view-dev": {
+      "development": "./dist/view/dev.js",
+      "default": "./dist/view/dev-off.js"
     }
   },
   "files": [
@@ -39,14 +59,28 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@standard-schema/spec": "1.1.0",
-    "effect": "3.22.2"
+    "@standard-schema/spec": "1.1.0"
   },
   "peerDependencies": {
-    "lit": "^3.3.0"
+    "eslint": "^9.0.0 || ^10.0.0",
+    "parse5": "^7.0.0 || ^8.0.0",
+    "vite": "^8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "eslint": {
+      "optional": true
+    },
+    "parse5": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "lit": "3.3.3"
+    "eslint": "10.12.0",
+    "parse5": "8.0.1",
+    "vite": "8.3.2"
   },
   "scripts": {
     "build": "node ../../scripts/build-package.mjs"

package/dist/accessible-name.d.ts

@@ -1,19 +0,0 @@
-import { ElementDirective } from './element-directive.js';
-/** The element with `id`, searched from `from`'s own root outward to the document. */
-export declare function findInScope(from: Element, id: string): Element | null;
-/**
- * Names the element after the element with `id`, even outside this component's shadow root:
- *
- *   <form aria-label=${props.label} ${labelledBy('page-title')}>
- *
- * Uses `ariaLabelledByElements` (ARIA element reflection) where the browser has it, so the name
- * stays in sync with the heading. Elsewhere it sets `aria-label` from `fallback`, or from the
- * target's text. Element directives don't run on the server, so render a plain `aria-label` too
- * (from a `label` prop) for the no-JS page: `aria-labelledby` wins over it once set.
- */
-declare class LabelledBy extends ElementDirective<[id: string, fallback?: string]> {
-    #private;
-    apply(el: Element, [id, fallback]: [id: string, fallback?: string]): void;
-}
-export declare const labelledBy: (id: string, fallback?: string | undefined) => import("lit/directive.js").DirectiveResult<typeof LabelledBy>;
-export {};

package/dist/accessible-name.js

@@ -1,56 +0,0 @@
-// Accessible names across shadow boundaries (gyral-czi.26). `aria-labelledby="page-title"` inside
-// a shadow root can't see an id in the page, so a form or landmark in a component would be
-// nameless. `labelledBy(id)` resolves the id outward through the shadow-including ancestors.
-import { directive } from 'lit/directive.js';
-import { ElementDirective } from './element-directive.js';
-/** ARIA element reflection: newly available Baseline, so feature-detected (ADR 0003). */
-const reflects = (el) => 'ariaLabelledByElements' in el;
-/** The element with `id`, searched from `from`'s own root outward to the document. */
-export function findInScope(from, id) {
-    for (let root = from.getRootNode();;) {
-        const found = 'getElementById' in root ? root.getElementById(id) : null;
-        if (found !== null && found !== from)
-            return found;
-        if (!(root instanceof ShadowRoot))
-            return null;
-        root = root.host.getRootNode();
-    }
-}
-/**
- * Names the element after the element with `id`, even outside this component's shadow root:
- *
- *   <form aria-label=${props.label} ${labelledBy('page-title')}>
- *
- * Uses `ariaLabelledByElements` (ARIA element reflection) where the browser has it, so the name
- * stays in sync with the heading. Elsewhere it sets `aria-label` from `fallback`, or from the
- * target's text. Element directives don't run on the server, so render a plain `aria-label` too
- * (from a `label` prop) for the no-JS page: `aria-labelledby` wins over it once set.
- */
-class LabelledBy extends ElementDirective {
-    #applied = '';
-    apply(el, [id, fallback]) {
-        const key = `${id}\u0000${fallback ?? ''}`;
-        if (key === this.#applied)
-            return;
-        this.#applied = key;
-        // The labelling element may render after this one (a later sibling); try again once.
-        if (!this.#name(el, id, fallback)) {
-            queueMicrotask(() => {
-                this.#name(el, id, fallback);
-            });
-        }
-    }
-    #name(el, id, fallback) {
-        const target = findInScope(el, id);
-        if (target !== null && reflects(el)) {
-            el.ariaLabelledByElements = [target];
-            return true;
-        }
-        const text = fallback ?? target?.textContent.trim() ?? '';
-        if (text !== '')
-            el.setAttribute('aria-label', text);
-        return target !== null;
-    }
-}
-export const labelledBy = directive(LabelledBy);
-//# sourceMappingURL=accessible-name.js.map

package/dist/accessible-name.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"accessible-name.js","sourceRoot":"","sources":["../src/accessible-name.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,2FAA2F;AAC3F,6FAA6F;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM1D,yFAAyF;AACzF,MAAM,QAAQ,GAAG,CAAC,EAAW,EAAoB,EAAE,CAAC,wBAAwB,IAAI,EAAE,CAAC;AAEnF,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,EAAU;IACnD,KAAK,IAAI,IAAI,GAAS,IAAI,CAAC,WAAW,EAAE,IAAK,CAAC;QAC5C,MAAM,KAAK,GAAG,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAE,IAAyB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9F,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACnD,IAAI,CAAC,CAAC,IAAI,YAAY,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC;AACH,CAAC;AAID;;;;;;;;;GASG;AACH,MAAM,UAAW,SAAQ,gBAAiD;IACxE,QAAQ,GAAG,EAAE,CAAC;IAEd,KAAK,CAAC,EAAW,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAkC;QAChE,MAAM,GAAG,GAAG,GAAG,EAAE,SAAS,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC3C,IAAI,GAAG,KAAK,IAAI,CAAC,QAAQ;YAAE,OAAO;QAClC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QACpB,qFAAqF;QACrF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC;YAClC,cAAc,CAAC,GAAG,EAAE;gBAClB,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,EAAW,EAAE,EAAU,EAAE,QAA4B;QACzD,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACpC,EAAE,CAAC,sBAAsB,GAAG,CAAC,MAAM,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,IAAI,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAC1D,IAAI,IAAI,KAAK,EAAE;YAAE,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACrD,OAAO,MAAM,KAAK,IAAI,CAAC;IACzB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC","sourcesContent":["// Accessible names across shadow boundaries (gyral-czi.26). `aria-labelledby=\"page-title\"` inside\n// a shadow root can't see an id in the page, so a form or landmark in a component would be\n// nameless. `labelledBy(id)` resolves the id outward through the shadow-including ancestors.\nimport { directive } from 'lit/directive.js';\nimport { ElementDirective } from './element-directive.js';\n\ninterface Reflecting extends Element {\n  ariaLabelledByElements: readonly Element[] | null;\n}\n\n/** ARIA element reflection: newly available Baseline, so feature-detected (ADR 0003). */\nconst reflects = (el: Element): el is Reflecting => 'ariaLabelledByElements' in el;\n\n/** The element with `id`, searched from `from`'s own root outward to the document. */\nexport function findInScope(from: Element, id: string): Element | null {\n  for (let root: Node = from.getRootNode(); ;) {\n    const found = 'getElementById' in root ? (root as DocumentOrShadow).getElementById(id) : null;\n    if (found !== null && found !== from) return found;\n    if (!(root instanceof ShadowRoot)) return null;\n    root = root.host.getRootNode();\n  }\n}\n\ntype DocumentOrShadow = Document | ShadowRoot;\n\n/**\n * Names the element after the element with `id`, even outside this component's shadow root:\n *\n *   <form aria-label=${props.label} ${labelledBy('page-title')}>\n *\n * Uses `ariaLabelledByElements` (ARIA element reflection) where the browser has it, so the name\n * stays in sync with the heading. Elsewhere it sets `aria-label` from `fallback`, or from the\n * target's text. Element directives don't run on the server, so render a plain `aria-label` too\n * (from a `label` prop) for the no-JS page: `aria-labelledby` wins over it once set.\n */\nclass LabelledBy extends ElementDirective<[id: string, fallback?: string]> {\n  #applied = '';\n\n  apply(el: Element, [id, fallback]: [id: string, fallback?: string]): void {\n    const key = `${id}\\u0000${fallback ?? ''}`;\n    if (key === this.#applied) return;\n    this.#applied = key;\n    // The labelling element may render after this one (a later sibling); try again once.\n    if (!this.#name(el, id, fallback)) {\n      queueMicrotask(() => {\n        this.#name(el, id, fallback);\n      });\n    }\n  }\n\n  #name(el: Element, id: string, fallback: string | undefined): boolean {\n    const target = findInScope(el, id);\n    if (target !== null && reflects(el)) {\n      el.ariaLabelledByElements = [target];\n      return true;\n    }\n    const text = fallback ?? target?.textContent.trim() ?? '';\n    if (text !== '') el.setAttribute('aria-label', text);\n    return target !== null;\n  }\n}\n\nexport const labelledBy = directive(LabelledBy);\n"]}

package/dist/element-directive.d.ts

@@ -1,20 +0,0 @@
-import { nothing } from 'lit';
-import { Directive, type ElementPart, type PartInfo } from 'lit/directive.js';
-/**
- * Base for element directives (`<input ${invalid(errors)}>`): they act on the element they are
- * placed on and render nothing. Subclasses declare their arguments as `Args` and implement
- * `apply`. Wrap the class with `directive()` (re-exported from core) to get the template
- * function. Element parts are not rendered on the server, so `apply` only runs in the browser.
- *
- *   class Focus extends ElementDirective<[when: boolean]> {
- *     apply(el: Element, [when]: [boolean]) { if (when && el instanceof HTMLElement) el.focus(); }
- *   }
- *   export const focusWhen = directive(Focus);
- */
-export declare abstract class ElementDirective<Args extends unknown[]> extends Directive {
-    constructor(info: PartInfo);
-    /** Called on every render with the directive's current arguments. */
-    abstract apply(element: Element, args: Args): void;
-    render(...args: Args): typeof nothing;
-    update(part: ElementPart, args: Args): typeof nothing;
-}

package/dist/element-directive.js

@@ -1,31 +0,0 @@
-import { nothing } from 'lit';
-import { Directive, PartType } from 'lit/directive.js';
-/**
- * Base for element directives (`<input ${invalid(errors)}>`): they act on the element they are
- * placed on and render nothing. Subclasses declare their arguments as `Args` and implement
- * `apply`. Wrap the class with `directive()` (re-exported from core) to get the template
- * function. Element parts are not rendered on the server, so `apply` only runs in the browser.
- *
- *   class Focus extends ElementDirective<[when: boolean]> {
- *     apply(el: Element, [when]: [boolean]) { if (when && el instanceof HTMLElement) el.focus(); }
- *   }
- *   export const focusWhen = directive(Focus);
- */
-export class ElementDirective extends Directive {
-    constructor(info) {
-        super(info);
-        if (info.type !== PartType.ELEMENT) {
-            throw new Error(`${new.target.name} must be used on an element: <el \${directive(…)}>`);
-        }
-    }
-    // Lit reads the directive's arguments from render(); update() does the work.
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    render(...args) {
-        return nothing;
-    }
-    update(part, args) {
-        this.apply(part.element, args);
-        return nothing;
-    }
-}
-//# sourceMappingURL=element-directive.js.map

package/dist/element-directive.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"element-directive.js","sourceRoot":"","sources":["../src/element-directive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAmC,MAAM,kBAAkB,CAAC;AAExF;;;;;;;;;;GAUG;AACH,MAAM,OAAgB,gBAAyC,SAAQ,SAAS;IAC9E,YAAY,IAAc;QACxB,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,oDAAoD,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAKD,6EAA6E;IAC7E,6DAA6D;IACpD,MAAM,CAAC,GAAG,IAAU;QAC3B,OAAO,OAAO,CAAC;IACjB,CAAC;IAEQ,MAAM,CAAC,IAAiB,EAAE,IAAU;QAC3C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;CACF","sourcesContent":["import { nothing } from 'lit';\nimport { Directive, PartType, type ElementPart, type PartInfo } from 'lit/directive.js';\n\n/**\n * Base for element directives (`<input ${invalid(errors)}>`): they act on the element they are\n * placed on and render nothing. Subclasses declare their arguments as `Args` and implement\n * `apply`. Wrap the class with `directive()` (re-exported from core) to get the template\n * function. Element parts are not rendered on the server, so `apply` only runs in the browser.\n *\n *   class Focus extends ElementDirective<[when: boolean]> {\n *     apply(el: Element, [when]: [boolean]) { if (when && el instanceof HTMLElement) el.focus(); }\n *   }\n *   export const focusWhen = directive(Focus);\n */\nexport abstract class ElementDirective<Args extends unknown[]> extends Directive {\n  constructor(info: PartInfo) {\n    super(info);\n    if (info.type !== PartType.ELEMENT) {\n      throw new Error(`${new.target.name} must be used on an element: <el \\${directive(…)}>`);\n    }\n  }\n\n  /** Called on every render with the directive's current arguments. */\n  abstract apply(element: Element, args: Args): void;\n\n  // Lit reads the directive's arguments from render(); update() does the work.\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  override render(...args: Args): typeof nothing {\n    return nothing;\n  }\n\n  override update(part: ElementPart, args: Args): typeof nothing {\n    this.apply(part.element, args);\n    return nothing;\n  }\n}\n"]}

package/dist/internal/runtime.d.ts

@@ -1,7 +0,0 @@
-import { Effect, type Fiber } from 'effect';
-/**
- * The single place Gyral starts Effect programs (ADR 0006). There are no services to
- * provide yet, so the default runtime is enough; a ManagedRuntime with layers goes here
- * when drivers need shared resources.
- */
-export declare const fork: <A>(program: Effect.Effect<A>) => Fiber.RuntimeFiber<A>;

package/dist/internal/runtime.js

@@ -1,8 +0,0 @@
-import { Effect } from 'effect';
-/**
- * The single place Gyral starts Effect programs (ADR 0006). There are no services to
- * provide yet, so the default runtime is enough; a ManagedRuntime with layers goes here
- * when drivers need shared resources.
- */
-export const fork = (program) => Effect.runFork(program);
-//# sourceMappingURL=runtime.js.map

package/dist/internal/runtime.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/internal/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAc,MAAM,QAAQ,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAI,OAAyB,EAAyB,EAAE,CAC1E,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC","sourcesContent":["import { Effect, type Fiber } from 'effect';\n\n/**\n * The single place Gyral starts Effect programs (ADR 0006). There are no services to\n * provide yet, so the default runtime is enough; a ManagedRuntime with layers goes here\n * when drivers need shared resources.\n */\nexport const fork = <A>(program: Effect.Effect<A>): Fiber.RuntimeFiber<A> =>\n  Effect.runFork(program);\n"]}

package/dist/invalid.d.ts

@@ -1,21 +0,0 @@
-import { ElementDirective } from './element-directive.js';
-type Errors = readonly string[] | string | undefined;
-/**
- * Mirrors model errors to native validity (ADR 0008): sets `setCustomValidity` and
- * `aria-invalid`, so `:user-invalid` and native bubbles agree with the model.
- *
- * The custom error clears when:
- * - the control fires `input` or `change` (the user edited it);
- * - the bound errors become `undefined` or empty (the model cleared them);
- * - a submit finds the error stale: the value changed without an event (set from code, e.g.
- *   by a test or a script). Then the error is dropped and the form is submitted again once.
- *
- * An error is applied again only when a new value arrives (keep `fieldErrors()` results in
- * state). Element parts don't render on the server, so this only runs in the browser.
- */
-declare class InvalidDirective extends ElementDirective<[errors?: Errors]> {
-    #private;
-    apply(el: Element, [errors]: [errors?: Errors]): void;
-}
-export declare const invalid: (errors?: Errors) => import("lit/directive.js").DirectiveResult<typeof InvalidDirective>;
-export {};

package/dist/invalid.js

@@ -1,70 +0,0 @@
-import { directive } from 'lit/directive.js';
-import { ElementDirective } from './element-directive.js';
-const isValidatable = (el) => 'setCustomValidity' in el;
-const valueOf = (el) => ('value' in el ? el.value : undefined);
-const formOf = (el) => {
-    const form = 'form' in el ? el.form : undefined;
-    return form instanceof HTMLFormElement ? form : undefined;
-};
-// Forms with a resubmit already queued: several stale fields in one validation pass resubmit once.
-const resubmitting = new WeakSet();
-/**
- * Mirrors model errors to native validity (ADR 0008): sets `setCustomValidity` and
- * `aria-invalid`, so `:user-invalid` and native bubbles agree with the model.
- *
- * The custom error clears when:
- * - the control fires `input` or `change` (the user edited it);
- * - the bound errors become `undefined` or empty (the model cleared them);
- * - a submit finds the error stale: the value changed without an event (set from code, e.g.
- *   by a test or a script). Then the error is dropped and the form is submitted again once.
- *
- * An error is applied again only when a new value arrives (keep `fieldErrors()` results in
- * state). Element parts don't render on the server, so this only runs in the browser.
- */
-class InvalidDirective extends ElementDirective {
-    #last;
-    #listening;
-    apply(el, [errors]) {
-        if (errors === this.#last)
-            return;
-        this.#last = errors;
-        this.#listening?.abort();
-        this.#listening = undefined;
-        const message = typeof errors === 'string' ? errors : (errors ?? []).join(' ');
-        if (isValidatable(el))
-            el.setCustomValidity(message);
-        if (message === '') {
-            el.removeAttribute('aria-invalid');
-            return;
-        }
-        el.setAttribute('aria-invalid', 'true');
-        const listening = new AbortController();
-        this.#listening = listening;
-        const { signal } = listening;
-        const rejectedValue = valueOf(el);
-        const clear = () => {
-            listening.abort();
-            if (isValidatable(el))
-                el.setCustomValidity('');
-            el.removeAttribute('aria-invalid');
-        };
-        el.addEventListener('input', clear, { signal });
-        el.addEventListener('change', clear, { signal });
-        el.addEventListener('invalid', (event) => {
-            if (Object.is(valueOf(el), rejectedValue))
-                return; // still the rejected value
-            event.preventDefault(); // no bubble for an error that no longer applies
-            clear();
-            const form = formOf(el);
-            if (form === undefined || resubmitting.has(form))
-                return;
-            resubmitting.add(form);
-            queueMicrotask(() => {
-                resubmitting.delete(form);
-                form.requestSubmit();
-            });
-        }, { signal });
-    }
-}
-export const invalid = directive(InvalidDirective);
-//# sourceMappingURL=invalid.js.map

package/dist/invalid.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"invalid.js","sourceRoot":"","sources":["../src/invalid.ts"],"names":[],"mappings":"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","sourcesContent":["import { directive } from 'lit/directive.js';\nimport { ElementDirective } from './element-directive.js';\n\ntype Errors = readonly string[] | string | undefined;\n\ninterface Validatable extends Element {\n  setCustomValidity(message: string): void;\n}\n\nconst isValidatable = (el: Element): el is Validatable => 'setCustomValidity' in el;\n\nconst valueOf = (el: Element): unknown => ('value' in el ? el.value : undefined);\n\nconst formOf = (el: Element): HTMLFormElement | undefined => {\n  const form = 'form' in el ? el.form : undefined;\n  return form instanceof HTMLFormElement ? form : undefined;\n};\n\n// Forms with a resubmit already queued: several stale fields in one validation pass resubmit once.\nconst resubmitting = new WeakSet<HTMLFormElement>();\n\n/**\n * Mirrors model errors to native validity (ADR 0008): sets `setCustomValidity` and\n * `aria-invalid`, so `:user-invalid` and native bubbles agree with the model.\n *\n * The custom error clears when:\n * - the control fires `input` or `change` (the user edited it);\n * - the bound errors become `undefined` or empty (the model cleared them);\n * - a submit finds the error stale: the value changed without an event (set from code, e.g.\n *   by a test or a script). Then the error is dropped and the form is submitted again once.\n *\n * An error is applied again only when a new value arrives (keep `fieldErrors()` results in\n * state). Element parts don't render on the server, so this only runs in the browser.\n */\nclass InvalidDirective extends ElementDirective<[errors?: Errors]> {\n  #last: Errors;\n  #listening: AbortController | undefined;\n\n  apply(el: Element, [errors]: [errors?: Errors]): void {\n    if (errors === this.#last) return;\n    this.#last = errors;\n    this.#listening?.abort();\n    this.#listening = undefined;\n    const message = typeof errors === 'string' ? errors : (errors ?? []).join(' ');\n    if (isValidatable(el)) el.setCustomValidity(message);\n    if (message === '') {\n      el.removeAttribute('aria-invalid');\n      return;\n    }\n    el.setAttribute('aria-invalid', 'true');\n\n    const listening = new AbortController();\n    this.#listening = listening;\n    const { signal } = listening;\n    const rejectedValue = valueOf(el);\n    const clear = (): void => {\n      listening.abort();\n      if (isValidatable(el)) el.setCustomValidity('');\n      el.removeAttribute('aria-invalid');\n    };\n    el.addEventListener('input', clear, { signal });\n    el.addEventListener('change', clear, { signal });\n    el.addEventListener(\n      'invalid',\n      (event) => {\n        if (Object.is(valueOf(el), rejectedValue)) return; // still the rejected value\n        event.preventDefault(); // no bubble for an error that no longer applies\n        clear();\n        const form = formOf(el);\n        if (form === undefined || resubmitting.has(form)) return;\n        resubmitting.add(form);\n        queueMicrotask(() => {\n          resubmitting.delete(form);\n          form.requestSubmit();\n        });\n      },\n      { signal },\n    );\n  }\n}\n\nexport const invalid = directive(InvalidDirective);\n"]}

package/dist/live-boolean.d.ts

@@ -1,22 +0,0 @@
-import { Directive, type AttributePart, type PartInfo } from 'lit/directive.js';
-/**
- * A boolean that is right both in server-rendered markup and in the live DOM (ADR 0012).
- * Use it in a boolean attribute binding:
- *
- *   <input type="checkbox" ?checked=${liveBoolean(s.on)} />
- *   <option ?selected=${liveBoolean(s.sort === 'price')}>Price</option>
- *
- * - On the server it renders the attribute when true and omits it when false.
- *   (A property binding, `.checked=${false}`, is serialized by Lit SSR as `checked="false"`,
- *   which *checks* the box. Never bind boolean form state as a property in SSR'd views.)
- * - In the browser it also sets the element's property of the same name (`checked`,
- *   `selected`, `open`, …), so the control follows model state even after the user has
- *   changed it. The attribute alone stops controlling `checked` once a box has been clicked.
- */
-declare class LiveBoolean extends Directive {
-    constructor(info: PartInfo);
-    render(value: boolean): boolean;
-    update(part: AttributePart, [value]: [boolean]): boolean;
-}
-export declare const liveBoolean: (value: boolean) => import("lit/directive.js").DirectiveResult<typeof LiveBoolean>;
-export {};