@gyral/core 0.3.0 → 0.3.1

package/dist/hooks/labelled-by.js

@@ -1,51 +0,0 @@
-// `labelledBy(id, fallback?)` as an element hook (view/02-bindings.md "Element hooks",
-// gyral-czi.26): accessible names across shadow boundaries. `aria-labelledby="page-title"`
-// inside a shadow root can't see an id in the page, so the id is resolved outward through the
-// shadow-including ancestors.
-import { defineHook } from '../view/index.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 `el`; false when the target wasn't found (it may render later). */
-function 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;
-}
-/**
- * Names the element after the element with `id`, even outside this component's shadow root:
- *
- *   <form ${labelledBy('page-title', 'Sign in')}>
- *
- * 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. It has no server half (as before): render a plain `aria-label` too (from a
- * `label` prop) for the page before scripts run; the reflected `aria-labelledby` wins over it.
- */
-export const labelledBy = defineHook({
-    client: (el, [id, fallback]) => {
-        // The labelling element may render after this one (a later sibling): try again once.
-        if (!name(el, id, fallback)) {
-            queueMicrotask(() => {
-                name(el, id, fallback);
-            });
-        }
-    },
-});
-//# sourceMappingURL=labelled-by.js.map

package/dist/hooks/labelled-by.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"labelled-by.js","sourceRoot":"","sources":["../../src/hooks/labelled-by.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,2FAA2F;AAC3F,8FAA8F;AAC9F,8BAA8B;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAM9C,yFAAyF;AACzF,MAAM,QAAQ,GAAG,CAAC,EAAW,EAAoB,EAAE,CAAC,wBAAwB,IAAI,EAAE,CAAC;AAInF,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;AAED,4EAA4E;AAC5E,SAAS,IAAI,CAAC,EAAW,EAAE,EAAU,EAAE,QAA4B;IACjE,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACpC,EAAE,CAAC,sBAAsB,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,IAAI,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IAC1D,IAAI,IAAI,KAAK,EAAE;QAAE,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACrD,OAAO,MAAM,KAAK,IAAI,CAAC;AACzB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAkC;IACpE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE;QAC7B,qFAAqF;QACrF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC5B,cAAc,CAAC,GAAG,EAAE;gBAClB,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;YACzB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF,CAAC,CAAC","sourcesContent":["// `labelledBy(id, fallback?)` as an element hook (view/02-bindings.md \"Element hooks\",\n// gyral-czi.26): accessible names across shadow boundaries. `aria-labelledby=\"page-title\"`\n// inside a shadow root can't see an id in the page, so the id is resolved outward through the\n// shadow-including ancestors.\nimport { defineHook } from '../view/index.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\ntype DocumentOrShadow = Document | ShadowRoot;\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\n/** Names `el`; false when the target wasn't found (it may render later). */\nfunction 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/**\n * Names the element after the element with `id`, even outside this component's shadow root:\n *\n *   <form ${labelledBy('page-title', 'Sign in')}>\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. It has no server half (as before): render a plain `aria-label` too (from a\n * `label` prop) for the page before scripts run; the reflected `aria-labelledby` wins over it.\n */\nexport const labelledBy = defineHook<[id: string, fallback?: string]>({\n  client: (el, [id, fallback]) => {\n    // The labelling element may render after this one (a later sibling): try again once.\n    if (!name(el, id, fallback)) {\n      queueMicrotask(() => {\n        name(el, id, fallback);\n      });\n    }\n  },\n});\n"]}

package/dist/random.d.ts

@@ -1,13 +0,0 @@
-import { type Command, type Driver } from './command.js';
-export interface RandomInput {
-    /** How many numbers to draw. */
-    readonly count: number;
-}
-/** Uniform numbers in [0, 1). Substitute it in tests: `el.drivers = { random: fake }`. */
-export declare const randomDriver: Driver<RandomInput, readonly number[]>;
-/** Draws `count` uniform numbers in [0, 1) and turns them into a message. */
-export declare function random<M>(count: number, toMsg: (values: readonly number[]) => M | undefined): Command<M>;
-/** Maps a uniform number in [0, 1) to an integer in `min..max` (inclusive). Pure. */
-export declare const toInt: (u: number, min: number, max: number) => number;
-/** Draws one integer in `min..max` (inclusive). */
-export declare function randomInt<M>(min: number, max: number, toMsg: (value: number) => M | undefined): Command<M>;

