@craft-ts/component 0.7.0-beta.13

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Romain Geffrault
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@craft-ts/component",
+  "version": "0.7.0-beta.13",
+  "description": "Functional single-file components for CraftTS",
+  "author": "Romain Geffrault",
+  "license": "MIT",
+  "homepage": "https://craft-ts.github.io/craft/",
+  "bugs": {
+    "url": "https://github.com/craft-ts/craft-ts/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/craft-ts/craft-ts.git"
+  },
+  "peerDependencies": {
+    "@craft-ts/core": "^0.7.0-beta.0"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    }
+  },
+  "module": "./src/index.js"
+}

package/src/index.d.ts

@@ -0,0 +1,40 @@
+export * from './lib/ai/ai-context-menu';
+export * from './lib/ai/ai-send-dialog';
+export * from './lib/ai/send-context-to-ai';
+export * from './lib/assert-defined-input';
+export * from './lib/bridge';
+export { bootstrapCraft, type CraftAppRef } from './lib/bootstrap';
+export * from './lib/server-render';
+export * from './lib/hydrate';
+export * from './lib/start';
+export * from './lib/render/hydration';
+export { createStringDomAdapter } from './lib/render/string-dom';
+import './lib/craft-defaults';
+export * from './lib/component';
+export * from './lib/css-vars';
+export type { CssVarContract, CssVarsOf, CssVarsContractOfMeta, CssVarsAfterCall, } from './lib/css-vars.type';
+export * from './lib/composition';
+export * from './lib/block';
+export * from './lib/pending-block';
+export * from './lib/field-exception-block';
+export * from './lib/match-block';
+export * from './lib/directive';
+export * from './lib/craft-router-outlet';
+export * from './lib/defer';
+export * from './lib/each';
+export * from './lib/each-scheduling';
+export * from './lib/if-block';
+export * from './lib/project';
+export * from './lib/template';
+export * from './lib/hyperscript';
+export * from './lib/a11y';
+export * from './lib/a11y-control';
+export * from './lib/render/style-registry';
+export * from './lib/testing';
+export type { CraftLocatorResult, CraftTemplateLocatorApi, LocatorCriteria, LocatorCriteriaFor, LocatorContentNamesFor, MaybeDefined, StaticLocatorCriteria, TemplateLocatorCandidates, } from './lib/locator';
+export * from './lib/template-contract';
+export type { ComponentFactory, ComponentTemplate, CraftDirective, CraftComponent, HostRequiredLogic, HostTemplate, Input, InputValue, LogicDecorator, Output, PropsOf, TemplateDecorator, ComponentMeta, DirectiveMeta, CraftDirectiveTemplateDependencies, ComponentTemplateOf, ComponentTemplateNameOf, ComponentLogicOutputOf, YieldableTemplateCallback, YieldableTemplateContext, TemplateMethodUse, TemplateCssVars, ComponentCssVars, ComponentCssVarsOf, ComponentNameOf, ComponentInitializationExceptionsOf, ComponentFieldExceptionsOf, ComponentInitializationExceptionCodes, ContentOptions, ContentSlot, ContentRequirement, ContentRequirementOf, ContentRequirementsOfContext, ContentSelector, ContentSelectorCondition, ContentStyles, ContentStylePolicy, RequiredContent, RenderableContent, ProjectionContractOf, ProjectionOf, ProjectionSlot, ProjectionUnit, CraftTemplate, ContentDependencies, PropsFromFactory, CraftInputExceptionsCarrier, ComponentInputExceptionsOf, } from './lib/types';
+export type { TemplateRenderAvailableActionWhen, TemplateRendersNamedElementWhen, TemplateRendersStateWhen, } from './lib/template-contract';
+export type { CraftNode, CraftNodeChild, CraftNodeChildren, IfBlockNode, CatchBlockNode, MatchBlockNode, TemplateNode, CraftNodeCssVarsCarrier, } from './lib/render/vnode';
+export { CRAFT_NODE_CSS_VARS } from './lib/render/vnode';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../libs/component/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnE,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAIjE,OAAO,sBAAsB,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EACV,cAAc,EACd,SAAS,EACT,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAC9B,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,cAAc,yBAAyB,CAAC;AACxC,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,KAAK,EACL,UAAU,EACV,cAAc,EACd,MAAM,EACN,OAAO,EACP,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,kCAAkC,EAClC,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,mCAAmC,EACnC,0BAA0B,EAC1B,qCAAqC,EACrC,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,eAAe,EACf,wBAAwB,EACxB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,iCAAiC,EACjC,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,cAAc,EACd,YAAY,EACZ,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/src/index.js

