@discourse/types 2026.8.0-fb9247e0 → 2026.9.0-c0ef3a11

package/declarations/app/ui-kit/d-filter-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d-filter-input.d.ts","sourceRoot":"","sources":["../../../../discourse/app/ui-kit/d-filter-input.gts"],"names":[],"mappings":"AAAA,OAoHO,SAAS,MAAM,oBAAoB,CAAC;AAY3C,UAAU,qBAAqB;IAC7B,IAAI,EAAE;QACJ,+BAA+B;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,2CAA2C;QAC3C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QAEtC,sDAAsD;QACtD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QAEtC,wCAAwC;QACxC,KAAK,CAAC,EAAE;YACN,0DAA0D;YAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;YAEd,wDAAwD;YACxD,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC;QAEF,+DAA+D;QAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IAEF,OAAO,EAAE,gBAAgB,CAAC;IAE1B,MAAM,EAAE;QACN,8DAA8D;QAC9D,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,SAAS,CAAC,qBAAqB,CAAC;;IAC/D,SAAS,UAAS;IAE3B,aAAa;;;;;;OAEV;IAEH,UAAU;;;;;;OAeP;IAKH,YAAY,CAAC,KAAK,EAAE,KAAK;CAsD1B"}
+{"version":3,"file":"d-filter-input.d.ts","sourceRoot":"","sources":["../../../../discourse/app/ui-kit/d-filter-input.gts"],"names":[],"mappings":"AAAA,OAuHO,SAAS,MAAM,oBAAoB,CAAC;AAY3C,UAAU,qBAAqB;IAC7B,IAAI,EAAE;QACJ,+BAA+B;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,2CAA2C;QAC3C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QAEtC,sDAAsD;QACtD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;QAEtC,wCAAwC;QACxC,KAAK,CAAC,EAAE;YACN,0DAA0D;YAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;YAEd,wDAAwD;YACxD,KAAK,CAAC,EAAE,MAAM,CAAC;SAChB,CAAC;QAEF,+DAA+D;QAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IAEF,OAAO,EAAE,gBAAgB,CAAC;IAE1B,MAAM,EAAE;QACN,8DAA8D;QAC9D,OAAO,EAAE,EAAE,CAAC;KACb,CAAC;CACH;AAED,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,SAAS,CAAC,qBAAqB,CAAC;;IAC/D,SAAS,UAAS;IAE3B,aAAa;;;;;;OAEV;IAEH,UAAU;;;;;;OAeP;IAKH,YAAY,CAAC,KAAK,EAAE,KAAK;CA4D1B"}

package/declarations/app/ui-kit/d-icon-grid-picker/content.d.ts

@@ -7,7 +7,7 @@
  * @param {string[]} [favorites] - Icon IDs to display in a pinned favorites row above the grid.
  * @param {boolean} [showSelectedName] - When true, the selected favorite chip also displays
  *   the icon name alongside the icon.
