ember-primitives 0.59.0 → 0.59.1

package/declarations/components/incremental-each.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"incremental-each.d.ts","sourceRoot":"","sources":["../../src/components/incremental-each.gts"],"names":[],"mappings":"AAoSA,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAQ3C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAiBtC,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,IAAI,EAAE;QACJ;;;;;;;;;;;;;;;WAeG;QACH,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QAEpB;;;;;;;;;;;;;;;;;WAiBG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;WA0BG;QACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAE1B;;;;;;;;;;;;;;;;;;;;;;WAsBG;QACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;KACrB,CAAC;IACF,MAAM,EAAE;QACN;;;;;;;;;;;;;WAaG;QACH,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;KACnC,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;;gBAM3D,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAsCpD,IAAI,CAAC,WAEJ;IAED,IACI,QAAQ;;;;;;QAWX;IA2BD,IAAI,aAIF;IAEF,SAAS,aAYP;CA4BH"}
+{"version":3,"file":"incremental-each.d.ts","sourceRoot":"","sources":["../../src/components/incremental-each.gts"],"names":[],"mappings":"AA6SA,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAQ3C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AA0BtC,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,IAAI,EAAE;QACJ;;;;;;;;;;;;;;;WAeG;QACH,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;QAEpB;;;;;;;;;;;;;;;;;WAiBG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;WA0BG;QACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAE1B;;;;;;;;;;;;;;;;;;;;;;WAsBG;QACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;KACrB,CAAC;IACF,MAAM,EAAE;QACN;;;;;;;;;;;;;WAaG;QACH,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;KACnC,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;;gBAM3D,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAsCpD,IAAI,CAAC,WAEJ;IAED,IACI,QAAQ;;;;;;QAWX;IA2BD,IAAI,aAIF;IAEF,SAAS,aAYP;CA4BH"}

package/dist/components/incremental-each.js

@@ -18,6 +18,14 @@ function chunk(arr, size) {
   }
   return out;
 }