@@ -0,0 +1,38 @@
+export * from './lib/ai/ai-context-menu';
+export * from './lib/ai/ai-send-dialog';
+export * from './lib/ai/send-context-to-ai';
+export * from './lib/assert-defined-input';
+export * from './lib/bridge';
+export { bootstrapCraft } from './lib/bootstrap';
+export * from './lib/server-render';
+export * from './lib/hydrate';
+export * from './lib/start';
+export * from './lib/render/hydration';
+export { createStringDomAdapter } from './lib/render/string-dom';
+// Registers Craft's default pending loader and lazy-route recovery host.
+// Side-effect only: nothing needs to name them, the router resolves them
+// through CRAFT_PENDING_COMPONENT / CRAFT_ROUTE_LOAD_ERROR_COMPONENT.
+import './lib/craft-defaults';
+export * from './lib/component';
+export * from './lib/css-vars';
+export * from './lib/composition';
+export * from './lib/block';
+export * from './lib/pending-block';
+export * from './lib/field-exception-block';
+export * from './lib/match-block';
+export * from './lib/directive';
+export * from './lib/craft-router-outlet';
+export * from './lib/defer';
+export * from './lib/each';
+export * from './lib/each-scheduling';
+export * from './lib/if-block';
+export * from './lib/project';
+export * from './lib/template';
+export * from './lib/hyperscript';
+export * from './lib/a11y';
+export * from './lib/a11y-control';
+export * from './lib/render/style-registry';
+export * from './lib/testing';
+export * from './lib/template-contract';
+export { CRAFT_NODE_CSS_VARS } from './lib/render/vnode';
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/component/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAoB,MAAM,iBAAiB,CAAC;AACnE,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,yEAAyE;AACzE,yEAAyE;AACzE,sEAAsE;AACtE,OAAO,sBAAsB,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAO/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,eAAe,CAAC;AAW9B,cAAc,yBAAyB,CAAC;AAkExC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["export * from './lib/ai/ai-context-menu';\nexport * from './lib/ai/ai-send-dialog';\nexport * from './lib/ai/send-context-to-ai';\nexport * from './lib/assert-defined-input';\nexport * from './lib/bridge';\nexport { bootstrapCraft, type CraftAppRef } from './lib/bootstrap';\nexport * from './lib/server-render';\nexport * from './lib/hydrate';\nexport * from './lib/start';\nexport * from './lib/render/hydration';\nexport { createStringDomAdapter } from './lib/render/string-dom';\n// Registers Craft's default pending loader and lazy-route recovery host.\n// Side-effect only: nothing needs to name them, the router resolves them\n// through CRAFT_PENDING_COMPONENT / CRAFT_ROUTE_LOAD_ERROR_COMPONENT.\nimport './lib/craft-defaults';\nexport * from './lib/component';\nexport * from './lib/css-vars';\nexport type {\n  CssVarContract,\n  CssVarsOf,\n  CssVarsContractOfMeta,\n  CssVarsAfterCall,\n} from './lib/css-vars.type';\nexport * from './lib/composition';\nexport * from './lib/block';\nexport * from './lib/pending-block';\nexport * from './lib/field-exception-block';\nexport * from './lib/match-block';\nexport * from './lib/directive';\nexport * from './lib/craft-router-outlet';\nexport * from './lib/defer';\nexport * from './lib/each';\nexport * from './lib/each-scheduling';\nexport * from './lib/if-block';\nexport * from './lib/project';\nexport * from './lib/template';\nexport * from './lib/hyperscript';\nexport * from './lib/a11y';\nexport * from './lib/a11y-control';\nexport * from './lib/render/style-registry';\nexport * from './lib/testing';\nexport type {\n  CraftLocatorResult,\n  CraftTemplateLocatorApi,\n  LocatorCriteria,\n  LocatorCriteriaFor,\n  LocatorContentNamesFor,\n  MaybeDefined,\n  StaticLocatorCriteria,\n  TemplateLocatorCandidates,\n} from './lib/locator';\nexport * from './lib/template-contract';\nexport type {\n  ComponentFactory,\n  ComponentTemplate,\n  CraftDirective,\n  CraftComponent,\n  HostRequiredLogic,\n  HostTemplate,\n  Input,\n  InputValue,\n  LogicDecorator,\n  Output,\n  PropsOf,\n  TemplateDecorator,\n  ComponentMeta,\n  DirectiveMeta,\n  CraftDirectiveTemplateDependencies,\n  ComponentTemplateOf,\n  ComponentTemplateNameOf,\n  ComponentLogicOutputOf,\n  YieldableTemplateCallback,\n  YieldableTemplateContext,\n  TemplateMethodUse,\n  TemplateCssVars,\n  ComponentCssVars,\n  ComponentCssVarsOf,\n  ComponentNameOf,\n  ComponentInitializationExceptionsOf,\n  ComponentFieldExceptionsOf,\n  ComponentInitializationExceptionCodes,\n  ContentOptions,\n  ContentSlot,\n  ContentRequirement,\n  ContentRequirementOf,\n  ContentRequirementsOfContext,\n  ContentSelector,\n  ContentSelectorCondition,\n  ContentStyles,\n  ContentStylePolicy,\n  RequiredContent,\n  RenderableContent,\n  ProjectionContractOf,\n  ProjectionOf,\n  ProjectionSlot,\n  ProjectionUnit,\n  CraftTemplate,\n  ContentDependencies,\n  PropsFromFactory,\n  CraftInputExceptionsCarrier,\n  ComponentInputExceptionsOf,\n} from './lib/types';\nexport type {\n  TemplateRenderAvailableActionWhen,\n  TemplateRendersNamedElementWhen,\n  TemplateRendersStateWhen,\n} from './lib/template-contract';\nexport type {\n  CraftNode,\n  CraftNodeChild,\n  CraftNodeChildren,\n  IfBlockNode,\n  CatchBlockNode,\n  MatchBlockNode,\n  TemplateNode,\n  CraftNodeCssVarsCarrier,\n} from './lib/render/vnode';\nexport { CRAFT_NODE_CSS_VARS } from './lib/render/vnode';\n"]}

