@fusion.dev/helix-core 0.178.0 → 0.179.0

package/custom-elements.json

@@ -15876,6 +15876,14 @@
             "module": "./utils/draw-tooltip/draw-tooltip.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "spokenReading",
+          "declaration": {
+            "name": "spokenReading",
+            "module": "./utils/draw-tooltip/spoken-reading.js"
+          }
+        },
         {
           "kind": "js",
           "name": "drawValueAxis",
@@ -30384,7 +30392,7 @@
               }
             }
           ],
-          "description": "Adds `by` to the elements that describe `target`, where that is safe, and\nsays whether `target` is now described by it.\n\nThrough element reflection, and only where no framework is watching:\n\n- **Inside a shadow root**, such as the `<button>` a Helix button draws, it\n  is always safe. That markup is the component's own, and no server sent it.\n- **In the light DOM**, the element is the consumer's, and reflection writes\n  an empty `aria-describedby` onto it. So it is written only when `light` is\n  set, which a caller does once a reader has acted on the page, after any\n  hydration, and never where the consumer wrote `aria-describedby` or\n  `aria-labelledby` themselves, which are theirs to keep.\n\nExisting references are kept, so a field's hint still describes it. Tooltip\ndescribes its trigger this way."
+          "description": "Adds `by` to the elements that describe `target`, where that is safe, and\nsays whether it wrote the link, which is then the caller's to take back with\n`unlinkDescription`. A `target` described by `by` already is left alone and\nanswers false.\n\nThrough element reflection, and only where no framework is watching:\n\n- **Inside a shadow root**, such as the `<button>` a Helix button draws, it\n  is always safe. That markup is the component's own, and no server sent it.\n- **In the light DOM**, the element is the consumer's, and reflection writes\n  an empty `aria-describedby` onto it. So it is written only when `light` is\n  set, which a caller does once a reader has acted on the page, after any\n  hydration, and never where the consumer wrote `aria-describedby` or\n  `aria-labelledby` themselves, which are theirs to keep.\n\nExisting references are kept, so a field's hint still describes it. Tooltip\ndescribes its trigger this way."
         },
         {
           "kind": "function",
@@ -33979,7 +33987,7 @@
           "type": {
             "text": "string"
           },
-          "default": "'0.178.0'",
+          "default": "'0.179.0'",
           "description": "The version of the package this file ships in.\n\n**Written by `fusion/scripts/version.mjs`** wherever it writes the package's\n`package.json`, and stamped back into the repository beside it after a\nrelease, so the two never disagree; a spec beside this holds them to it.\nNothing else in the running code knows which release it is."
         }
       ],
@@ -34615,6 +34623,6 @@
   ],
   "helix": {
     "package": "@fusion.dev/helix-core",
-    "version": "0.178.0"
+    "version": "0.179.0"
   }
 }

package/dist/index.d.ts

@@ -79,6 +79,7 @@ export { readWrittenDate, readWrittenTime, segmentName, } from './utils/date-seg
 export { type DrawDismissOptions, drawDismiss, drawDismissGlyph, } from './utils/draw-dismiss/draw-dismiss.js';
 export { type DrawIconOptions, drawIcon } from './utils/draw-icon/draw-icon.js';
 export { CHART_PLOT, drawTooltip, type ReadingCursor } from './utils/draw-tooltip/draw-tooltip.js';
+export { spokenReading } from './utils/draw-tooltip/spoken-reading.js';
 export { drawValueAxis } from './utils/draw-value-axis/draw-value-axis.js';
 export { drawsInSoftware } from './utils/draws-in-software/draws-in-software.js';
 export { elapsedTime } from './utils/elapsed-time/elapsed-time.js';

package/dist/index.js

@@ -79,6 +79,7 @@ export { readWrittenDate, readWrittenTime, segmentName, } from './utils/date-seg
 export { drawDismiss, drawDismissGlyph, } from './utils/draw-dismiss/draw-dismiss.js';
 export { drawIcon } from './utils/draw-icon/draw-icon.js';
 export { CHART_PLOT, drawTooltip } from './utils/draw-tooltip/draw-tooltip.js';
+export { spokenReading } from './utils/draw-tooltip/spoken-reading.js';
 export { drawValueAxis } from './utils/draw-value-axis/draw-value-axis.js';
 export { drawsInSoftware } from './utils/draws-in-software/draws-in-software.js';
 export { elapsedTime } from './utils/elapsed-time/elapsed-time.js';

package/dist/utils/reflect-elements/reflect-elements.d.ts

@@ -17,7 +17,9 @@ export type ElementsProperty = 'ariaControlsElements' | 'ariaDescribedByElements
 export declare const reflectElements: (target: Element | null | undefined, property: ElementsProperty, elements: readonly Element[], owned: boolean) => boolean;
 /**
  * Adds `by` to the elements that describe `target`, where that is safe, and
- * says whether `target` is now described by it.
+ * says whether it wrote the link, which is then the caller's to take back with
+ * `unlinkDescription`. A `target` described by `by` already is left alone and
+ * answers false.
  *
  * Through element reflection, and only where no framework is watching:
  *

package/dist/utils/reflect-elements/reflect-elements.js

@@ -19,7 +19,7 @@ export const linkDescription = (target, by, light) => {
     }
     const current = element.ariaDescribedByElements ?? [];
     if (current.includes(by)) {
-        return true;
+        return false;
     }
     const shadowed = typeof ShadowRoot !== 'undefined' && target.getRootNode() instanceof ShadowRoot;
     if (!shadowed &&

package/dist/version.d.ts

@@ -6,4 +6,4 @@
  * release, so the two never disagree; a spec beside this holds them to it.
  * Nothing else in the running code knows which release it is.
  */
-export declare const VERSION = "0.178.0";
+export declare const VERSION = "0.179.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.178.0';
+export const VERSION = '0.179.0';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-core",
   "description": "Helix element primitives: base classes, mixins, decorators, utilities.",
-  "version": "0.178.0",
+  "version": "0.179.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -68,11 +68,11 @@
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
     "@floating-ui/dom": "^1.8.0",
-    "@fusion.dev/helix-icons": "0.178.0"
+    "@fusion.dev/helix-icons": "0.179.0"
   },
   "devDependencies": {
-    "@fusion.dev/helix-cem": "0.178.0",
-    "@fusion.dev/helix-testing": "0.178.0",
+    "@fusion.dev/helix-cem": "0.179.0",
+    "@fusion.dev/helix-testing": "0.179.0",
     "@lit-labs/ssr": "^4.1.0",
     "lit": "^3.2.1"
   },