ember-primitives 0.45.0 → 0.46.0

package/declarations/components/heading.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heading.d.ts","sourceRoot":"","sources":["../../src/components/heading.gts"],"names":[],"mappings":"AAoKA,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAK3C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAyHtC,qBAAa,OAAQ,SAAQ,SAAS,CAAC;IACrC,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE;QAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC;CACzB,CAAC;IACA,kBAAkB,EAAE,IAAI,CAAC;gBACb,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM;IAMtC,IAAI,KAAK,WAWR;IAED,IAAI,MAAM,WAET;CAqBF"}
+{"version":3,"file":"heading.d.ts","sourceRoot":"","sources":["../../src/components/heading.gts"],"names":[],"mappings":"AAoCA,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAK3C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,qBAAa,OAAQ,SAAQ,SAAS,CAAC;IACrC,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE;QAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC;CACzB,CAAC;IACA,kBAAkB,EAAE,IAAI,CAAC;gBACb,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM;IAMtC,IAAI,KAAK,WAER;IAED,IAAI,MAAM,WAET;CAqBF"}

package/declarations/components/rating/{index.d.ts → rating.d.ts}

@@ -105,4 +105,4 @@ export declare class Rating extends Component<Signature> {
     get isReadonly(): boolean;
     get needsDescription(): boolean;
 }
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=rating.d.ts.map

package/declarations/components/rating/rating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../../../src/components/rating/rating.gts"],"names":[],"mappings":"AAoNA,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAK3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,SAAS;IAOxB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,IAAI,EAAE,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG;QACrC;;;;WAIG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf;;;;WAIG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;QAEnB;;;;;;WAMG;QACH,WAAW,CAAC,EAAE,OAAO,CAAC;QAEtB;;;WAGG;QACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;KACpC,CAAC;IAEF,MAAM,EAAE;QACN,OAAO,EAAE;YACP,MAAM,EAAE;gBACN;;mBAEG;gBACH,GAAG,EAAE,MAAM,CAAC;gBACZ;;mBAEG;gBACH,KAAK,EAAE,MAAM,CAAC;gBACd;;mBAEG;gBACH,KAAK,EAAE,MAAM,CAAC;gBACd;;mBAEG;gBACH,IAAI,EAAE,MAAM,CAAC;gBACb;;mBAEG;gBACH,UAAU,EAAE,OAAO,CAAC;gBACpB;;mBAEG;gBACH,YAAY,EAAE,OAAO,CAAC;gBACtB;;mBAEG;gBACH,KAAK,EAAE,aAAa,CAClB,OAAO,KAAK,EACZ,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,CACpE,CAAC;gBACF;;mBAEG;gBACH,KAAK,EAAE,aAAa,CAAC,OAAO,WAAW,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,cAAc,CAAC,CAAC;aACrF;SACF,CAAC;QACF,KAAK,EAAE;YACL,KAAK,EAAE;gBACL;;mBAEG;gBACH,KAAK,EAAE,MAAM,CAAC;gBAEd;;mBAEG;gBACH,KAAK,EAAE,MAAM,CAAC;aACf;SACF,CAAC;KACH,CAAC;CACH;AAED,qBAAa,MAAO,SAAQ,SAAS,CAAC,SAAS,CAAC;IAC9C,IAAI,SAA0B;IAE9B,IAAI,IAAI;;;;;;;;OAEP;IAED,IAAI,aAAa,YAEhB;IAED,IAAI,YAAY,YAIf;IAED,IAAI,UAAU,YAEb;IAED,IAAI,gBAAgB,YAEnB;CAgFF"}

package/declarations/components/rating.d.ts

@@ -1,4 +1,4 @@
-export { Rating } from './rating/index';
+export { Rating } from './rating/rating';
 import type { ComponentIcons } from "./rating/public-types.ts";
 export type IconType = ComponentIcons["icon"];
 //# sourceMappingURL=rating.d.ts.map

package/declarations/components/rating.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../../src/components/rating.gts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../../src/components/rating.gts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC"}

package/declarations/test-support/a11y.d.ts

@@ -1,3 +1,23 @@
+/**
+ * A QUnit test utility for setting up the tabbing utility that a few of the components in ember-primitive use for providing enhanced keyboard support.
+ *
+ * ```gjs
+ * import { module, test } from 'qunit';
+ * import { setupRenderingTest } from 'ember-qunit';
+ * import { setupTabster } from 'ember-primitives/test-support';
+ *
+ * module('your suite', function (hooks) {
+ *   setupRenderingTest(hooks);
+ *   setupTabster(hooks);
+ *
+ *   test('your test', async function (assert) {
+ *      // ...
+ *   });
+ * });
+ * ```
+ *
+ * This utility takes no options.
+ */
 export declare function setupTabster(hooks: {
     beforeEach: (callback: () => void | Promise<void>) => unknown;
 }): void;