package/src/lib/a11y-control.d.ts

@@ -0,0 +1,58 @@
+export type FieldIds = {
+    readonly inputId: string;
+    readonly descriptionId: string;
+};
+export declare function fieldIds(id: string): FieldIds;
+export type FieldControl = {
+    readonly ids: FieldIds;
+    readonly input: {
+        readonly id: string;
+        readonly 'aria-describedby': string;
+        readonly 'aria-invalid'?: true;
+        readonly 'data-invalid'?: true;
+    };
+    readonly label: {
+        readonly htmlFor: string;
+    };
+    readonly description: {
+        readonly id: string;
+    };
+};
+export declare function fieldControl(id: string, options?: {
+    readonly invalid?: boolean;
+}): FieldControl;
+export type DisclosureControl = {
+    readonly buttonId: string;
+    readonly panelId: string;
+    readonly button: {
+        readonly type: 'button';
+        readonly id: string;
+        readonly 'aria-expanded': boolean;
+        readonly 'aria-controls': string;
+        readonly 'data-open'?: true;
+        readonly 'aria-disabled'?: true;
+        readonly 'data-disabled'?: true;
+    };
+    readonly panel: {
+        readonly id: string;
+        readonly 'data-open'?: true;
+        readonly 'aria-hidden'?: true;
+        readonly hidden?: true;
+    };
+};
+export declare function disclosureControl(id: string, isOpen: boolean, options?: {
+    readonly disabled?: boolean;
+}): DisclosureControl;
+export type ButtonControl = {
+    readonly type: 'button' | 'submit' | 'reset';
+    readonly disabled?: true;
+    readonly 'aria-disabled'?: true;
+    readonly 'data-disabled'?: true;
+};
+export declare function buttonControl(options?: {
+    readonly type?: 'button' | 'submit' | 'reset';
+    readonly disabled?: boolean;
+    readonly keepFocusable?: boolean;
+}): ButtonControl;
+export declare function clickFocus<E extends MouseEvent>(selector: string, handler?: (event: E) => unknown): (event: E) => unknown;
+//# sourceMappingURL=a11y-control.d.ts.map

package/src/lib/a11y-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-control.d.ts","sourceRoot":"","sources":["../../../../../libs/component/src/lib/a11y-control.ts"],"names":[],"mappings":"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"}

package/src/lib/a11y-control.js

@@ -0,0 +1,74 @@
+export function fieldIds(id) {
+    return {
+        inputId: id,
+        descriptionId: `${id}-description`,
+    };
+}
+export function fieldControl(id, options) {
+    const ids = fieldIds(id);
+    return {
+        ids,
+        input: {
+            id: ids.inputId,
+            'aria-describedby': ids.descriptionId,
+            ...(options?.invalid
+                ? { 'aria-invalid': true, 'data-invalid': true }
+                : {}),
+        },
+        label: { htmlFor: ids.inputId },
+        description: { id: ids.descriptionId },
+    };
+}
+export function disclosureControl(id, isOpen, options) {
+    const buttonId = `${id}-button`;
+    const panelId = `${id}-panel`;
+    const openAttrs = isOpen ? { 'data-open': true } : {};
+    return {
+        buttonId,
+        panelId,
+        button: {
+            type: 'button',
+            id: buttonId,
+            'aria-expanded': isOpen,
+            'aria-controls': panelId,
+            ...openAttrs,
+            ...(options?.disabled
+                ? { 'aria-disabled': true, 'data-disabled': true }
+                : {}),
+        },
+        panel: {
+            id: panelId,
+            ...openAttrs,
+            ...(isOpen
+                ? {}
+                : { 'aria-hidden': true, hidden: true }),
+        },
+    };
+}
+export function buttonControl(options) {
+    const type = options?.type ?? 'button';
+    if (!options?.disabled) {
+        return { type };
+    }
+    if (options.keepFocusable) {
+        return {
+            type,
+            'aria-disabled': true,
+            'data-disabled': true,
+        };
+    }
+    return {
+        type,
+        disabled: true,
+        'data-disabled': true,
+    };
+}
+export function clickFocus(selector, handler) {
+    return (event) => {
+        const root = event.currentTarget?.ownerDocument ?? document;
+        const target = root.querySelector(selector);
+        target?.focus();
+        return handler?.(event);
+    };
+}
+//# sourceMappingURL=a11y-control.js.map