- * @param {boolean} [onlyAvailable] - When true, only shows icons available in the
+ * @param {boolean} [onlyAvailable] - When true, only offers icons available in the
  *   current SVG sprite set. Defaults to true.
  */
 export default class DIconGridPickerContent extends Component<any> {
@@ -15,7 +15,21 @@ export default class DIconGridPickerContent extends Component<any> {
     /** @type {import("discourse/float-kit/services/tooltip").default} */
     tooltip: import("discourse/float-kit/services/tooltip").default;
     filter: string;
-    resultCount: any;
+    /** @type {Array<{id: string, symbol?: string}>?} Null until the first page resolves. */
+    icons: Array<{
+        id: string;
+        symbol?: string;
+    }> | null;
+    hasMore: boolean;
+    loadingMore: boolean;
+    gridWrapper: any;
+    registerGridWrapper: import("ember-modifier").FunctionBasedModifier<{
+        Args: {
+            Positional: unknown[];
+            Named: import("ember-modifier/-private/signature").EmptyObject;
+        };
+        Element: HTMLElement;
+    }>;
     /**
      * Modifier that measures the natural content width of the selected-chip element
      * and snaps it to the nearest number of grid columns so it aligns with the
@@ -30,10 +44,11 @@ export default class DIconGridPickerContent extends Component<any> {
         Element: HTMLElement;
     }>;
     /**
-     * Modifier that registers a hover tooltip showing the icon ID on each grid cell.
-     * Skips the selected-chip element since it already displays the name inline.
+     * Modifier that shows a hover tooltip with the icon ID for any cell in the
+     * grid. One delegated tooltip rather than one per cell, since the grid grows
+     * by a page at a time. The selected chip is skipped: it shows its name inline.
      */
-    registerIconTooltip: import("ember-modifier").FunctionBasedModifier<{
+    iconTooltips: import("ember-modifier").FunctionBasedModifier<{
         Args: {
             Positional: unknown[];
             Named: import("ember-modifier/-private/signature").EmptyObject;
@@ -55,15 +70,12 @@ export default class DIconGridPickerContent extends Component<any> {
      */
     get hasFavorites(): boolean;
     /**
-     * Updates the tracked filter string as the user types in the search input.
+     * Starts a new search: paging belongs to the search that produced it, so the
+     * grid stops growing and any page still in flight is discarded on arrival.
      *
      * @param {string} value - The current input value.
      */
-    onFilterInput(value: string): void;
-    /**
-     * Clears the search filter, restoring the full icon list and favorites row.
-     */
-    clearFilter(): void;
+    setFilter(value: string): void;
     /**
      * Handles arrow key navigation within the icon grid. Uses position-based
      * matching (offsetTop/offsetLeft) for vertical movement so it works
@@ -85,16 +97,49 @@ export default class DIconGridPickerContent extends Component<any> {
     focusFilter(wrapper: HTMLElement): void;
     get resultAnnouncement(): any;
     /**
-     * Fetches icons from the server, optionally filtered by a search term.
-     * Used as the `@asyncData` callback for the `AsyncContent` loader.
+     * Loads the first page of icons. Used as the `@asyncData` callback for the
+     * `AsyncContent` loader, which debounces it and aborts superseded searches.
      *
-     * @param {string} filter - The search string to filter icons by name.
-     * @returns {Promise<Array<{id: string, symbol: string}>>} Array of matching icons.
+     * @param {string} _filter - Tracked by `@context`; read from `this.filter`.
+     * @param {{signal: AbortSignal}} options
+     * @returns {Promise<Array<{id: string, symbol?: string}>>} The first page.
      */
-    fetchIcons(filter: string): Promise<Array<{
+    fetchIcons(_filter: string, { signal }: {
+        signal: AbortSignal;
+    }): Promise<Array<{
         id: string;
-        symbol: string;
+        symbol?: string;
     }>>;
+    loadMore(): Promise<void>;
+    /**
+     * Loads the next page on behalf of the keyboard, which has no sentinel to
+     * scroll into, and moves focus onto the first icon that arrives.
+     */
+    loadMoreAndFocus(): Promise<void>;
+    /**
+     * Keeps the picked icon rendering once the picker closes, until the value is
+     * saved and the icon becomes part of the sprite.
+     *
+     * @param {{id: string, symbol?: string}} icon
+     */
+    selectIcon(icon: {
+        id: string;
+        symbol?: string;
+    }): void;
+    #private;
 }
+export type IconButtonSignature = {
+    Args: {
+        icon: {
+            id: string;
+            symbol?: string;
+        };
+        selected?: boolean;
+        onSelect: (icon: {
+            id: string;
+            symbol?: string;
+        }) => void;
+    };
+};
 import Component from "@glimmer/component";
 //# sourceMappingURL=content.d.ts.map

package/declarations/app/ui-kit/d-icon-grid-picker/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../../../discourse/app/ui-kit/d-icon-grid-picker/content.gjs"],"names":[],"mappings":"AAwaA;;;;;;;;;;;GAWG;AACH;;IACE,qEAAqE;IAErE,SAFW,OAAO,sCAAsC,EAAE,OAAO,CAEhD;IAEjB,eAAqB;IACrB,iBAA4B;IAE5B;;;;;OAKG;IACH;;;;;;OAcG;IAEH;;;OAGG;IACH;;;;;;OAkBG;IAEH;;;;;OAKG;IACH,wBAFa,MAAM,EAAE,CAepB;IAED;;;;;OAKG;IACH,oBAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,qBAFW,MAAM,QAKhB;IAED;;OAEG;IACH,oBAGC;IAED;;;;;;OAMG;IACH,qBAFW,aAAa,QAoEvB;IAED;;;;;OAKG;IACH,iBAFW,aAAa,QAmBvB;IAED;;OAEG;IACH,qBAFW,WAAW,QAQrB;IAED,8BAOC;IAED;;;;;;OAMG;IACH,mBAHW,MAAM,GACJ,OAAO,CAAC,KAAK,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC,CAsBxD;CAoOF;sBA7fqB,oBAAoB"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../../../discourse/app/ui-kit/d-icon-grid-picker/content.gjs"],"names":[],"mappings":"AAqqBA;;;;;;;;;;;GAWG;AACH;;IACE,qEAAqE;IAErE,SAFW,OAAO,sCAAsC,EAAE,OAAO,CAEhD;IAEjB,eAAqB;IAErB,wFAAwF;IACxF,OADW,KAAK,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,OAAC,CAC1B;IAEtB,iBAAyB;IACzB,qBAA6B;IAC7B,iBAA4B;IAE5B;;;;;;OAGG;IAEH;;;;;OAKG;IACH;;;;;;OAcG;IAEH;;;;OAIG;IACH;;;;;;OA4CG;IAMH;;;;;OAKG;IACH,wBAFa,MAAM,EAAE,CAepB;IAED;;;;;OAKG;IACH,oBAFa,OAAO,CAInB;IAED;;;;;OAKG;IACH,iBAFW,MAAM,QAQhB;IAED;;;;;;OAMG;IACH,qBAFW,aAAa,QAoFvB;IAED;;;;;OAKG;IACH,iBAFW,aAAa,QAmBvB;IAED;;OAEG;IACH,qBAFW,WAAW,QAQrB;IAED,8BAWC;IAkCD;;;;;;;OAOG;IACH,oBAJW,MAAM,cACN;QAAC,MAAM,EAAE,WAAW,CAAA;KAAC,GACnB,OAAO,CAAC,KAAK,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC,CAczD;IAED,0BA+BC;IAED;;;OAGG;IACH,kCAWC;IAED;;;;;OAKG;IACH,iBAFW;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAC,QAMvC;;CA6NF;;UApqBE;QAA+C,IAAI,EAAxC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAC;QACd,QAAQ,GAAvB,OAAO;QAC6C,QAAQ,EAA5D,CAAC,IAAI,EAAE;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAC,KAAK,IAAI;KAC1D;;sBAjCqB,oBAAoB"}

package/declarations/app/ui-kit/d-icon-grid-picker/index.d.ts

@@ -17,8 +17,9 @@
  * @property {boolean} [Args.showCaret] - When true, shows a chevron icon in the trigger
  *   that flips between angle-down and angle-up based on the menu's expanded state.
  * @property {boolean} [Args.disabled] - When true, disables the trigger button and clear button.
- * @property {boolean} [Args.onlyAvailable] - When true, only shows icons available in the
- *   current SVG sprite set. Defaults to true.
+ * @property {boolean} [Args.onlyAvailable] - When true, only offers icons available in the
+ *   current SVG sprite set. Defaults to true. Pass false only where saving the value adds
+ *   it to the sprite, otherwise the picked icon is blank once the page reloads.
  * @property {string} [Args.iconColor] - CSS color value applied to icons in both the trigger
  *   and the picker grid via the `--icon-color` custom property.
  * @property {string} [Args.selectedTitle] - Translation key for the trigger button title when an
@@ -81,8 +82,9 @@ export default class DIconGridPicker extends Component<DIconGridPickerSignature>
          */
         disabled?: boolean;
         /**
-         * - When true, only shows icons available in the
-         * current SVG sprite set. Defaults to true.
+         * - When true, only offers icons available in the
+         * current SVG sprite set. Defaults to true. Pass false only where saving the value adds
+         * it to the sprite, otherwise the picked icon is blank once the page reloads.
          */
         onlyAvailable?: boolean;
         /**
@@ -139,10 +141,6 @@ export default class DIconGridPicker extends Component<DIconGridPickerSignature>
      * @param {import("discourse/float-kit/lib/d-menu-instance").default} api - The DMenu API instance.
      */
     onRegisterMenu(api: import("discourse/float-kit/lib/d-menu-instance").default): void;
-    /**
-     * Forwards to the external `@onShow` callback if provided.
-     */
-    onShow(): void;
     /**
      * Handles icon selection by invoking the `@onChange` callback and closing
      * the menu/modal.

package/declarations/app/ui-kit/d-icon-grid-picker/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../discourse/app/ui-kit/d-icon-grid-picker/index.gjs"],"names":[],"mappings":"AAqOA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH;;;;;;GAMG;AACH;;;;;eAnCc,MAAM;;;;kBACN,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;;;;oBAC/B,MAAM,EAAE;;;;;;2BACR,OAAO;;;;mBAGP,MAAM;;;;gBACN,MAAM;;;;;qBACN,OAAO;;;;;oBAEP,OAAO;;;;mBAEP,OAAO;;;;;wBACP,OAAO;;;;;oBAEP,MAAM;;;;;;wBAEN,MAAM;;;;;qBAGN,MAAM;;;;yBAEN,OAAO;;;;iBACP,OAAO;;;;iBACP,OAAO,mCAAmC,EAAE,aAAa;;;;kBACzD,OAAO,mCAAmC,EAAE,aAAa;;IAWrE,yEAAyE;IACzE,MADW,OAAO,yCAAyC,EAAE,OAAO,OAAC,CAChD;IAErB;;OAEG;IACH,sBAFa,OAAO,CAInB;IAED,uBAEC;IAED,8BAEC;IAED,oBAEC;IAED,wBAMC;IAED,yBAEC;IAED,wBAWC;IAED,2CAEC;IAED,4DAKC;IAED;;;;;OAKG;IACH,oBAFW,OAAO,yCAAyC,EAAE,OAAO,QAKnE;IAED;;OAEG;IACH,eAGC;IAED;;;;;OAKG;IACH,mBAFW,MAAM,QAMhB;IAED;;OAEG;IACH,kBAGC;CAgFF;;aAtNa,gBAAgB;UAG3B;QAAwB,KAAK,EAAlB,MAAM;QACgC,QAAQ,EAA9C,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;QACf,SAAS,GAAzB,MAAM,EAAE;QACO,gBAAgB,GAA/B,OAAO;QAGO,QAAQ,GAAtB,MAAM;QACQ,KAAK,GAAnB,MAAM;QACS,UAAU,GAAzB,OAAO;QAEQ,SAAS,GAAxB,OAAO;QAEQ,QAAQ,GAAvB,OAAO;QACQ,aAAa,GAA5B,OAAO;QAEO,SAAS,GAAvB,MAAM;QAEQ,aAAa,GAA3B,MAAM;QAGQ,UAAU,GAAxB,MAAM;QAES,cAAc,GAA7B,OAAO;QACQ,MAAM,GAArB,OAAO;QAC0D,MAAM,GAAvE,OAAO,mCAAmC,EAAE,aAAa;QACQ,OAAO,GAAxE,OAAO,mCAAmC,EAAE,aAAa;KACtE;;sBA5CqB,oBAAoB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../discourse/app/ui-kit/d-icon-grid-picker/index.gjs"],"names":[],"mappings":"AA8NA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;;;;;GAMG;AACH;;;;;eApCc,MAAM;;;;kBACN,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;;;;oBAC/B,MAAM,EAAE;;;;;;2BACR,OAAO;;;;mBAGP,MAAM;;;;gBACN,MAAM;;;;;qBACN,OAAO;;;;;oBAEP,OAAO;;;;mBAEP,OAAO;;;;;;wBACP,OAAO;;;;;oBAGP,MAAM;;;;;;wBAEN,MAAM;;;;;qBAGN,MAAM;;;;yBAEN,OAAO;;;;iBACP,OAAO;;;;iBACP,OAAO,mCAAmC,EAAE,aAAa;;;;kBACzD,OAAO,mCAAmC,EAAE,aAAa;;IAWrE,yEAAyE;IACzE,MADW,OAAO,yCAAyC,EAAE,OAAO,OAAC,CAChD;IAErB;;OAEG;IACH,sBAFa,OAAO,CAInB;IAED,uBAEC;IAED,8BAEC;IAED,oBAEC;IAED,wBAMC;IAED,yBAEC;IAED,wBAWC;IAED,2CAEC;IAED,4DAKC;IAED;;;;;OAKG;IACH,oBAFW,OAAO,yCAAyC,EAAE,OAAO,QAKnE;IAED;;;;;OAKG;IACH,mBAFW,MAAM,QAMhB;IAED;;OAEG;IACH,kBAGC;CAgFF;;aA/Ma,gBAAgB;UAG3B;QAAwB,KAAK,EAAlB,MAAM;QACgC,QAAQ,EAA9C,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI;QACf,SAAS,GAAzB,MAAM,EAAE;QACO,gBAAgB,GAA/B,OAAO;QAGO,QAAQ,GAAtB,MAAM;QACQ,KAAK,GAAnB,MAAM;QACS,UAAU,GAAzB,OAAO;QAEQ,SAAS,GAAxB,OAAO;QAEQ,QAAQ,GAAvB,OAAO;QACQ,aAAa,GAA5B,OAAO;QAGO,SAAS,GAAvB,MAAM;QAEQ,aAAa,GAA3B,MAAM;QAGQ,UAAU,GAAxB,MAAM;QAES,cAAc,GAA7B,OAAO;QACQ,MAAM,GAArB,OAAO;QAC0D,MAAM,GAAvE,OAAO,mCAAmC,EAAE,aAAa;QACQ,OAAO,GAAxE,OAAO,mCAAmC,EAAE,aAAa;KACtE;;sBA7CqB,oBAAoB"}

package/declarations/app/ui-kit/d-load-more.d.ts

@@ -1,23 +1,34 @@
 export function disableLoadMoreObserver(): void;
 export function enableLoadMoreObserver(): void;
 /**
- * A component that implements infinite loading using IntersectionObserver.
+ * @typedef DLoadMoreSignature
  *
- * LoadMore triggers an action when a sentinel element becomes visible in the viewport,
- * which is typically used to load additional content. Besides the `action` argument, it also takes
- * in additional options to customize the observer's behavior;
- * Refer to https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver/IntersectionObserver#options for a full list.
+ * @property {HTMLDivElement} Element
+ * @property {object} Args
  *
- * @param {Function} action - The action to trigger when more content should be loaded
- * @param {boolean} [enabled=true] - Whether to allow the loadMore action to trigger.
+ * @property {() => void} Args.action - The action to trigger when more content should be loaded
+ * @property {boolean} [Args.enabled=true] - Whether to allow the loadMore action to trigger.
  *   Use this when you know there's no more content available (e.g., `model.canLoadMore`).
  *   When false, the observer continues to run but the action won't be triggered.
- * @param {boolean} [isLoading=false] - Whether content is currently loading.
+ * @property {boolean} [Args.isLoading=false] - Whether content is currently loading.
  *   When true, the IntersectionObserver won't be created, preventing premature triggers
  *   during initial content load. Pass this to avoid race conditions during page initialization.
- * @param {string} [rootMargin="0px 0px 0px 0px"] - Margin around the root element for intersection detection
- * @param {number} [threshold=0.0] - Threshold at which the intersection callback is triggered
- * @param {string} [root=null] - CSS selector for the root element to observe intersection within
+ * @property {string} [Args.rootMargin="0px 0px 0px 0px"] - Margin around the root element for intersection detection
+ * @property {number} [Args.threshold=0.0] - Threshold at which the intersection callback is triggered
+ * @property {string|Element|null} [Args.root=null] - The element to observe intersection within, or a CSS
+ *   selector for it. Pass the element itself when it mounts in the same render as the
+ *   sentinel, since a selector cannot resolve a root that does not exist yet.
+ *
+ * @property {object} Blocks
+ * @property {[]} Blocks.default - Content rendered above the sentinel.
+ */
+/**
+ * A component that implements infinite loading using IntersectionObserver.
+ *
+ * LoadMore triggers an action when a sentinel element becomes visible in the viewport,
+ * which is typically used to load additional content. Besides the `action` argument, it also takes
+ * in additional options to customize the observer's behavior;
+ * Refer to https://developer.mozilla.org/en-US/docs/Web/API/IntersectionObserver/IntersectionObserver#options for a full list.
  *
  * @example Basic usage with a block:
  * ```gjs
@@ -48,25 +59,73 @@ export function enableLoadMoreObserver(): void;
  * </LoadMore>
  * ```
  *
- * @example With custom IntersectionObserver options:
+ * @example With custom IntersectionObserver options (attributes land on the
+ * sentinel itself when no block is given, so consumers can style it):
  * ```gjs
  * <LoadMore
  *   @action={{this.fetchMoreUsers}}
  *   @rootMargin="100px"
  *   @threshold={{0.2}}
  *   @root={{this.scrollContainer}}
- *   class="users-container"
+ *   class="users-list__sentinel"
  * />
  * ```
+ *
+ * @extends {Component<DLoadMoreSignature>}
  */
-export default class DLoadMore extends Component<any> {
-    constructor(owner: import("@ember/-internals/owner").default, args: any);
+export default class DLoadMore extends Component<DLoadMoreSignature> {
+    constructor(owner: import("@ember/-internals/owner").default, args: {
+        /**
+         * - The action to trigger when more content should be loaded
+         */
+        action: () => void;
+        /**
+         * - Whether to allow the loadMore action to trigger.
+         * Use this when you know there's no more content available (e.g., `model.canLoadMore`).
+         * When false, the observer continues to run but the action won't be triggered.
+         */
+        enabled?: boolean;
+        /**
+         * - Whether content is currently loading.
+         * When true, the IntersectionObserver won't be created, preventing premature triggers
+         * during initial content load. Pass this to avoid race conditions during page initialization.
+         */
+        isLoading?: boolean;
+        /**
+         * - Margin around the root element for intersection detection
+         */
+        rootMargin?: string;
+        /**
+         * - Threshold at which the intersection callback is triggered
+         */
+        threshold?: number;
+        /**
+         * - The element to observe intersection within, or a CSS
+         * selector for it. Pass the element itself when it mounts in the same render as the
+         * sentinel, since a selector cannot resolve a root that does not exist yet.
+         */
+        root?: string | Element | null;
+    });
     observer: any;
-    root: any;
-    rootMargin: any;
-    threshold: any;
-    get enabled(): any;
+    get root(): string | Element;
+    get rootMargin(): string;
+    get threshold(): number;
+    get enabled(): boolean;
     onIntersection(entry: any): void;
 }
+export type DLoadMoreSignature = {
+    Element: HTMLDivElement;
+    Args: {
+        action: () => void;
+        enabled?: boolean;
+        isLoading?: boolean;
+        rootMargin?: string;
+        threshold?: number;
+        root?: string | Element | null;
+    };
+    Blocks: {
+        default: [];
+    };
+};
 import Component from "@glimmer/component";
 //# sourceMappingURL=d-load-more.d.ts.map

package/declarations/app/ui-kit/d-load-more.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d-load-more.d.ts","sourceRoot":"","sources":["../../../../discourse/app/ui-kit/d-load-more.gjs"],"names":[],"mappings":"AAyHA,gDAEC;AAED,+CAEC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH;;IACE,cAAS;IACT,UAA8B;IAC9B,gBAAuD;IACvD,eAAuC;IAEvC,mBAEC;IAED,iCAKC;CA+BF;sBA1HqB,oBAAoB"}
+{"version":3,"file":"d-load-more.d.ts","sourceRoot":"","sources":["../../../../discourse/app/ui-kit/d-load-more.gjs"],"names":[],"mappings":"AA+JA,gDAEC;AAED,+CAEC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH;;;;;gBApEc,MAAM,IAAI;;;;;;kBACV,OAAO;;;;;;oBAGP,OAAO;;;;qBAGP,MAAM;;;;oBACN,MAAM;;;;;;eACN,MAAM,GAAC,OAAO,GAAC,IAAI;;IA4D/B,cAAS;IAKT,6BAEC;IAED,yBAEC;IAED,wBAEC;IAED,uBAEC;IAED,iCAKC;CAoCF;;aAtIa,cAAc;UAGzB;QAA4B,MAAM,EAAvB,MAAM,IAAI;QACK,OAAO,GAAtB,OAAO;QAGQ,SAAS,GAAxB,OAAO;QAGO,UAAU,GAAxB,MAAM;QACQ,SAAS,GAAvB,MAAM;QACqB,IAAI,GAA/B,MAAM,GAAC,OAAO,GAAC,IAAI;KAI9B;YACA;QAAsB,OAAO,EAAlB,EAAE;KACf;;sBArCqB,oBAAoB"}

package/declarations/app/ui-kit/d-modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"d-modal.d.ts","sourceRoot":"","sources":["../../../../discourse/app/ui-kit/d-modal.gts"],"names":[],"mappings":"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"}
+{"version":3,"file":"d-modal.d.ts","sourceRoot":"","sources":["../../../../discourse/app/ui-kit/d-modal.gts"],"names":[],"mappings":"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"}

package/declarations/app/ui-kit/{d-select.d.ts → d-native-select.d.ts}

@@ -1,9 +1,10 @@
 export const NO_VALUE_OPTION: "__NONE__";
-export class DSelectOption extends Component<any> {
+export class DNativeSelectOption extends Component<any> {
     constructor(owner: import("@ember/-internals/owner").default, args: any);
-    get value(): any;
+    get value(): string;
+    get isSelected(): boolean;
 }
-export default class DSelect extends Component<any> {
+export default class DNativeSelect extends Component<any> {
     constructor(owner: import("@ember/-internals/owner").default, args: any);
     get htmlSelectValue(): any;
     handleInput(event: any): void;
@@ -11,4 +12,4 @@ export default class DSelect extends Component<any> {
     get includeNone(): any;
 }
 import Component from "@glimmer/component";
-//# sourceMappingURL=d-select.d.ts.map
+//# sourceMappingURL=d-native-select.d.ts.map

package/declarations/app/ui-kit/d-native-select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"d-native-select.d.ts","sourceRoot":"","sources":["../../../../discourse/app/ui-kit/d-native-select.gjs"],"names":[],"mappings":"AAoHA,8BAA+B,UAAU,CAAC;AAY1C;;IACE,oBAEC;IAED,0BAEC;CAoBF;AAED;;IACE,2BASC;IAED,8BAOC;IAED,gCAEC;IAED,uBAEC;CAuCF;sBAnHqB,oBAAoB"}

package/declarations/app/ui-kit/d-resize-handles.d.ts

@@ -0,0 +1,243 @@
+import Component from "@glimmer/component";
+import type Owner from "@ember/owner";
+import { type TrustedHTML } from "@ember/template";
+import { type DPointerDragInfo } from "discourse/ui-kit/modifiers/d-pointer-drag";
+/** One of the eight compass directions of the built-in box resize. */
+export type BoxDirection = "n" | "ne" | "e" | "se" | "s" | "sw" | "w" | "nw";
+/**
+ * The eight compass handles of a box resize, in clockwise order. The common
+ * case (resizing a rectangle's edges + corners) — generated from `@handleClass`
+ * so consumers don't repeat the list. Each handle's `payload` is its direction.
+ */
+export declare const BOX_DIRECTIONS: BoxDirection[];
+/**
+ * One handle to render. The escape hatch from the built-in box: supply these
+ * when the handles are not a rectangle's edges and corners.
+ */
+export interface DResizeHandleDescriptor<Payload extends string | number> {
+    /**
+     * What makes this handle itself. It must be unique among its siblings and
+     * stable across recomputes, so that a list changing under a held pointer
+     * destroys the handle that really went rather than the last one.
+     *
+     * Not derived from `payload`, which says what a handle means rather than which
+     * one it is. Several handles can legitimately mean the same thing.
+     */
+    key: string;
+    /** What the handle means. Handed back to every callback, and may repeat. */
+    payload: Payload;
+    /** Positions and styles the handle. */
+    class?: string;
+    /**
+     * Inline positioning. Wrap the string in `trustHTML` before passing it here.
+     * Only the caller knows whether the values it interpolated are safe, so this
+     * component will not make that call for it.
+     */
+    style?: TrustedHTML;
+}
+/**
+ * The pointer geometry of a move, reported to every callback. Deliberately raw:
+ * the consumer decides what a pixel delta means in its own units.
+ *
+ * Everything here is a snapshot of the moment it was handed over, EXCEPT
+ * `session`, which is the one thing that lives for the gesture.
+ */
+export interface DResizeHandleDragInfo<Payload extends string | number, Session extends object = object> {
+    /** The handle being dragged — the same value the callback's first argument carries. */
+    readonly payload: Payload;
+    /** The pointer event that produced this report. */
+    readonly event: PointerEvent;
+    /** Where the press landed, in client coordinates. */
+    readonly origin: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    /** Where the pointer is now, in client coordinates. */
+    readonly current: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    /** How far the pointer has travelled since the press. */
+    readonly delta: Readonly<{
+        x: number;
+        y: number;
+    }>;
+    /**
+     * Whether `@onResize` has fired at least once for THIS gesture. It tells a
+     * resize apart from a click that landed on a handle. Commit on `@onResizeEnd`
+     * only when it is set, or a bare click records a no-op change.
+     */
+    readonly moved: boolean;
+    /**
+     * Scratch for the length of one gesture, and the same object throughout it.
+     *
+     * Write the press-time snapshot here in `@onResizeStart` and read it back on
+     * every later report. It lives here rather than on the consumer so that each
+     * gesture starts with a fresh one.
+     */
+    readonly session: Session;
+    /**
+     * The element named by `@measure`, or `null` when none was named. Handed back
+     * so a consumer that also needs the element itself (to paint a preview on it,
+     * say) does not resolve it a second time.
+     */
+    readonly measured: Element | null;
+    /**
+     * The bounds of the element named by `@measure`, or `null` when none was
+     * named. Viewport-relative, with transforms applied, so a consumer working in
+     * unscaled units divides by the scale factor and subtracts `left` and `top`.
+     *
+     * A LIVE reading, re-read on scroll and viewport resize, so it stays correct
+     * when the box moves under a held pointer. It is NOT re-read when the element
+     * changes size, or on a layout shift or transform. Those raise no event.
+     */
+    readonly measuredRect: DOMRect | null;
+}
+/**
+ * The box whose bounds a gesture reports: the element itself, or a function
+ * receiving the pressed handle and returning it.
+ */
+type MeasureTarget = Element | ((handle: HTMLElement) => Element | null | undefined);
+interface DResizeHandlesSignature<Payload extends string | number, Session extends object = object> {
+    Args: {
+        /**
+         * BEM block for the built-in 8-direction box. Each handle is classed
+         * `<handleClass> --<dir>`. Ignored when `@handles` is supplied.
+         */
+        handleClass?: string;
+        /**
+         * A subset of the eight compass directions to render for the built-in box
+         * (e.g. only the edges and corners that can actually move). Defaults to all
+         * eight; ignored when `@handles` is supplied.
+         */
+        directions?: BoxDirection[];
+        /**
+         * Explicit handle descriptors. The escape hatch for anything that is not a
+         * box — N column-gutter handles at computed offsets, say. Takes precedence
+         * over `@handleClass`.
+         */
+        handles?: DResizeHandleDescriptor<Payload>[];
+        /**
+         * The gesture began. Snapshot the press-time state onto `dragInfo.session`
+         * here. Return `false` to veto it.
+         *
+         * The callbacks sit in `NoInfer` positions so that `@handles` alone decides
+         * the payload type. Without it a handler taking a number would infer
+         * `Payload` as `number` on the built-in box, hiding a real mismatch.
+         */
+        onResizeStart?: (payload: NoInfer<Payload>, dragInfo: DResizeHandleDragInfo<NoInfer<Payload>, Session>) => boolean | void;
+        /** Fired on every move. Compute and preview here. */
+        onResize?: (payload: NoInfer<Payload>, dragInfo: DResizeHandleDragInfo<NoInfer<Payload>, Session>) => void;
+        /**
+         * Fired once on release, and on teardown for a gesture still held. Commit
+         * here, guarded on `dragInfo.moved`.
+         */
+        onResizeEnd?: (payload: NoInfer<Payload>, dragInfo: DResizeHandleDragInfo<NoInfer<Payload>, Session>) => void;
+        /**
+         * Fired when the gesture is cancelled rather than released, teardown with a
+         * gesture still held included. Mutually exclusive with `@cancelCommits`,
+         * which routes cancels to `@onResizeEnd` and so leaves this one unreachable.
+         */
+        onResizeCancel?: (payload: NoInfer<Payload>, dragInfo: DResizeHandleDragInfo<NoInfer<Payload>, Session>) => void;
+        /** A class toggled on the active handle while it is being dragged. */
+        draggingClass?: string;
+        /**
+         * Pixels of travel before `@onResize` starts firing, to absorb the jitter of
+         * a click that was never meant to be a drag.
+         */
+        threshold?: number;
+        /**
+         * Whether a gesture cut short — `pointercancel`, a lost capture, or another
+         * registration claiming the pointer — reports through `@onResizeEnd` rather
+         * than `@onResizeCancel`, leaving the latter unreachable.
+         *
+         * A consumer that commits the terminal event's position must NOT set this: a
+         * cancel carries no position the user chose, so the commit would write a
+         * coordinate the pointer was never at.
+         */
+        cancelCommits?: boolean;
+        /**
+         * The box being resized, so it and its bounds ride along on every report.
+         * Either the element, or a function receiving the pressed handle and
+         * returning it. See `measuredRect` for what is and is not re-read.
+         */
+        measure?: MeasureTarget;
+        /**
+         * Whether an accepted press stops propagating. Defaults to `false`, because
+         * document-level listeners need to see `pointerdown`. Set it when the handles
+         * sit inside another gesture that would otherwise steal the pointer.
+         */
+        stopPropagation?: boolean;
+    };
+}
+/**
+ * Renders a set of drag handles and drives each through the pointer-drag
+ * lifecycle, owning what every consumer would otherwise repeat: the handle loop,
+ * the per-handle pointer wiring, and one gesture's state for as long as it runs.
+ *
+ * It reports pointer geometry rather than a size. The consumer does the math in
+ * its own units, paints its own preview, and commits on `@onResizeEnd`.
+ *
+ * Every gesture ends with exactly one terminal callback, whether it ends on
+ * release, on its handle being removed, or on the component being destroyed.
+ * Each gesture carries a `session` for press-time state.
+ *
+ * ONE gesture at a time. A press arriving while another is held is refused, so
+ * two handles on one box can never fight over the same geometry. Two separate
+ * boxes still drag at once, because each renders its own handles.
+ *
+ * The common case, a box's 8 edge and corner handles, is built in through
+ * `@handleClass`. Anything else passes explicit `@handles` descriptors.
+ *
+ * @example
+ * Box (edges + corners) from a BEM block:
+ * ```gjs
+ * <DResizeHandles @handleClass="my-block__handle" @onResize={{this.onResize}} />
+ * ```
+ *
+ * @example
+ * Escape hatch — explicit descriptors:
+ * ```gjs
+ * <DResizeHandles @handles={{this.columnHandles}} @onResize={{this.onResize}} />
+ * ```
+ *
+ * `role="separator"` is wrong here and must not be used: a box resized from its
+ * corners has no single value to report.
+ *
+ * Deliberately POINTER-ONLY. The handles are `aria-hidden` and out of the tab
+ * order: eight tab stops per box would be hostile, and no ARIA role describes a
+ * corner drag. Put keyboard resizing on the resized object itself.
+ *
+ * @see The `DResizeSeparator` component for a ONE-axis resize between two regions, which is
+ *   operable by keyboard and announced.
+ * @see The `dOnResize` modifier to merely OBSERVE a size change. It is not a gesture.
+ */
+export default class DResizeHandles<Payload extends string | number = BoxDirection, Session extends object = object> extends Component<DResizeHandlesSignature<Payload, Session>> {
+    #private;
+    constructor(owner: Owner, args: DResizeHandlesSignature<Payload, Session>["Args"]);
+    /**
+     * The resolved handle descriptors: explicit `@handles` when named, otherwise
+     * the built-in box from `@handleClass`.
+     *
+     * The branch tests whether `@handles` was NAMED, not whether it holds
+     * anything, because naming it is what `Payload` is inferred from. Falling
+     * through to the box would hand compass strings to differently-typed callbacks.
+     */
+    get handles(): DResizeHandleDescriptor<Payload>[];
+    onHandleDown(payload: Payload, event: PointerEvent, info: DPointerDragInfo): any;
+    onHandleMove(event: PointerEvent, info: DPointerDragInfo): void;
+    onHandleUp(event: PointerEvent, info: DPointerDragInfo): void;
+    onHandleCancel(event: PointerEvent, info: DPointerDragInfo): void;
+    /**
+     * Closes the gesture when the handle holding it is destroyed. That happens
+     * when `@handles` or `@directions` drops a handle while the pointer is down.
+     *
+     * The engine reports nothing when its element goes. Without this, the consumer
+     * would never get to close what it opened at the press.
+     *
+     * @param element - The handle being torn down.
+     */
+    onHandleTeardown(element: Element): void;
+}
+export {};
+//# sourceMappingURL=d-resize-handles.d.ts.map

package/declarations/app/ui-kit/d-resize-handles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"d-resize-handles.d.ts","sourceRoot":"","sources":["../../../../discourse/app/ui-kit/d-resize-handles.gts"],"names":[],"mappings":"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"}