+// Safari has `requestIdleCallback` behind a flag, effectively absent
+// for end users. Fall back to `setTimeout(cb, 0)` — Safari users get
+// the chunking benefit (one batch per task) without the idle-priority
+// hint that other browsers honor.
+const ric = typeof requestIdleCallback === "function" ? requestIdleCallback : cb => setTimeout(() => cb({
+  timeRemaining: () => 0,
+  didTimeout: true
+}), 0);
 /**
  * A drop-in replacement for `{{#each}}` that renders a large collection
  * a batch at a time on each animation frame, instead of all at once.
@@ -122,7 +130,7 @@ class IncrementalEach extends Component {
   // otherwise tracked-value backtracking asserts.
   tick = () => {
     if (this.#items.length > this.#count.current) {
-      requestIdleCallback(() => this.#count.current++, {
+      ric(() => this.#count.current++, {
         timeout: 10
       });
     }

package/dist/components/incremental-each.js.map

@@ -1 +1 @@
-{"version":3,"file":"incremental-each.js","sources":["../../src/components/incremental-each.gts"],"sourcesContent":["import Component from \"@glimmer/component\";\nimport { cached } from \"@glimmer/tracking\";\nimport { assert } from \"@ember/debug\";\nimport { isDestroyed, isDestroying, registerDestructor } from \"@ember/destroyable\";\nimport { buildWaiter } from \"@ember/test-waiters\";\n\nimport { cell } from \"ember-resources\";\n\nimport type Owner from \"@ember/owner\";\n\nconst DEFAULT_BATCH_SIZE = 50;\nconst DEFAULT_INITIAL = \"sync\";\n\nconst waiter = buildWaiter(\"ember-primitives:incremental-each\");\n\nfunction chunk<T>(arr: readonly T[], size: number): T[][] {\n  const out: T[][] = [];\n\n  for (let i = 0; i < arr.length; i += size) {\n    out.push(arr.slice(i, i + size));\n  }\n\n  return out;\n}\n\nexport interface Signature<T = unknown> {\n  Args: {\n    /**\n     * The collection of items to render.\n     *\n     * Replacing the array (new identity) restarts rendering from the\n     * first batch.\n     *\n     * ```gjs\n     * import { IncrementalEach } from 'ember-primitives';\n     *\n     * <template>\n     *   <IncrementalEach @items={{this.rows}} as |row|>\n     *     <my-row @row={{row}} />\n     *   </IncrementalEach>\n     * </template>\n     * ```\n     */\n    items: readonly T[];\n\n    /**\n     * How many items to add per animation frame.\n     *\n     * Larger batches add more items per chunk; smaller batches yield to\n     * the browser more often.\n     *\n     * Default: 50. Must be positive; `0` or less asserts in development.\n     *\n     * ```gjs\n     * import { IncrementalEach } from 'ember-primitives';\n     *\n     * <template>\n     *   <IncrementalEach @items={{this.rows}} @batchSize={{100}} as |row|>\n     *     <my-row @row={{row}} />\n     *   </IncrementalEach>\n     * </template>\n     * ```\n     */\n    batchSize?: number;\n\n    /**\n     * Controls how the initial batch is committed.\n     *\n     * - `\"sync\"` (default): the first `@batchSize` items render in the\n     *   same render pass as mount / `@items` change. The user sees\n     *   content on the very first paint, and the rest of the list\n     *   fills in one batch per animation frame. This is the right\n     *   default for most lists — even a perceived \"empty for one\n     *   frame\" is worse than rendering a few extra items synchronously.\n     * - `\"lazy\"`: even the first batch waits for an animation frame, so\n     *   the initial paint is empty and content arrives one batch per\n     *   frame. Use this when the first batch itself would be expensive\n     *   enough to block the first paint, and you'd rather show an\n     *   empty container than delay it.\n     *\n     * Default: `\"sync\"`.\n     *\n     * ```gjs\n     * import { IncrementalEach } from 'ember-primitives';\n     *\n     * <template>\n     *   <IncrementalEach @items={{this.rows}} @initial=\"lazy\" as |row|>\n     *     <my-row @row={{row}} />\n     *   </IncrementalEach>\n     * </template>\n     * ```\n     */\n    initial?: \"sync\" | \"lazy\";\n\n    /**\n     * Called once with no arguments when every item in `@items` has\n     * been committed to the DOM. Fires after the final batch lands;\n     * does not fire on intermediate batches.\n     *\n     * Fires again on a fresh swap (new `@items` identity) once that\n     * new collection finishes rendering. An empty `@items` array\n     * does not fire the callback.\n     *\n     * Useful for marking the list as ready for screenshot tests,\n     * dismissing a loading indicator, or measuring how long the\n     * whole render took.\n     *\n     * ```gjs\n     * import { IncrementalEach } from 'ember-primitives';\n     *\n     * <template>\n     *   <IncrementalEach @items={{this.rows}} @onDone={{this.handleDone}} as |row|>\n     *     <my-row @row={{row}} />\n     *   </IncrementalEach>\n     * </template>\n     * ```\n     */\n    onDone?: () => void;\n  };\n  Blocks: {\n    /**\n     * Yielded for each rendered item, with the index in the original\n     * `@items` array.\n     *\n     * ```gjs\n     * import { IncrementalEach } from 'ember-primitives';\n     *\n     * <template>\n     *   <IncrementalEach @items={{this.rows}} as |row index|>\n     *     {{index}}: {{row.label}}\n     *   </IncrementalEach>\n     * </template>\n     * ```\n     */\n    default: [item: T, index: number];\n  };\n}\n\n/**\n * A drop-in replacement for `{{#each}}` that renders a large collection\n * a batch at a time on each animation frame, instead of all at once.\n *\n * Every item ends up in the DOM, so browser find (Ctrl+F / Cmd+F), anchor\n * links, screen readers, print, and SEO all work against the full list.\n * Yielding the main thread between batches keeps the page responsive while\n * the rest of the list is filling in.\n *\n * By default the first batch lands synchronously, so the user sees content\n * on the very first paint. Pass `@initial=\"lazy\"` to defer the first batch\n * to an animation frame as well.\n *\n * Intended for non-scrollable containers, or anywhere a virtual/windowed\n * list does not apply (variable item heights, lists that grow the page,\n * surfaces that need every row indexable).\n *\n * Do not nest one `<IncrementalEach>` inside another. Each level adds an\n * animation-frame delay before its content paints; nesting compounds those\n * delays, so inner rows appear to flicker in with missing sub-content.\n * If you have nested loops, only the outermost one should be\n * `<IncrementalEach>`; leave deeper loops as plain `{{#each}}`.\n *\n * @example\n * ```gjs\n * import { IncrementalEach } from 'ember-primitives';\n *\n * <template>\n *   <ul>\n *     <IncrementalEach @items={{this.rows}} @batchSize={{100}} as |row index|>\n *       <li>{{index}}: {{row.label}}</li>\n *     </IncrementalEach>\n *   </ul>\n * </template>\n * ```\n */\nexport class IncrementalEach<T = unknown> extends Component<Signature<T>> {\n  #count = cell(0);\n  #itemsRef: readonly T[] | null = null;\n  #waiterToken: unknown = null;\n  #doneFor: object | null = null;\n\n  constructor(owner: Owner, args: Signature<T>[\"Args\"]) {\n    super(owner, args);\n\n    registerDestructor(this, () => this.#endWaiter());\n  }\n\n  // Reset progress and (re)open the test-waiter when `@items` identity\n  // changes, so a swap restarts at the first batch, `@onDone` can fire\n  // again for the new collection, and `await settled()` knows to wait\n  // until `checkDone` closes the waiter. Mutating from a getter is safe\n  // here because the writes happen before any consumer reads them in\n  // the same render pass.\n  /* eslint-disable ember/no-side-effects */\n  get #items(): readonly T[] {\n    const items = this.args.items;\n\n    assert(`@items must be an array`, items);\n\n    if (items !== this.#itemsRef) {\n      this.#itemsRef = items;\n      this.#count.current = 0;\n      this.#endWaiter();\n\n      if (items.length > 0) {\n        this.#waiterToken = waiter.beginAsync();\n      }\n    }\n\n    return items;\n  }\n  /* eslint-enable ember/no-side-effects */\n\n  // `\"sync\"` keeps bucket 0 visible at count=0 (`i = 0 >= 0`); `\"lazy\"`\n  // starts one step behind so even bucket 0 needs a tick.\n  get #start() {\n    return this.#initial === \"sync\" ? 0 : -1;\n  }\n\n  get i() {\n    return this.#start + this.#count.current;\n  }\n\n  @cached\n  get bucketed() {\n    const size = this.#batchSize;\n\n    return chunk(this.#items, size).map((items, b) => {\n      const start = b * size;\n\n      return {\n        isReady: () => this.i >= b,\n        items: items.map((value, j) => ({ value, index: start + j })),\n      };\n    });\n  }\n\n  get #batchSize(): number {\n    const requested = this.args.batchSize ?? DEFAULT_BATCH_SIZE;\n\n    assert(\n      `<IncrementalEach> @batchSize must be a positive number, got ${requested}`,\n      requested > 0,\n    );\n\n    return requested;\n  }\n\n  get #initial(): \"sync\" | \"lazy\" {\n    const requested = this.args.initial ?? DEFAULT_INITIAL;\n\n    assert(\n      `<IncrementalEach> @initial must be \"sync\" or \"lazy\", got ${requested}`,\n      requested === \"sync\" || requested === \"lazy\",\n    );\n\n    return requested;\n  }\n\n  // `#items` is read before `#count` so the count-reset inside `#items`\n  // (on `@items` swap) lands before this read of count this render —\n  // otherwise tracked-value backtracking asserts.\n  tick = () => {\n    if (this.#items.length > this.#count.current) {\n      requestIdleCallback(() => this.#count.current++, { timeout: 10 });\n    }\n  };\n\n  checkDone = () => {\n    const bucketed = this.bucketed;\n\n    if (this.#doneFor === bucketed) return;\n    if (this.i < bucketed.length - 1) return;\n\n    this.#doneFor = bucketed;\n    queueMicrotask(() => {\n      if (isDestroyed(this) || isDestroying(this)) return;\n      this.args.onDone?.();\n      this.#endWaiter();\n    });\n  };\n\n  #endWaiter() {\n    if (this.#waiterToken) waiter.endAsync(this.#waiterToken);\n  }\n\n  <template>\n    {{(this.tick)}}{{#each this.bucketed as |bucket|}}{{#if (bucket.isReady)}}{{#each\n          bucket.items\n          as |entry|\n        }}{{yield entry.value entry.index}}{{/each}}{{(this.checkDone)}}{{/if}}{{/each}}\n  </template>\n}\n"],"names":["DEFAULT_BATCH_SIZE","DEFAULT_INITIAL","waiter","buildWaiter","chunk","arr","size","out","i","length","push","slice","IncrementalEach","Component","cell","constructor","owner","args","registerDestructor","#items","items","assert","current","beginAsync","#start","bucketed","map","b","start","isReady","value","j","index","n","prototype","cached","#batchSize","requested","batchSize","#initial","initial","tick","requestIdleCallback","timeout","checkDone","queueMicrotask","isDestroyed","isDestroying","onDone","#endWaiter","endAsync","setComponentTemplate","precompileTemplate","strictMode"],"mappings":"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"}
+{"version":3,"file":"incremental-each.js","sources":["../../src/components/incremental-each.gts"],"sourcesContent":["import Component from \"@glimmer/component\";\nimport { cached } from \"@glimmer/tracking\";\nimport { assert } from \"@ember/debug\";\nimport { isDestroyed, isDestroying, registerDestructor } from \"@ember/destroyable\";\nimport { buildWaiter } from \"@ember/test-waiters\";\n\nimport { cell } from \"ember-resources\";\n\nimport type Owner from \"@ember/owner\";\n\nconst DEFAULT_BATCH_SIZE = 50;\nconst DEFAULT_INITIAL = \"sync\";\n\nconst waiter = buildWaiter(\"ember-primitives:incremental-each\");\n\nfunction chunk<T>(arr: readonly T[], size: number): T[][] {\n  const out: T[][] = [];\n\n  for (let i = 0; i < arr.length; i += size) {\n    out.push(arr.slice(i, i + size));\n  }\n\n  return out;\n}\n\n// Safari has `requestIdleCallback` behind a flag, effectively absent\n// for end users. Fall back to `setTimeout(cb, 0)` — Safari users get\n// the chunking benefit (one batch per task) without the idle-priority\n// hint that other browsers honor.\nconst ric: typeof requestIdleCallback =\n  typeof requestIdleCallback === \"function\"\n    ? requestIdleCallback\n    : (cb) => setTimeout(() => cb({ timeRemaining: () => 0, didTimeout: true }), 0);\n\nexport interface Signature<T = unknown> {\n  Args: {\n    /**\n     * The collection of items to render.\n     *\n     * Replacing the array (new identity) restarts rendering from the\n     * first batch.\n     *\n     * ```gjs\n     * import { IncrementalEach } from 'ember-primitives';\n     *\n     * <template>\n     *   <IncrementalEach @items={{this.rows}} as |row|>\n     *     <my-row @row={{row}} />\n     *   </IncrementalEach>\n     * </template>\n     * ```\n     */\n    items: readonly T[];\n\n    /**\n     * How many items to add per animation frame.\n     *\n     * Larger batches add more items per chunk; smaller batches yield to\n     * the browser more often.\n     *\n     * Default: 50. Must be positive; `0` or less asserts in development.\n     *\n     * ```gjs\n     * import { IncrementalEach } from 'ember-primitives';\n     *\n     * <template>\n     *   <IncrementalEach @items={{this.rows}} @batchSize={{100}} as |row|>\n     *     <my-row @row={{row}} />\n     *   </IncrementalEach>\n     * </template>\n     * ```\n     */\n    batchSize?: number;\n\n    /**\n     * Controls how the initial batch is committed.\n     *\n     * - `\"sync\"` (default): the first `@batchSize` items render in the\n     *   same render pass as mount / `@items` change. The user sees\n     *   content on the very first paint, and the rest of the list\n     *   fills in one batch per animation frame. This is the right\n     *   default for most lists — even a perceived \"empty for one\n     *   frame\" is worse than rendering a few extra items synchronously.\n     * - `\"lazy\"`: even the first batch waits for an animation frame, so\n     *   the initial paint is empty and content arrives one batch per\n     *   frame. Use this when the first batch itself would be expensive\n     *   enough to block the first paint, and you'd rather show an\n     *   empty container than delay it.\n     *\n     * Default: `\"sync\"`.\n     *\n     * ```gjs\n     * import { IncrementalEach } from 'ember-primitives';\n     *\n     * <template>\n     *   <IncrementalEach @items={{this.rows}} @initial=\"lazy\" as |row|>\n     *     <my-row @row={{row}} />\n     *   </IncrementalEach>\n     * </template>\n     * ```\n     */\n    initial?: \"sync\" | \"lazy\";\n\n    /**\n     * Called once with no arguments when every item in `@items` has\n     * been committed to the DOM. Fires after the final batch lands;\n     * does not fire on intermediate batches.\n     *\n     * Fires again on a fresh swap (new `@items` identity) once that\n     * new collection finishes rendering. An empty `@items` array\n     * does not fire the callback.\n     *\n     * Useful for marking the list as ready for screenshot tests,\n     * dismissing a loading indicator, or measuring how long the\n     * whole render took.\n     *\n     * ```gjs\n     * import { IncrementalEach } from 'ember-primitives';\n     *\n     * <template>\n     *   <IncrementalEach @items={{this.rows}} @onDone={{this.handleDone}} as |row|>\n     *     <my-row @row={{row}} />\n     *   </IncrementalEach>\n     * </template>\n     * ```\n     */\n    onDone?: () => void;\n  };\n  Blocks: {\n    /**\n     * Yielded for each rendered item, with the index in the original\n     * `@items` array.\n     *\n     * ```gjs\n     * import { IncrementalEach } from 'ember-primitives';\n     *\n     * <template>\n     *   <IncrementalEach @items={{this.rows}} as |row index|>\n     *     {{index}}: {{row.label}}\n     *   </IncrementalEach>\n     * </template>\n     * ```\n     */\n    default: [item: T, index: number];\n  };\n}\n\n/**\n * A drop-in replacement for `{{#each}}` that renders a large collection\n * a batch at a time on each animation frame, instead of all at once.\n *\n * Every item ends up in the DOM, so browser find (Ctrl+F / Cmd+F), anchor\n * links, screen readers, print, and SEO all work against the full list.\n * Yielding the main thread between batches keeps the page responsive while\n * the rest of the list is filling in.\n *\n * By default the first batch lands synchronously, so the user sees content\n * on the very first paint. Pass `@initial=\"lazy\"` to defer the first batch\n * to an animation frame as well.\n *\n * Intended for non-scrollable containers, or anywhere a virtual/windowed\n * list does not apply (variable item heights, lists that grow the page,\n * surfaces that need every row indexable).\n *\n * Do not nest one `<IncrementalEach>` inside another. Each level adds an\n * animation-frame delay before its content paints; nesting compounds those\n * delays, so inner rows appear to flicker in with missing sub-content.\n * If you have nested loops, only the outermost one should be\n * `<IncrementalEach>`; leave deeper loops as plain `{{#each}}`.\n *\n * @example\n * ```gjs\n * import { IncrementalEach } from 'ember-primitives';\n *\n * <template>\n *   <ul>\n *     <IncrementalEach @items={{this.rows}} @batchSize={{100}} as |row index|>\n *       <li>{{index}}: {{row.label}}</li>\n *     </IncrementalEach>\n *   </ul>\n * </template>\n * ```\n */\nexport class IncrementalEach<T = unknown> extends Component<Signature<T>> {\n  #count = cell(0);\n  #itemsRef: readonly T[] | null = null;\n  #waiterToken: unknown = null;\n  #doneFor: object | null = null;\n\n  constructor(owner: Owner, args: Signature<T>[\"Args\"]) {\n    super(owner, args);\n\n    registerDestructor(this, () => this.#endWaiter());\n  }\n\n  // Reset progress and (re)open the test-waiter when `@items` identity\n  // changes, so a swap restarts at the first batch, `@onDone` can fire\n  // again for the new collection, and `await settled()` knows to wait\n  // until `checkDone` closes the waiter. Mutating from a getter is safe\n  // here because the writes happen before any consumer reads them in\n  // the same render pass.\n  /* eslint-disable ember/no-side-effects */\n  get #items(): readonly T[] {\n    const items = this.args.items;\n\n    assert(`@items must be an array`, items);\n\n    if (items !== this.#itemsRef) {\n      this.#itemsRef = items;\n      this.#count.current = 0;\n      this.#endWaiter();\n\n      if (items.length > 0) {\n        this.#waiterToken = waiter.beginAsync();\n      }\n    }\n\n    return items;\n  }\n  /* eslint-enable ember/no-side-effects */\n\n  // `\"sync\"` keeps bucket 0 visible at count=0 (`i = 0 >= 0`); `\"lazy\"`\n  // starts one step behind so even bucket 0 needs a tick.\n  get #start() {\n    return this.#initial === \"sync\" ? 0 : -1;\n  }\n\n  get i() {\n    return this.#start + this.#count.current;\n  }\n\n  @cached\n  get bucketed() {\n    const size = this.#batchSize;\n\n    return chunk(this.#items, size).map((items, b) => {\n      const start = b * size;\n\n      return {\n        isReady: () => this.i >= b,\n        items: items.map((value, j) => ({ value, index: start + j })),\n      };\n    });\n  }\n\n  get #batchSize(): number {\n    const requested = this.args.batchSize ?? DEFAULT_BATCH_SIZE;\n\n    assert(\n      `<IncrementalEach> @batchSize must be a positive number, got ${requested}`,\n      requested > 0,\n    );\n\n    return requested;\n  }\n\n  get #initial(): \"sync\" | \"lazy\" {\n    const requested = this.args.initial ?? DEFAULT_INITIAL;\n\n    assert(\n      `<IncrementalEach> @initial must be \"sync\" or \"lazy\", got ${requested}`,\n      requested === \"sync\" || requested === \"lazy\",\n    );\n\n    return requested;\n  }\n\n  // `#items` is read before `#count` so the count-reset inside `#items`\n  // (on `@items` swap) lands before this read of count this render —\n  // otherwise tracked-value backtracking asserts.\n  tick = () => {\n    if (this.#items.length > this.#count.current) {\n      ric(() => this.#count.current++, { timeout: 10 });\n    }\n  };\n\n  checkDone = () => {\n    const bucketed = this.bucketed;\n\n    if (this.#doneFor === bucketed) return;\n    if (this.i < bucketed.length - 1) return;\n\n    this.#doneFor = bucketed;\n    queueMicrotask(() => {\n      if (isDestroyed(this) || isDestroying(this)) return;\n      this.args.onDone?.();\n      this.#endWaiter();\n    });\n  };\n\n  #endWaiter() {\n    if (this.#waiterToken) waiter.endAsync(this.#waiterToken);\n  }\n\n  <template>\n    {{(this.tick)}}{{#each this.bucketed as |bucket|}}{{#if (bucket.isReady)}}{{#each\n          bucket.items\n          as |entry|\n        }}{{yield entry.value entry.index}}{{/each}}{{(this.checkDone)}}{{/if}}{{/each}}\n  </template>\n}\n"],"names":["DEFAULT_BATCH_SIZE","DEFAULT_INITIAL","waiter","buildWaiter","chunk","arr","size","out","i","length","push","slice","ric","requestIdleCallback","cb","setTimeout","timeRemaining","didTimeout","IncrementalEach","Component","cell","constructor","owner","args","registerDestructor","#items","items","assert","current","beginAsync","#start","bucketed","map","b","start","isReady","value","j","index","n","prototype","cached","#batchSize","requested","batchSize","#initial","initial","tick","timeout","checkDone","queueMicrotask","isDestroyed","isDestroying","onDone","#endWaiter","endAsync","setComponentTemplate","precompileTemplate","strictMode"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ember-primitives",
-  "version": "0.59.0",
+  "version": "0.59.1",
   "description": "Making apps easier to build",
   "keywords": [
     "ember-addon"

package/src/components/incremental-each.gts

@@ -23,6 +23,15 @@ function chunk<T>(arr: readonly T[], size: number): T[][] {
   return out;
 }
 
+// Safari has `requestIdleCallback` behind a flag, effectively absent
+// for end users. Fall back to `setTimeout(cb, 0)` — Safari users get
+// the chunking benefit (one batch per task) without the idle-priority
+// hint that other browsers honor.
+const ric: typeof requestIdleCallback =
+  typeof requestIdleCallback === "function"
+    ? requestIdleCallback
+    : (cb) => setTimeout(() => cb({ timeRemaining: () => 0, didTimeout: true }), 0);
+
 export interface Signature<T = unknown> {
   Args: {
     /**
@@ -261,7 +270,7 @@ export class IncrementalEach<T = unknown> extends Component<Signature<T>> {
   // otherwise tracked-value backtracking asserts.
   tick = () => {
     if (this.#items.length > this.#count.current) {
-      requestIdleCallback(() => this.#count.current++, { timeout: 10 });
+      ric(() => this.#count.current++, { timeout: 10 });
     }
   };