package/src/lib/a11y-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-control.js","sourceRoot":"","sources":["../../../../../libs/component/src/lib/a11y-control.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,OAAO;QACL,OAAO,EAAE,EAAE;QACX,aAAa,EAAE,GAAG,EAAE,cAAc;KACnC,CAAC;AACJ,CAAC;AAcD,MAAM,UAAU,YAAY,CAC1B,EAAU,EACV,OAAwC;IAExC,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzB,OAAO;QACL,GAAG;QACH,KAAK,EAAE;YACL,EAAE,EAAE,GAAG,CAAC,OAAO;YACf,kBAAkB,EAAE,GAAG,CAAC,aAAa;YACrC,GAAG,CAAC,OAAO,EAAE,OAAO;gBAClB,CAAC,CAAC,EAAE,cAAc,EAAE,IAAa,EAAE,cAAc,EAAE,IAAa,EAAE;gBAClE,CAAC,CAAC,EAAE,CAAC;SACR;QACD,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;QAC/B,WAAW,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,aAAa,EAAE;KACvC,CAAC;AACJ,CAAC;AAsBD,MAAM,UAAU,iBAAiB,CAC/B,EAAU,EACV,MAAe,EACf,OAAyC;IAEzC,MAAM,QAAQ,GAAG,GAAG,EAAE,SAAS,CAAC;IAChC,MAAM,OAAO,GAAG,GAAG,EAAE,QAAQ,CAAC;IAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAE,EAAE,WAAW,EAAE,IAAa,EAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,OAAO;QACL,QAAQ;QACR,OAAO;QACP,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,QAAQ;YACZ,eAAe,EAAE,MAAM;YACvB,eAAe,EAAE,OAAO;YACxB,GAAG,SAAS;YACZ,GAAG,CAAC,OAAO,EAAE,QAAQ;gBACnB,CAAC,CAAC,EAAE,eAAe,EAAE,IAAa,EAAE,eAAe,EAAE,IAAa,EAAE;gBACpE,CAAC,CAAC,EAAE,CAAC;SACR;QACD,KAAK,EAAE;YACL,EAAE,EAAE,OAAO;YACX,GAAG,SAAS;YACZ,GAAG,CAAC,MAAM;gBACR,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,aAAa,EAAE,IAAa,EAAE,MAAM,EAAE,IAAa,EAAE,CAAC;SAC7D;KACF,CAAC;AACJ,CAAC;AASD,MAAM,UAAU,aAAa,CAAC,OAI7B;IACC,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,QAAQ,CAAC;IACvC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,OAAO;YACL,IAAI;YACJ,eAAe,EAAE,IAAI;YACrB,eAAe,EAAE,IAAI;SACtB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,IAAI;QACd,eAAe,EAAE,IAAI;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,OAA+B;IAE/B,OAAO,CAAC,KAAQ,EAAE,EAAE;QAClB,MAAM,IAAI,GAAI,KAAK,CAAC,aAAgC,EAAE,aAAa,IAAI,QAAQ,CAAC;QAChF,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAc,QAAQ,CAAC,CAAC;QACzD,MAAM,EAAE,KAAK,EAAE,CAAC;QAChB,OAAO,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC,CAAC;AACJ,CAAC","sourcesContent":["export type FieldIds = {\n  readonly inputId: string;\n  readonly descriptionId: string;\n};\n\nexport function fieldIds(id: string): FieldIds {\n  return {\n    inputId: id,\n    descriptionId: `${id}-description`,\n  };\n}\n\nexport type FieldControl = {\n  readonly ids: FieldIds;\n  readonly input: {\n    readonly id: string;\n    readonly 'aria-describedby': string;\n    readonly 'aria-invalid'?: true;\n    readonly 'data-invalid'?: true;\n  };\n  readonly label: { readonly htmlFor: string };\n  readonly description: { readonly id: string };\n};\n\nexport function fieldControl(\n  id: string,\n  options?: { readonly invalid?: boolean },\n): FieldControl {\n  const ids = fieldIds(id);\n  return {\n    ids,\n    input: {\n      id: ids.inputId,\n      'aria-describedby': ids.descriptionId,\n      ...(options?.invalid\n        ? { 'aria-invalid': true as const, 'data-invalid': true as const }\n        : {}),\n    },\n    label: { htmlFor: ids.inputId },\n    description: { id: ids.descriptionId },\n  };\n}\n\nexport type DisclosureControl = {\n  readonly buttonId: string;\n  readonly panelId: string;\n  readonly button: {\n    readonly type: 'button';\n    readonly id: string;\n    readonly 'aria-expanded': boolean;\n    readonly 'aria-controls': string;\n    readonly 'data-open'?: true;\n    readonly 'aria-disabled'?: true;\n    readonly 'data-disabled'?: true;\n  };\n  readonly panel: {\n    readonly id: string;\n    readonly 'data-open'?: true;\n    readonly 'aria-hidden'?: true;\n    readonly hidden?: true;\n  };\n};\n\nexport function disclosureControl(\n  id: string,\n  isOpen: boolean,\n  options?: { readonly disabled?: boolean },\n): DisclosureControl {\n  const buttonId = `${id}-button`;\n  const panelId = `${id}-panel`;\n  const openAttrs = isOpen ? ({ 'data-open': true as const } as const) : {};\n  return {\n    buttonId,\n    panelId,\n    button: {\n      type: 'button',\n      id: buttonId,\n      'aria-expanded': isOpen,\n      'aria-controls': panelId,\n      ...openAttrs,\n      ...(options?.disabled\n        ? { 'aria-disabled': true as const, 'data-disabled': true as const }\n        : {}),\n    },\n    panel: {\n      id: panelId,\n      ...openAttrs,\n      ...(isOpen\n        ? {}\n        : { 'aria-hidden': true as const, hidden: true as const }),\n    },\n  };\n}\n\nexport type ButtonControl = {\n  readonly type: 'button' | 'submit' | 'reset';\n  readonly disabled?: true;\n  readonly 'aria-disabled'?: true;\n  readonly 'data-disabled'?: true;\n};\n\nexport function buttonControl(options?: {\n  readonly type?: 'button' | 'submit' | 'reset';\n  readonly disabled?: boolean;\n  readonly keepFocusable?: boolean;\n}): ButtonControl {\n  const type = options?.type ?? 'button';\n  if (!options?.disabled) {\n    return { type };\n  }\n  if (options.keepFocusable) {\n    return {\n      type,\n      'aria-disabled': true,\n      'data-disabled': true,\n    };\n  }\n  return {\n    type,\n    disabled: true,\n    'data-disabled': true,\n  };\n}\n\nexport function clickFocus<E extends MouseEvent>(\n  selector: string,\n  handler?: (event: E) => unknown,\n): (event: E) => unknown {\n  return (event: E) => {\n    const root = (event.currentTarget as Element | null)?.ownerDocument ?? document;\n    const target = root.querySelector<HTMLElement>(selector);\n    target?.focus();\n    return handler?.(event);\n  };\n}\n"]}