package/declarations/test-support/a11y.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../../src/test-support/a11y.ts"],"names":[],"mappings":"AAgBA,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC;CAC/D,QAWA"}
+{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../../src/test-support/a11y.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC;CAC/D,QAWA"}

package/declarations/test-support/dom.d.ts

@@ -1,14 +1,82 @@
 import { find } from '@ember/test-helpers';
 type Findable = Parameters<typeof find>[0] | Element;
 /**
- * Find an element within a shadow-root.
+ * Find an element within a given element that has a shadow-root.
+ *
+ * If the `root` can't be found, or if there actually is no shadow root,
+ * nothing will be returned.
+ *
+ * ```gjs
+ * import { findInShadow } from 'ember-primitives/test-support';
+ *
+ * // ...
+ *
+ * test('...', async function (assert) {
+ *    // ...
+ *    const root = find('div.with-shadowdom');
+ *    assert.dom(findInShadow(root, 'h1')).containsText('welcome');
+ * });
+ * ```
  */
 export declare function findInShadow(root: Findable, query: string): Element | null | undefined;
 /**
  * Does the element have a shadow root?
+ *
+ * Using this utility function will only save a few characters over using its implementation directly.
+ *
+ * ```gjs
+ * import { hasShadowRoot } from 'ember-primitives/test-support';
+ *
+ * // ...
+ *
+ * test('...', async function (assert) {
+ *    // ...
+ *    const el = find('div.with-shadowdom');
+ *    assert.ok(hasShadowRoot(el), 'expecting el to have a shadow root');
+ * });
+ * ```
  */
 export declare function hasShadowRoot(el: Element): boolean;
+/**
+ * Find an element within `root`, that has a shadow root.
+ * The `root` param is optional, and if not provided, all of `#ember-testing` will be searched.
+ *
+ * This only returns the first-found shadow, so if you want a specifc shadow root,
+ * you'll need to narrow down the search by specifying a `root`.
+ *
+ * ```gjs
+ * import { findShadow } from 'ember-primitives/test-support';
+ *
+ * // ...
+ *
+ * test('...', async function (assert) {
+ *    // ...
+ *    const el = findShadow('div.with-shadowdom');
+ *    // ...
+ * });
+ * ```
+ */
 export declare function findShadow(root?: Findable): Element | undefined;
+/**
+ * For the first available shadow root on the page, query in to it, like you would with `querySelector`.
+ *
+ *
+ * ```gjs
+ * import { findInFirstShadow } from 'ember-primitives/test-support';
+ *
+ * // ...
+ *
+ * test('...', async function (assert) {
+ *    // ...
+ *    assert.dom(findInFirstShadow('h1')).containsText('welcome');
+ * });
+ * ```
+ *
+ * If there are multiple shadow roots on the page / test-render,
+ * this is not the utility for you.
+ *
+ * For querying in specific shadow roots, you'll want to use `findInShadow`
+ */
 export declare function findInFirstShadow(query: string): Element | null | undefined;
 export {};
 //# sourceMappingURL=dom.d.ts.map

package/declarations/test-support/dom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/test-support/dom.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;AAErD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,8BAIzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,WAExC;AAED,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,uBAczC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,8BAM9C"}
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/test-support/dom.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;AAErD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,8BAIzD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,WAExC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,uBAczC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,8BAM9C"}

package/declarations/test-support/otp.d.ts

@@ -1,4 +1,17 @@
 /**
+ * Fill the OTP input
+ *
+ * ```gjs
+ * import { fillOTP } from 'ember-primitives/test-support';
+ *
+ * test('...', async function(assert) {
+ *   // ...
+ *   await fillOTP('123456');
+ *   // ...
+ * })
+ *
+ * ```
+ *
  * @param {string} code the code to fill the input(s) with.
  * @param {string} [ selector ] if there are multiple OTP components on a page, this can be used to select one of them.
  */

package/declarations/test-support/otp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otp.d.ts","sourceRoot":"","sources":["../../src/test-support/otp.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,iBA2C5D"}
+{"version":3,"file":"otp.d.ts","sourceRoot":"","sources":["../../src/test-support/otp.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,iBA2C5D"}

package/declarations/test-support/routing.d.ts

@@ -28,5 +28,8 @@ import type RouterService from '@ember/routing/router-service';
 export declare function setupRouting(owner: Owner, map: DSLCallback, options?: {
     rootURL: string;
 }): void;
+/**
+ * A small utility that only gives you a _typed_ router service.
+ */
 export declare function getRouter(owner: Owner): RouterService;
 //# sourceMappingURL=routing.d.ts.map

package/declarations/test-support/routing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/test-support/routing.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,aAAa,MAAM,+BAA+B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,QAqBzF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,CAErD"}
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/test-support/routing.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,aAAa,MAAM,+BAA+B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,QAqBzF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,CAErD"}

package/dist/components/heading.js

@@ -1,83 +1,10 @@
 
 import Component from '@glimmer/component';
-import { assert } from '@ember/debug';
 import { element } from 'ember-element-helper';
+import { getSectionHeadingLevel } from 'which-heading-do-i-need';
 import { precompileTemplate } from '@ember/template-compilation';
 import { setComponentTemplate } from '@ember/component';
 
-const LOOKUP = new WeakMap();
-const BOUNDARY_ELEMENTS = new Set(["SECTION", "ARTICLE", "ASIDE", "HEADER", "FOOTER", "MAIN", "NAV"]);
-/**
- * A set with both cases is more performant than calling toLowerCase
- */
-const SECTION_HEADINGS = new Set(["h1", "h2", "h3", "h4", "h5", "h6", "H1", "H2", "H3", "H4", "H5", "H6"]);
-const TEST_BOUNDARY = "ember-testing";
-function isRoot(element) {
-  return element === document.body || element.id === TEST_BOUNDARY;
-}
-/**
- * The Platform native 'closest' function can't punch through shadow-boundaries
- */
-function nearestAncestor(node, matcher) {
-  let parent = node.parentElement;
-  if (!parent) return;
-  while (parent) {
-    if (parent instanceof Element) {
-      if (matcher(parent)) return parent;
-    }
-    if (parent instanceof ShadowRoot) {
-      parent = parent.host;
-    }
-    parent = parent.parentNode;
-  }
-}
-/**
- * The algorithm:
- *
- * section <- "our" level-changing boundary element
- *   h# <- the element we want to figure out the level of
- *
- * We start assuming we'll emit an h1.
- * We adjust this based on what we find crawling up the tree.
- *
- * While traversing up, when we go from the h# to the section,
- *  and ignore it. Because this alone has no bearing on if the h# should be an h2.
- *  We need to continue traversing upwards, until we hit the next boundary element.
- *
- * IF we would change the level the heading, we will find another heading between
- *  these two boundary elements.
- *  We'll need to check the subtrees between these elements, stopping if we
- *  encounter other boundary elements.
- *
- */
-function levelOf(node) {
-  const ourBoundary = nearestAncestor(node, el => BOUNDARY_ELEMENTS.has(el.tagName));
-  /**
-  * We are the top-level
-  */
-  if (!ourBoundary) {
-    return 1;
-  }
-  const stopAt = nearestAncestor(ourBoundary, el => {
-    if (BOUNDARY_ELEMENTS.has(el.tagName)) return true;
-    return isRoot(el);
-  });
-  assert(`[BUG]: Could not find a stopping boundary for automatic heading level detection. Checked for ${[...BOUNDARY_ELEMENTS, "body", "#ember-testing"].map(x => x.toLowerCase()).join(", ")}`, stopAt);
-  let current = ourBoundary.parentNode;
-  while (current) {
-    for (const child of current.children) {
-      if (!SECTION_HEADINGS.has(child.tagName)) continue;
-      const level = parseInt(child.tagName.replace("h", "").replace("H", ""));
-      return level + 1;
-    }
-    if (current === stopAt) break;
-    if (current instanceof ShadowRoot) {
-      current = current.host;
-    }
-    current = current.parentNode;
-  }
-  return 1;
-}
 class Heading extends Component {
   headingScopeAnchor;
   constructor(owner, args) {
@@ -85,12 +12,7 @@ class Heading extends Component {
     this.headingScopeAnchor = document.createTextNode("");
   }
   get level() {
-    const existing = LOOKUP.get(this.headingScopeAnchor);
-    if (existing) return existing;
-    const parentLevel = levelOf(this.headingScopeAnchor);
-    const myLevel = parentLevel;
-    LOOKUP.set(this.headingScopeAnchor, myLevel);
-    return myLevel;
+    return getSectionHeadingLevel(this.headingScopeAnchor);
   }
   get hLevel() {
     return `h${this.level}`;

package/dist/components/rating.js

@@ -1,3 +1,3 @@
 
-export { R as Rating } from '../index-D052JWRa.js';
+export { R as Rating } from '../rating-D052JWRa.js';
 //# sourceMappingURL=rating.js.map

package/dist/index.js

@@ -14,7 +14,7 @@ export { Popover } from './components/popover.js';
 export { Portal } from './components/portal.js';
 export { TARGETS as PORTALS, PortalTargets } from './components/portal-targets.js';
 export { Progress } from './components/progress.js';
-export { R as Rating } from './index-D052JWRa.js';
+export { R as Rating } from './rating-D052JWRa.js';
 export { Scroller } from './components/scroller.js';
 export { Shadowed } from './components/shadowed.js';
 export { Switch } from './components/switch.js';

package/dist/{index-D052JWRa.js → rating-D052JWRa.js}

@@ -146,4 +146,4 @@ class Rating extends Component {
 }
 
 export { Rating as R };
-//# sourceMappingURL=index-D052JWRa.js.map
+//# sourceMappingURL=rating-D052JWRa.js.map

package/dist/rating-D052JWRa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating-D052JWRa.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/test-support.js

@@ -16,6 +16,27 @@ async function setup(owner) {
   });
   document.querySelector('#ember-testing')?.setAttribute('data-tabster', '{ "root": {} }');
 }
+
+/**
+ * A QUnit test utility for setting up the tabbing utility that a few of the components in ember-primitive use for providing enhanced keyboard support.
+ *
+ * ```gjs
+ * import { module, test } from 'qunit';
+ * import { setupRenderingTest } from 'ember-qunit';
+ * import { setupTabster } from 'ember-primitives/test-support';
+ *
+ * module('your suite', function (hooks) {
+ *   setupRenderingTest(hooks);
+ *   setupTabster(hooks);
+ *
+ *   test('your test', async function (assert) {
+ *      // ...
+ *   });
+ * });
+ * ```
+ *
+ * This utility takes no options.
+ */
 function setupTabster(hooks) {
   hooks.beforeEach(async function () {
     const owner = this.owner;
@@ -25,7 +46,22 @@ function setupTabster(hooks) {
 }
 
 /**
- * Find an element within a shadow-root.
+ * Find an element within a given element that has a shadow-root.
+ *
+ * If the `root` can't be found, or if there actually is no shadow root,
+ * nothing will be returned.
+ *
+ * ```gjs
+ * import { findInShadow } from 'ember-primitives/test-support';
+ *
+ * // ...
+ *
+ * test('...', async function (assert) {
+ *    // ...
+ *    const root = find('div.with-shadowdom');
+ *    assert.dom(findInShadow(root, 'h1')).containsText('welcome');
+ * });
+ * ```
  */
 function findInShadow(root, query) {
   const rootElement = root instanceof Element ? root : find(root);
@@ -34,10 +70,44 @@ function findInShadow(root, query) {
 
 /**
  * Does the element have a shadow root?
+ *
+ * Using this utility function will only save a few characters over using its implementation directly.
+ *
+ * ```gjs
+ * import { hasShadowRoot } from 'ember-primitives/test-support';
+ *
+ * // ...
+ *
+ * test('...', async function (assert) {
+ *    // ...
+ *    const el = find('div.with-shadowdom');
+ *    assert.ok(hasShadowRoot(el), 'expecting el to have a shadow root');
+ * });
+ * ```
  */
 function hasShadowRoot(el) {
   return Boolean(el.shadowRoot);
 }
+
+/**
+ * Find an element within `root`, that has a shadow root.
+ * The `root` param is optional, and if not provided, all of `#ember-testing` will be searched.
+ *
+ * This only returns the first-found shadow, so if you want a specifc shadow root,
+ * you'll need to narrow down the search by specifying a `root`.
+ *
+ * ```gjs
+ * import { findShadow } from 'ember-primitives/test-support';
+ *
+ * // ...
+ *
+ * test('...', async function (assert) {
+ *    // ...
+ *    const el = findShadow('div.with-shadowdom');
+ *    // ...
+ * });
+ * ```
+ */
 function findShadow(root) {
   const rootElement = root ? root instanceof Element ? root : find(root) : document.getElementById('ember-testing');
   if (!rootElement) return;
@@ -47,6 +117,27 @@ function findShadow(root) {
     }
   }
 }
+
+/**
+ * For the first available shadow root on the page, query in to it, like you would with `querySelector`.
+ *
+ *
+ * ```gjs
+ * import { findInFirstShadow } from 'ember-primitives/test-support';
+ *
+ * // ...
+ *
+ * test('...', async function (assert) {
+ *    // ...
+ *    assert.dom(findInFirstShadow('h1')).containsText('welcome');
+ * });
+ * ```
+ *
+ * If there are multiple shadow roots on the page / test-render,
+ * this is not the utility for you.
+ *
+ * For querying in specific shadow roots, you'll want to use `findInShadow`
+ */
 function findInFirstShadow(query) {
   const host = findShadow();
   assert(`No element with a shadow root could be found`, host);
@@ -54,6 +145,19 @@ function findInFirstShadow(query) {
 }
 
 /**
+ * Fill the OTP input
+ *
+ * ```gjs
+ * import { fillOTP } from 'ember-primitives/test-support';
+ *
+ * test('...', async function(assert) {
+ *   // ...
+ *   await fillOTP('123456');
+ *   // ...
+ * })
+ *
+ * ```
+ *
  * @param {string} code the code to fill the input(s) with.
  * @param {string} [ selector ] if there are multiple OTP components on a page, this can be used to select one of them.
  */
@@ -209,6 +313,10 @@ function setupRouting(owner, map, options) {
   // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
   iKnowWhatIMDoing.setupRouter();
 }
+
+/**
+ * A small utility that only gives you a _typed_ router service.
+ */
 function getRouter(owner) {
   return owner.lookup('service:router');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ember-primitives",
-  "version": "0.45.0",
+  "version": "0.46.0",
   "description": "Making apps easier to build",
   "keywords": [
     "ember-addon"
@@ -25,7 +25,8 @@
     "should-handle-link": "^1.2.2",
     "tabster": "^8.5.5",
     "tracked-built-ins": "^4.0.0",
-    "tracked-toolbox": "^2.0.0"
+    "tracked-toolbox": "^2.0.0",
+    "which-heading-do-i-need": "0.1.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.0",

package/declarations/components/rating/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/rating/index.gts"],"names":[],"mappings":"AAoNA,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAK3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGpC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,SAAS;IAOxB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,IAAI,EAAE,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG;QACrC;;;;WAIG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf;;;;WAIG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;QAEnB;;;;;;WAMG;QACH,WAAW,CAAC,EAAE,OAAO,CAAC;QAEtB;;;WAGG;QACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;KACpC,CAAC;IAEF,MAAM,EAAE;QACN,OAAO,EAAE;YACP,MAAM,EAAE;gBACN;;mBAEG;gBACH,GAAG,EAAE,MAAM,CAAC;gBACZ;;mBAEG;gBACH,KAAK,EAAE,MAAM,CAAC;gBACd;;mBAEG;gBACH,KAAK,EAAE,MAAM,CAAC;gBACd;;mBAEG;gBACH,IAAI,EAAE,MAAM,CAAC;gBACb;;mBAEG;gBACH,UAAU,EAAE,OAAO,CAAC;gBACpB;;mBAEG;gBACH,YAAY,EAAE,OAAO,CAAC;gBACtB;;mBAEG;gBACH,KAAK,EAAE,aAAa,CAClB,OAAO,KAAK,EACZ,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,CACpE,CAAC;gBACF;;mBAEG;gBACH,KAAK,EAAE,aAAa,CAAC,OAAO,WAAW,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,cAAc,CAAC,CAAC;aACrF;SACF,CAAC;QACF,KAAK,EAAE;YACL,KAAK,EAAE;gBACL;;mBAEG;gBACH,KAAK,EAAE,MAAM,CAAC;gBAEd;;mBAEG;gBACH,KAAK,EAAE,MAAM,CAAC;aACf;SACF,CAAC;KACH,CAAC;CACH;AAED,qBAAa,MAAO,SAAQ,SAAS,CAAC,SAAS,CAAC;IAC9C,IAAI,SAA0B;IAE9B,IAAI,IAAI;;;;;;;;OAEP;IAED,IAAI,aAAa,YAEhB;IAED,IAAI,YAAY,YAIf;IAED,IAAI,UAAU,YAEb;IAED,IAAI,gBAAgB,YAEnB;CAgFF"}

package/dist/index-D052JWRa.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-D052JWRa.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}