package/dist/random.js

@@ -1,19 +0,0 @@
-// Randomness as an effect (gyral-czi.10): reducers ask for random numbers with a command,
-// so models stay pure and tests substitute a deterministic driver by name.
-import { command, defineDriver } from './command.js';
-/** Uniform numbers in [0, 1). Substitute it in tests: `el.drivers = { random: fake }`. */
-export const randomDriver = defineDriver({
-    name: 'random',
-    run: ({ count }) => Array.from({ length: count }, () => Math.random()),
-});
-/** Draws `count` uniform numbers in [0, 1) and turns them into a message. */
-export function random(count, toMsg) {
-    return command(randomDriver, { count }, { onSuccess: toMsg });
-}
-/** Maps a uniform number in [0, 1) to an integer in `min..max` (inclusive). Pure. */
-export const toInt = (u, min, max) => min + Math.min(max - min, Math.floor(u * (max - min + 1)));
-/** Draws one integer in `min..max` (inclusive). */
-export function randomInt(min, max, toMsg) {
-    return random(1, ([u = 0]) => toMsg(toInt(u, min, max)));
-}
-//# sourceMappingURL=random.js.map

package/dist/random.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"random.js","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,2EAA2E;AAC3E,OAAO,EAAE,OAAO,EAAE,YAAY,EAA6B,MAAM,cAAc,CAAC;AAOhF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,YAAY,GAA2C,YAAY,CAAC;IAC/E,IAAI,EAAE,QAAQ;IACd,GAAG,EAAE,CAAC,EAAE,KAAK,EAAe,EAAqB,EAAE,CACjD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;CACrD,CAAC,CAAC;AAEH,6EAA6E;AAC7E,MAAM,UAAU,MAAM,CACpB,KAAa,EACb,KAAmD;IAEnD,OAAO,OAAO,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,GAAW,EAAE,GAAW,EAAU,EAAE,CACnE,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7D,mDAAmD;AACnD,MAAM,UAAU,SAAS,CACvB,GAAW,EACX,GAAW,EACX,KAAuC;IAEvC,OAAO,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["// Randomness as an effect (gyral-czi.10): reducers ask for random numbers with a command,\n// so models stay pure and tests substitute a deterministic driver by name.\nimport { command, defineDriver, type Command, type Driver } from './command.js';\n\nexport interface RandomInput {\n  /** How many numbers to draw. */\n  readonly count: number;\n}\n\n/** Uniform numbers in [0, 1). Substitute it in tests: `el.drivers = { random: fake }`. */\nexport const randomDriver: Driver<RandomInput, readonly number[]> = defineDriver({\n  name: 'random',\n  run: ({ count }: RandomInput): readonly number[] =>\n    Array.from({ length: count }, () => Math.random()),\n});\n\n/** Draws `count` uniform numbers in [0, 1) and turns them into a message. */\nexport function random<M>(\n  count: number,\n  toMsg: (values: readonly number[]) => M | undefined,\n): Command<M> {\n  return command(randomDriver, { count }, { onSuccess: toMsg });\n}\n\n/** Maps a uniform number in [0, 1) to an integer in `min..max` (inclusive). Pure. */\nexport const toInt = (u: number, min: number, max: number): number =>\n  min + Math.min(max - min, Math.floor(u * (max - min + 1)));\n\n/** Draws one integer in `min..max` (inclusive). */\nexport function randomInt<M>(\n  min: number,\n  max: number,\n  toMsg: (value: number) => M | undefined,\n): Command<M> {\n  return random(1, ([u = 0]) => toMsg(toInt(u, min, max)));\n}\n"]}