package/src/lib/a11y.d.ts

@@ -0,0 +1,87 @@
+import type { Yieldable } from '@craft-ts/core';
+import { type CraftNodeChildren, type CraftNodeChildrenDependencies, type ElementNode, type HeadingNode, type HeadingSectionNode } from './render/vnode';
+type HeadingProps = {
+    readonly class?: unknown;
+    readonly style?: unknown;
+    readonly id?: string | (() => string) | Yieldable<[], string, unknown>;
+    readonly [attribute: string]: unknown;
+};
+/**
+ * Renders a heading whose rank comes from the current outline (`h1`–`h6`).
+ * The title does not pick `h2` vs `h3` — the parent outline does.
+ *
+ * A local `heading()` is allowed in this template (route page title = `h1`).
+ * A child component that renders `heading()` must be wrapped by **this**
+ * parent in {@link headingSection} (same DNA as `pendingBlock`). Otherwise
+ * the call does not compile:
+ * `ERROR_child_heading_rendered_outside_a_headingSection`.
+ *
+ * Prefer this over `h1()`…`h6()` inside a `craftComponent`.
+ *
+ * @example
+ * heading('Liste des tâches');
+ * headingSection([
+ *   heading('Détail'),
+ *   TaskCard(), // child's heading() becomes hN+1
+ * ]);
+ *
+ * @see headingSection
+ * @see headingRoot
+ */
+export declare function heading<const Children extends CraftNodeChildren>(children?: Children): HeadingNode<CraftNodeChildrenDependencies<Children>, Children, HeadingProps, 'heading'>;
+export declare function heading<const Children extends CraftNodeChildren>(props: HeadingProps | null, children?: Children): HeadingNode<CraftNodeChildrenDependencies<Children>, Children, HeadingProps, 'heading'>;
+/**
+ * Increments the heading outline by one rank for the subtree.
+ *
+ * Not a visual box and not a `<section>`: comment-bounded fragment, no extra
+ * DOM node (same as `ifBlock`). Nested {@link heading} calls become
+ * `hN+1`. Also absorbs a child's heading need so the parent compiles.
+ *
+ * Nest to build the document outline: page `heading()` → `h1`, first
+ * `headingSection` → `h2`, nested `headingSection` → `h3`, clamped at `h6`.
+ *
+ * @example
+ * heading('Page');
+ * headingSection([
+ *   heading('Section'),
+ *   headingSection([heading('Subsection')]),
+ * ]);
+ *
+ * @see heading
+ * @see headingRoot
+ */
+export declare function headingSection<const Children extends CraftNodeChildren>(children?: Children): HeadingSectionNode<CraftNodeChildrenDependencies<Children>, Children>;
+/**
+ * Starts the heading outline at level 1 for the subtree. Absorbs children's
+ * heading need. Use for a route page, or a nested root (a `<dialog>` already
+ * resets via the native element — its title is `h1` **inside** the dialog).
+ *
+ * Unlike {@link headingSection}, this does not increment: every {@link heading}
+ * below is `h1` again.
+ *
+ * @see heading
+ * @see headingSection
+ */
+export declare function headingRoot<const Children extends CraftNodeChildren>(children?: Children): HeadingSectionNode<CraftNodeChildrenDependencies<Children>, Children>;
+/**
+ * Skip link for the application shell. Pair with `main({ id: targetId }, …)`.
+ */
+export declare function skipLink(targetId?: string, label?: string): ElementNode<CraftNodeChildrenDependencies<string>, "a", NoInfer<{
+    readonly href: `#${string}`;
+    readonly class: "skip-link";
+}>, string, string | undefined, string, never, never, import("./css-vars.type").EmptyCssVarContract, never, never>;
+/**
+ * Announces dynamic text to assistive technology (toasts, "Copied").
+ */
+type LiveRegionProps = {
+    readonly politeness?: 'polite' | 'assertive';
+    readonly label?: string;
+};
+export declare function liveRegion<const Children extends CraftNodeChildren>(children?: Children): ElementNode<CraftNodeChildrenDependencies<Children>, 'span', {
+    readonly 'aria-live': 'polite';
+    readonly 'aria-atomic': 'true';
+    readonly role: 'status';
+}, Children>;
+export declare function liveRegion<const Children extends CraftNodeChildren>(props: LiveRegionProps | null, children?: Children): ElementNode<CraftNodeChildrenDependencies<Children>, 'span', object, Children>;
+export {};
+//# sourceMappingURL=a11y.d.ts.map

package/src/lib/a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../../../../../libs/component/src/lib/a11y.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,6BAA6B,EAClC,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAExB,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CACvC,CAAC;AAaF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,QAAQ,SAAS,iBAAiB,EAC9D,QAAQ,CAAC,EAAE,QAAQ,GAClB,WAAW,CAAC,6BAA6B,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;AAC3F,wBAAgB,OAAO,CAAC,KAAK,CAAC,QAAQ,SAAS,iBAAiB,EAC9D,KAAK,EAAE,YAAY,GAAG,IAAI,EAC1B,QAAQ,CAAC,EAAE,QAAQ,GAClB,WAAW,CACZ,6BAA6B,CAAC,QAAQ,CAAC,EACvC,QAAQ,EACR,YAAY,EACZ,SAAS,CACV,CAAC;AAwBF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,QAAQ,SAAS,iBAAiB,EACrE,QAAQ,CAAC,EAAE,QAAQ,GAClB,kBAAkB,CAAC,6BAA6B,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAKvE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,QAAQ,SAAS,iBAAiB,EAClE,QAAQ,CAAC,EAAE,QAAQ,GAClB,kBAAkB,CAAC,6BAA6B,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAMvE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,SAAS,EACjB,KAAK,SAAyB;;;mHAG/B;AAED;;GAEG;AACH,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,CAAC,QAAQ,SAAS,iBAAiB,EACjE,QAAQ,CAAC,EAAE,QAAQ,GAClB,WAAW,CACZ,6BAA6B,CAAC,QAAQ,CAAC,EACvC,MAAM,EACN;IAAE,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,EAC3F,QAAQ,CACT,CAAC;AACF,wBAAgB,UAAU,CAAC,KAAK,CAAC,QAAQ,SAAS,iBAAiB,EACjE,KAAK,EAAE,eAAe,GAAG,IAAI,EAC7B,QAAQ,CAAC,EAAE,QAAQ,GAClB,WAAW,CACZ,6BAA6B,CAAC,QAAQ,CAAC,EACvC,MAAM,EACN,MAAM,EACN,QAAQ,CACT,CAAC"}

package/src/lib/a11y.js

@@ -0,0 +1,96 @@
+import { a, span } from './hyperscript';
+import { pipeCraftNode, } from './render/vnode';
+function looksLikeChildren(value) {
+    return (value === null ||
+        value === undefined ||
+        Array.isArray(value) ||
+        typeof value !== 'object' ||
+        ('kind' in value &&
+            typeof value.kind === 'string'));
+}
+export function heading(propsOrChildren, maybeChildren) {
+    const props = looksLikeChildren(propsOrChildren)
+        ? {}
+        : (propsOrChildren ?? {});
+    const children = looksLikeChildren(propsOrChildren)
+        ? propsOrChildren
+        : maybeChildren;
+    const node = {
+        kind: 'heading',
+        props,
+        children: children ?? [],
+    };
+    Object.defineProperty(node, 'pipe', {
+        value: (directive) => pipeCraftNode(node, directive),
+        enumerable: false,
+    });
+    return node;
+}
+/**
+ * Increments the heading outline by one rank for the subtree.
+ *
+ * Not a visual box and not a `<section>`: comment-bounded fragment, no extra
+ * DOM node (same as `ifBlock`). Nested {@link heading} calls become
+ * `hN+1`. Also absorbs a child's heading need so the parent compiles.
+ *
+ * Nest to build the document outline: page `heading()` → `h1`, first
+ * `headingSection` → `h2`, nested `headingSection` → `h3`, clamped at `h6`.
+ *
+ * @example
+ * heading('Page');
+ * headingSection([
+ *   heading('Section'),
+ *   headingSection([heading('Subsection')]),
+ * ]);
+ *
+ * @see heading
+ * @see headingRoot
+ */
+export function headingSection(children) {
+    return {
+        kind: 'heading-section',
+        children: (children ?? []),
+    };
+}
+/**
+ * Starts the heading outline at level 1 for the subtree. Absorbs children's
+ * heading need. Use for a route page, or a nested root (a `<dialog>` already
+ * resets via the native element — its title is `h1` **inside** the dialog).
+ *
+ * Unlike {@link headingSection}, this does not increment: every {@link heading}
+ * below is `h1` again.
+ *
+ * @see heading
+ * @see headingSection
+ */
+export function headingRoot(children) {
+    return {
+        kind: 'heading-section',
+        reset: true,
+        children: (children ?? []),
+    };
+}
+/**
+ * Skip link for the application shell. Pair with `main({ id: targetId }, …)`.
+ */
+export function skipLink(targetId = 'main', label = 'Skip to main content') {
+    return a({ href: `#${targetId}`, class: 'skip-link' }, label);
+}
+export function liveRegion(propsOrChildren, maybeChildren) {
+    const props = looksLikeChildren(propsOrChildren)
+        ? { politeness: 'polite' }
+        : (propsOrChildren ?? {});
+    const children = looksLikeChildren(propsOrChildren)
+        ? propsOrChildren
+        : maybeChildren;
+    const politeness = props.politeness ?? 'polite';
+    const label = props.label;
+    return span({
+        'aria-live': politeness,
+        'aria-atomic': 'true',
+        ...(label !== undefined
+            ? { role: 'region', 'aria-label': label }
+            : { role: politeness === 'assertive' ? 'alert' : 'status' }),
+    }, children);
+}
+//# sourceMappingURL=a11y.js.map

package/src/lib/a11y.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.js","sourceRoot":"","sources":["../../../../../libs/component/src/lib/a11y.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Yieldable } from '@craft-ts/core';\nimport { a, span } from './hyperscript';\nimport {\n  pipeCraftNode,\n  type CraftNodeChildren,\n  type CraftNodeChildrenDependencies,\n  type ElementNode,\n  type HeadingNode,\n  type HeadingSectionNode,\n} from './render/vnode';\n\ntype HeadingProps = {\n  readonly class?: unknown;\n  readonly style?: unknown;\n  readonly id?: string | (() => string) | Yieldable<[], string, unknown>;\n  readonly [attribute: string]: unknown;\n};\n\nfunction looksLikeChildren(value: unknown): boolean {\n  return (\n    value === null ||\n    value === undefined ||\n    Array.isArray(value) ||\n    typeof value !== 'object' ||\n    ('kind' in (value as object) &&\n      typeof (value as { kind?: unknown }).kind === 'string')\n  );\n}\n\n/**\n * Renders a heading whose rank comes from the current outline (`h1`–`h6`).\n * The title does not pick `h2` vs `h3` — the parent outline does.\n *\n * A local `heading()` is allowed in this template (route page title = `h1`).\n * A child component that renders `heading()` must be wrapped by **this**\n * parent in {@link headingSection} (same DNA as `pendingBlock`). Otherwise\n * the call does not compile:\n * `ERROR_child_heading_rendered_outside_a_headingSection`.\n *\n * Prefer this over `h1()`…`h6()` inside a `craftComponent`.\n *\n * @example\n * heading('Liste des tâches');\n * headingSection([\n *   heading('Détail'),\n *   TaskCard(), // child's heading() becomes hN+1\n * ]);\n *\n * @see headingSection\n * @see headingRoot\n */\nexport function heading<const Children extends CraftNodeChildren>(\n  children?: Children,\n): HeadingNode<CraftNodeChildrenDependencies<Children>, Children, HeadingProps, 'heading'>;\nexport function heading<const Children extends CraftNodeChildren>(\n  props: HeadingProps | null,\n  children?: Children,\n): HeadingNode<\n  CraftNodeChildrenDependencies<Children>,\n  Children,\n  HeadingProps,\n  'heading'\n>;\nexport function heading(\n  propsOrChildren?: HeadingProps | CraftNodeChildren | null,\n  maybeChildren?: CraftNodeChildren,\n): HeadingNode<any, any, HeadingProps, 'heading'> {\n  const props = looksLikeChildren(propsOrChildren)\n    ? {}\n    : ((propsOrChildren ?? {}) as HeadingProps);\n  const children = looksLikeChildren(propsOrChildren)\n    ? (propsOrChildren as CraftNodeChildren)\n    : maybeChildren;\n  const node = {\n    kind: 'heading' as const,\n    props,\n    children: children ?? [],\n  };\n  Object.defineProperty(node, 'pipe', {\n    value: (directive: unknown) =>\n      pipeCraftNode(node as never, directive as never),\n    enumerable: false,\n  });\n  return node as HeadingNode<any, any, HeadingProps, 'heading'>;\n}\n\n/**\n * Increments the heading outline by one rank for the subtree.\n *\n * Not a visual box and not a `<section>`: comment-bounded fragment, no extra\n * DOM node (same as `ifBlock`). Nested {@link heading} calls become\n * `hN+1`. Also absorbs a child's heading need so the parent compiles.\n *\n * Nest to build the document outline: page `heading()` → `h1`, first\n * `headingSection` → `h2`, nested `headingSection` → `h3`, clamped at `h6`.\n *\n * @example\n * heading('Page');\n * headingSection([\n *   heading('Section'),\n *   headingSection([heading('Subsection')]),\n * ]);\n *\n * @see heading\n * @see headingRoot\n */\nexport function headingSection<const Children extends CraftNodeChildren>(\n  children?: Children,\n): HeadingSectionNode<CraftNodeChildrenDependencies<Children>, Children> {\n  return {\n    kind: 'heading-section',\n    children: (children ?? []) as Children,\n  };\n}\n\n/**\n * Starts the heading outline at level 1 for the subtree. Absorbs children's\n * heading need. Use for a route page, or a nested root (a `<dialog>` already\n * resets via the native element — its title is `h1` **inside** the dialog).\n *\n * Unlike {@link headingSection}, this does not increment: every {@link heading}\n * below is `h1` again.\n *\n * @see heading\n * @see headingSection\n */\nexport function headingRoot<const Children extends CraftNodeChildren>(\n  children?: Children,\n): HeadingSectionNode<CraftNodeChildrenDependencies<Children>, Children> {\n  return {\n    kind: 'heading-section',\n    reset: true,\n    children: (children ?? []) as Children,\n  };\n}\n\n/**\n * Skip link for the application shell. Pair with `main({ id: targetId }, …)`.\n */\nexport function skipLink(\n  targetId = 'main',\n  label = 'Skip to main content',\n) {\n  return a({ href: `#${targetId}`, class: 'skip-link' }, label);\n}\n\n/**\n * Announces dynamic text to assistive technology (toasts, \"Copied\").\n */\ntype LiveRegionProps = {\n  readonly politeness?: 'polite' | 'assertive';\n  readonly label?: string;\n};\n\nexport function liveRegion<const Children extends CraftNodeChildren>(\n  children?: Children,\n): ElementNode<\n  CraftNodeChildrenDependencies<Children>,\n  'span',\n  { readonly 'aria-live': 'polite'; readonly 'aria-atomic': 'true'; readonly role: 'status' },\n  Children\n>;\nexport function liveRegion<const Children extends CraftNodeChildren>(\n  props: LiveRegionProps | null,\n  children?: Children,\n): ElementNode<\n  CraftNodeChildrenDependencies<Children>,\n  'span',\n  object,\n  Children\n>;\nexport function liveRegion(\n  propsOrChildren?:\n    | LiveRegionProps\n    | CraftNodeChildren\n    | null,\n  maybeChildren?: CraftNodeChildren,\n): unknown {\n  const props = looksLikeChildren(propsOrChildren)\n    ? { politeness: 'polite' as const }\n    : ((propsOrChildren ?? {}) as LiveRegionProps);\n  const children = looksLikeChildren(propsOrChildren)\n    ? (propsOrChildren as CraftNodeChildren)\n    : maybeChildren;\n  const politeness = props.politeness ?? 'polite';\n  const label = props.label;\n  return span(\n    {\n      'aria-live': politeness,\n      'aria-atomic': 'true',\n      ...(label !== undefined\n        ? { role: 'region' as const, 'aria-label': label }\n        : { role: politeness === 'assertive' ? 'alert' : 'status' }),\n    },\n    children,\n  );\n}\n"]}