@discourse/types 2026.8.0-fb9247e0 → 2026.9.0-c0ef3a11

package/declarations/app/lib/-internals/drag-and-drop/drag-dwell.d.ts

@@ -0,0 +1,64 @@
+/** The dwell delay used when the consumer does not pick one. */
+export declare const DEFAULT_DRAG_DWELL_DELAY = 500;
+/** Options for {@link createDragDwell}. */
+export interface DragDwellOptions<Target> {
+    /**
+     * Object whose lifetime bounds the dwell, usually the component or service
+     * that owns it. Destruction cancels a pending dwell and prevents later
+     * reports from firing.
+     */
+    destroyable: object;
+    /**
+     * Milliseconds of uninterrupted same-identity candidacy required before
+     * {@link DragDwellOptions.onDwell} fires. Defaults to `500`. The delay is
+     * scheduled through `discourseLater`, so it collapses to a short wait under
+     * test.
+     */
+    delay?: number;
+    /**
+     * Maps a candidate to the key compared with `Object.is`. Defaults to the
+     * candidate itself. Called only for non-null candidates; `null` and
+     * `undefined` are both valid returned keys. Must be pure.
+     */
+    identity?: (target: Target) => unknown;
+    /**
+     * Fires once after an uninterrupted candidacy, with the most recent object
+     * reported for that identity. A throw leaves the identity latched, so it
+     * cannot fire again until cleared.
+     */
+    onDwell: (target: Target) => void;
+}
+/** A live dwell tracker returned by {@link createDragDwell}. */
+export interface DragDwell<Target> {
+    /**
+     * Reports the current candidate, or `null` to clear it. A report with the
+     * same identity refreshes only the retained object: it neither pushes the
+     * deadline back nor rearms a dwell that already fired. A new identity
+     * cancels any pending dwell and starts a fresh delay.
+     */
+    update(target: Target | null): void;
+    /**
+     * Cancels any pending dwell and clears its latched identity. Equivalent to
+     * `update(null)` and safe to call repeatedly.
+     */
+    reset(): void;
+}
+/**
+ * Tracks how long one candidate identity remains current during a drag.
+ * Consumers can feed it equally from a drop target's enter/leave callbacks or
+ * a monitor's per-frame hit-testing. Silence (not calling {@link DragDwell.update})
+ * is not `update(null)` and therefore does not interrupt a pending dwell.
+ *
+ * `Target` must be non-nullish: `null` is reserved as the clear sentinel.
+ *
+ * Guide to choosing between the drag and gesture primitives:
+ * `docs/developer-guides/docs/03-code-internals/30-drag-and-gesture-primitives.md`
+ *
+ * @see The `dDragDwell` modifier, which packages this for the common case of
+ *   one element observed through the drag monitors.
+ *
+ * @param options - The dwell timing, lifetime, identity, and callback.
+ * @returns A tracker for reporting and clearing the current candidate.
+ */
+export default function createDragDwell<Target>(options: DragDwellOptions<Target>): DragDwell<Target>;
+//# sourceMappingURL=drag-dwell.d.ts.map

package/declarations/app/lib/-internals/drag-and-drop/drag-dwell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-dwell.d.ts","sourceRoot":"","sources":["../../../../../../discourse/app/lib/-internals/drag-and-drop/drag-dwell.ts"],"names":[],"mappings":"AAMA,gEAAgE;AAChE,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,2CAA2C;AAC3C,MAAM,WAAW,gBAAgB,CAAC,MAAM;IACtC;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAEvC;;;;OAIG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,gEAAgE;AAChE,MAAM,WAAW,SAAS,CAAC,MAAM;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAEpC;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,MAAM,EAC5C,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAChC,SAAS,CAAC,MAAM,CAAC,CA2DnB"}

package/declarations/app/lib/-internals/drag-and-drop/drop-target-kernel.d.ts

@@ -0,0 +1,145 @@
+import type { CleanupFn, DragLocationHistory, Input } from "@atlaskit/pragmatic-drag-and-drop/types";
+import type { Axis } from "discourse/lib/geometry";
+/** The pointer position as the underlying library reports it. */
+export type DragInput = Input;
+/** The drag's initial, previous and current locations. */
+export type DragLocation = DragLocationHistory;
+/** Where a drop would land relative to its target. */
+export type DropPosition = "before" | "after" | "inside";
+/**
+ * The cursor feedback the browser shows for a drop.
+ *
+ * `"none"` refuses the drop at the cursor: the browser cancels the drag at
+ * release instead of firing a drop event, so the target's `onDrop` never runs
+ * and the browser's own default (such as navigating to a dropped URL) is
+ * suppressed.
+ */
+export type DropEffect = "copy" | "link" | "move" | "none";
+/** How a target decides where a drop would land. */
+export interface DropPositionOptions {
+    /** A fixed position, which wins over midpoint math. */
+    position?: DropPosition;
+    /** The axis whose midpoint is measured. Defaults to `"vertical"`. */
+    axis?: Axis;
+}
+/** What a synchronous consumer gate is asked about. */
+export interface DropTargetKernelFeedback<Source> {
+    /** The consumer-facing drag source. */
+    source: Source;
+    /** The pointer position. */
+    input: Input;
+    /** The registered target element. */
+    element: Element;
+}
+/** What a consumer lifecycle callback is told. */
+export interface DropTargetKernelEvent<Source> {
+    /** The consumer-facing drag source. */
+    source: Source;
+    /** Where the drop would land, or `null` when no position applies. */
+    position: DropPosition | null;
+    /** The drag's location history. */
+    location: DragLocationHistory;
+    /** The registered target element. */
+    element: Element;
+}
+/** Consumer callbacks and display options shared by every drop target. */
+export interface DropTargetKernelArgs<Source> extends DropPositionOptions {
+    /**
+     * Synchronous gate, asked while the drag hovers. Returning `false` takes
+     * this target out of the running, leaving the drop to an ancestor target.
+     * It is not asked again when the drag is released.
+     */
+    canDrop?: (feedback: DropTargetKernelFeedback<Source>) => boolean | void;
+    /**
+     * The cursor feedback browsers show during the drag: a fixed effect, or a
+     * function consulted with the drag's feedback when the effect depends on it.
+     */
+    dropEffect?: DropEffect | ((feedback: DropTargetKernelFeedback<Source>) => DropEffect);
+    /** Metadata attached to the drag's record of this target under `.data`. */
+    getData?: () => object;
+    /**
+     * Whether the target stays current after the pointer leaves it. It lets go
+     * when its parent changes, another target takes its depth, or the gate
+     * refuses it.
+     */
+    getIsSticky?: () => boolean;
+    /** `false` suppresses the target's indicator. Defaults to `true`. */
+    indicator?: boolean;
+    /**
+     * Called when this target becomes the deepest accepted target. Usually the
+     * pointer entered it, but it also fires when a nested target covering it
+     * goes away, without the pointer moving.
+     */
+    onDragEnter?: (event: DropTargetKernelEvent<Source>) => void;
+    /**
+     * Called repeatedly while this target is the deepest accepted target,
+     * throttled by the underlying library.
+     */
+    onDrag?: (event: DropTargetKernelEvent<Source>) => void;
+    /**
+     * Called when this target stops being the deepest accepted target: the
+     * pointer left, a nested target took over, or the gate refused it.
+     * `position` is `null`.
+     *
+     * A drop or teardown ends the drag without a leave, so consumers must also
+     * release their drag-time state when they are destroyed.
+     */
+    onDragLeave?: (event: DropTargetKernelEvent<Source>) => void;
+    /** Called when the drag is released on this target. */
+    onDrop?: (event: DropTargetKernelEvent<Source>) => void;
+}
+type LibraryFeedbackArgs<Payload> = {
+    input: Input;
+    source: Payload;
+    element: Element;
+};
+type LibraryEventArgs<Payload> = {
+    source: Payload;
+    location: DragLocationHistory;
+};
+/**
+ * What the kernel hands an adapter's `register` function, shaped so the
+ * library's registrars accept it without a cast.
+ */
+export type DropTargetRegistrationArgs<Payload> = {
+    element: Element;
+    canDrop: (args: LibraryFeedbackArgs<Payload>) => boolean;
+    getData: (args: LibraryFeedbackArgs<Payload>) => Record<string | symbol, unknown>;
+    getDropEffect: (args: LibraryFeedbackArgs<Payload>) => Exclude<DropEffect, "none"> | undefined;
+    getIsSticky: (args: LibraryFeedbackArgs<Payload>) => boolean;
+    onDropTargetChange: (args: LibraryEventArgs<Payload>) => void;
+    onDragEnter: (args: LibraryEventArgs<Payload>) => void;
+    onDrag: (args: LibraryEventArgs<Payload>) => void;
+    onDragLeave: (args: LibraryEventArgs<Payload>) => void;
+    onDrop: (args: LibraryEventArgs<Payload>) => void;
+};
+/** Adapter-specific configuration for the shared drop-target state machine. */
+export interface DropTargetKernelConfig<Payload, Source> {
+    /** The element to register as a drop target. */
+    element: Element;
+    /** The data attribute stamped for the lifetime of the registration. */
+    attribute: "data-drop-target" | "data-drop-target-external";
+    /** Registers the callbacks with the adapter. */
+    register: (args: DropTargetRegistrationArgs<Payload>) => CleanupFn;
+    /** Converts the adapter payload to the consumer-facing source. */
+    decorateSource: (payload: Payload) => Source;
+    /** Applies adapter-specific filters before the consumer's gate. */
+    accepts: (payload: Payload) => boolean;
+    /** Whether this adapter resolves a position for the current arguments. */
+    resolvesPosition?: (args: DropTargetKernelArgs<Source>) => boolean;
+    /** The hover class used when this adapter resolves no position. */
+    positionlessClass?: string;
+    /** Optional adapter teardown run after the shared cleanup. */
+    onCleanup?: () => void;
+    /** Returns the consumer's latest callbacks and display options. */
+    getArgs: () => DropTargetKernelArgs<Source>;
+}
+/**
+ * Registers the shared drop-target state machine through a concrete adapter.
+ *
+ * @param config - Adapter hooks and the latest consumer arguments.
+ * @returns Cleanup for the adapter registration and its target state.
+ */
+export declare function registerDropTargetKernel<Payload, Source>({ element, attribute, register, decorateSource, accepts, resolvesPosition, positionlessClass, onCleanup, getArgs, }: DropTargetKernelConfig<Payload, Source>): CleanupFn;
+export {};
+//# sourceMappingURL=drop-target-kernel.d.ts.map

package/declarations/app/lib/-internals/drag-and-drop/drop-target-kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-target-kernel.d.ts","sourceRoot":"","sources":["../../../../../../discourse/app/lib/-internals/drag-and-drop/drop-target-kernel.ts"],"names":[],"mappings":"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"}

package/declarations/app/lib/-internals/drag-and-drop/external-vocabulary.d.ts

@@ -0,0 +1,63 @@
+import type { ExternalDragPayload as NativeExternalDragPayload, NativeMediaType } from "@atlaskit/pragmatic-drag-and-drop/adapter/external-adapter-types";
+import { containsFiles } from "@atlaskit/pragmatic-drag-and-drop/utils/contains-files";
+import { containsHTML } from "@atlaskit/pragmatic-drag-and-drop/utils/contains-html";
+import { containsText } from "@atlaskit/pragmatic-drag-and-drop/utils/contains-text";
+import { containsURLs } from "@atlaskit/pragmatic-drag-and-drop/utils/contains-ur-ls";
+/**
+ * The in-flight external drag, with the read helpers bound to it so consumers
+ * never reach for the underlying library themselves.
+ */
+export interface ExternalDragPayload {
+    /**
+     * Native MIME types declared by the incoming drag (e.g. `"Files"`,
+     * `"text/plain"`, `"text/uri-list"`).
+     */
+    types: NativeMediaType[];
+    /**
+     * The `DataTransferItem` list. Empty until the drop, so `getFiles()` returns
+     * files in `onDrop` alone. Use `types` or `containsFiles()` while hovering.
+     */
+    items: DataTransferItem[];
+    /**
+     * Reads the string payload for a MIME type. Returns `null` while hovering,
+     * and at the drop when the type is absent.
+     */
+    getStringData: (mediaType: string) => string | null;
+    containsFiles: () => boolean;
+    getFiles: () => File[];
+    containsHTML: () => boolean;
+    getHTML: () => string | null;
+    containsText: () => boolean;
+    getText: () => string | null;
+    containsURLs: () => boolean;
+    getURLs: () => string[];
+}
+/**
+ * The kinds `accepts` / `acceptsExternal()` understand, each mapped to its
+ * payload predicate.
+ */
+declare const EXTERNAL_KIND_PREDICATES: Readonly<{
+    files: typeof containsFiles;
+    html: typeof containsHTML;
+    text: typeof containsText;
+    urls: typeof containsURLs;
+}>;
+/** A kind of external payload, as named by `accepts` / `acceptsExternal()`. */
+export type ExternalDragKind = keyof typeof EXTERNAL_KIND_PREDICATES;
+/**
+ * Binds the read helpers to the library's raw external payload.
+ *
+ * @param source - The raw payload the library reports.
+ */
+export declare function decorateExternalSource(source: NativeExternalDragPayload): ExternalDragPayload;
+/**
+ * Whether an incoming external drag is one of the named kinds. An empty or
+ * missing filter matches every external drag; callers wanting "no kinds means
+ * refuse" guard before calling.
+ *
+ * @param kinds - The kind filter as the consumer supplied it.
+ * @param source - The raw payload the underlying library reports.
+ */
+export declare function matchesExternalKind(kinds: ExternalDragKind | ExternalDragKind[] | undefined, source: NativeExternalDragPayload): boolean;
+export {};
+//# sourceMappingURL=external-vocabulary.d.ts.map

package/declarations/app/lib/-internals/drag-and-drop/external-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-vocabulary.d.ts","sourceRoot":"","sources":["../../../../../../discourse/app/lib/-internals/drag-and-drop/external-vocabulary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,IAAI,yBAAyB,EAChD,eAAe,EAChB,MAAM,kEAAkE,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,wDAAwD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,uDAAuD,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,uDAAuD,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,wDAAwD,CAAC;AAOtF;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,KAAK,EAAE,eAAe,EAAE,CAAC;IAEzB;;;OAGG;IACH,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAE1B;;;OAGG;IACH,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAEpD,aAAa,EAAE,MAAM,OAAO,CAAC;IAC7B,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,OAAO,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,OAAO,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,OAAO,EAAE,MAAM,MAAM,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,QAAA,MAAM,wBAAwB;;;;;EAK5B,CAAC;AAEH,+EAA+E;AAC/E,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,wBAAwB,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,yBAAyB,GAChC,mBAAmB,CAcrB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,GAAG,SAAS,EACxD,MAAM,EAAE,yBAAyB,WAWlC"}

package/declarations/app/lib/-internals/drag-and-drop/native-drag-adoption.d.ts

@@ -0,0 +1,60 @@
+import { type ExternalDragPayload } from "discourse/lib/-internals/drag-and-drop/external-vocabulary";
+/** The one arg an adoption candidate is read for. */
+export interface AdoptionCandidateArgs {
+    adopts?: NativeDragAdoption | NativeDragAdoption[];
+}
+/**
+ * Whether a drag was started by the browser and claimed by an adoption.
+ *
+ * @param data - The drag payload's `data`, as the underlying library carries it.
+ */
+export declare function isAdoptedDrag(data: Record<string, unknown> | undefined): boolean;
+/**
+ * Whether one of the supplied adoptions is the one that claimed this drag.
+ *
+ * @param data - The drag payload's `data`, as the underlying library carries it.
+ * @param adopts - The target's `adopts` arg.
+ */
+export declare function offersAdoptionFor(data: Record<string, unknown> | undefined, adopts: NativeDragAdoption | NativeDragAdoption[] | undefined): boolean;
+/** What an adoption gate is asked about, and handed if it accepts. */
+export interface NativeDragAdoptionFeedback {
+    /** The element the browser chose to drag. */
+    element: HTMLElement;
+    /**
+     * The incoming payload, already snapshotted. It is not the live
+     * `DataTransfer`. Those handles go inert when the `dragstart` dispatch ends,
+     * so a later read comes back empty.
+     */
+    source: ExternalDragPayload;
+}
+/**
+ * Opt-in description of a browser-started drag a target is willing to adopt.
+ *
+ * The gate is a predicate rather than a list of payload kinds, because the
+ * kinds are too coarse. Accepting `"text"` catches a URL published only as
+ * text, but it catches a dragged text selection too.
+ */
+export interface NativeDragAdoption {
+    /**
+     * Names this kind of adopted drag. `adopts` is matched against it, a target
+     * reports it as `source.type`, and a monitor or auto-scroll filters on it.
+     */
+    type: string;
+    /** Whether this drag should be adopted. Throwing is reported as a refusal. */
+    match: (feedback: NativeDragAdoptionFeedback) => boolean;
+    /**
+     * Payload for `source.data`. Reserved routing keys are stamped over it.
+     * Throwing is reported and yields no payload.
+     */
+    getData?: (feedback: NativeDragAdoptionFeedback) => object;
+}
+/** Test-only: releases adoption state and its global listener between tests. */
+export declare function resetDragAdoptionForTesting(): void;
+/**
+ * Adds a target to the adoption candidates, starting the shared listener.
+ *
+ * @param getArgsRef - Closure returning the target's latest args.
+ * @returns Cleanup; call it once on teardown.
+ */
+export declare function watchForAdoptableDrags(getArgsRef: () => AdoptionCandidateArgs): () => void;
+//# sourceMappingURL=native-drag-adoption.d.ts.map

package/declarations/app/lib/-internals/drag-and-drop/native-drag-adoption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-drag-adoption.d.ts","sourceRoot":"","sources":["../../../../../../discourse/app/lib/-internals/drag-and-drop/native-drag-adoption.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,4DAA4D,CAAC;AAQpE,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;CACpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,WAEtE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACzC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,GAAG,SAAS,WAK9D;AAED,sEAAsE;AACtE,MAAM,WAAW,0BAA0B;IACzC,6CAA6C;IAC7C,OAAO,EAAE,WAAW,CAAC;IAErB;;;;OAIG;IACH,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb,8EAA8E;IAC9E,KAAK,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,OAAO,CAAC;IAEzD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,MAAM,CAAC;CAC5D;AAkLD,gFAAgF;AAChF,wBAAgB,2BAA2B,SAM1C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,qBAAqB,cAoBxC"}

package/declarations/app/lib/-internals/drag-and-drop/vocabulary.d.ts

@@ -0,0 +1,81 @@
+import type { ElementDragPayload } from "@atlaskit/pragmatic-drag-and-drop/adapter/element-adapter";
+import type { ExternalDragPayload } from "discourse/lib/-internals/drag-and-drop/external-vocabulary";
+/**
+ * Payload key under which a source registered through a drag handle publishes
+ * the element the handle stands for. Targets report that body as
+ * `source.element` and compare it for `acceptsSelf`.
+ */
+export declare const DRAG_BODY = "discourse:dragBody";
+/**
+ * Resolves the body an element drag represents.
+ *
+ * @param source - The payload as the underlying library carries it.
+ */
+export declare function dragBodyOf(source: ElementDragPayload): HTMLElement;
+/**
+ * The routing type carried by a browser-started drag after adoption.
+ *
+ * Namespaced because it shares the same field as consumer-defined types. It
+ * must remain a string because the drag library's routing data crosses the same
+ * public surface as ordinary source data.
+ */
+export declare const ADOPTED_DRAG_TYPE = "discourse:adopted-native-drag";
+/** Where an adoption's consumer-facing type travels beside the routing type. */
+export declare const ADOPTED_AS = "adoptedAs";
+/**
+ * The type a drag answers to in an `accepts` / `types` filter.
+ *
+ * For an adopted drag this is the adoption's declared type, not the internal
+ * routing type, so consumers filter on their own vocabulary either way.
+ *
+ * @param data - A drag payload's `data`, as the underlying library carries it.
+ */
+export declare function dragTypeOf(data?: Record<string, unknown>): string;
+/**
+ * Whether a drag's type is one the consumer asked for.
+ *
+ * @param types - One type, several, or nothing at all to match every drag.
+ * @param source - The dragged source, compared through {@link dragTypeOf}.
+ */
+export declare function matchesDragType(types: string | string[] | undefined, source: ElementDragPayload): boolean;
+/**
+ * A drag source as consumers read it: routing keys removed, the type resolved
+ * through the adoption, and the dragged body in place of the handle that
+ * carried it.
+ */
+export interface NormalizedDragSource {
+    /** The source's discriminator, or `null` when the drag carries none. */
+    type: string | null;
+    /** The payload the source or adoption attached to the drag. */
+    data: Record<string, unknown>;
+    /** The dragged element: the published body, else the registered element. */
+    element: HTMLElement;
+    /**
+     * The snapshotted native payload for an adopted drag. Absent for registered
+     * element sources.
+     */
+    native?: ExternalDragPayload;
+}
+/**
+ * Normalizes a payload stamped by `dDragAndDropSource`.
+ *
+ * Unlike arbitrary element drags, an owned payload always carries a string
+ * discriminator and an HTML body.
+ *
+ * @param source - The owned payload as the underlying library carries it.
+ */
+export declare function normalizeOwnedDragSource(source: ElementDragPayload): {
+    /** The discriminator stamped by the source. */
+    type: string;
+    /** The consumer payload, including its discriminator. */
+    data: Record<string, unknown>;
+    /** The dragged body, rather than a handle registered on its behalf. */
+    element: HTMLElement;
+};
+/**
+ * Resolves a raw payload into the shape every reader reports.
+ *
+ * @param source - The payload as the underlying library carries it.
+ */
+export declare function normalizeDragSource(source: ElementDragPayload): NormalizedDragSource;
+//# sourceMappingURL=vocabulary.d.ts.map

package/declarations/app/lib/-internals/drag-and-drop/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../../../../../discourse/app/lib/-internals/drag-and-drop/vocabulary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2DAA2D,CAAC;AACpG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4DAA4D,CAAC;AAGtG;;;;GAIG;AACH,eAAO,MAAM,SAAS,uBAAuB,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,kBAAkB,GAAG,WAAW,CAIlE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,kCAAkC,CAAC;AAEjE,gFAAgF;AAChF,eAAO,MAAM,UAAU,cAAc,CAAC;AAEtC;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAKxD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,EACpC,MAAM,EAAE,kBAAkB,WAO3B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9B,4EAA4E;IAC5E,OAAO,EAAE,WAAW,CAAC;IAErB;;;OAGG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG;IACpE,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IAEb,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9B,uEAAuE;IACvE,OAAO,EAAE,WAAW,CAAC;CACtB,CAGA;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,GACzB,oBAAoB,CAgBtB"}

package/declarations/app/lib/ajax-error.d.ts

@@ -7,6 +7,7 @@ export function extractErrorInfo(error: any, defaultMessage: any, opts?: {
     status: any;
 };
 export function extractError(error: any, defaultMessage: any): any;
+export function isReadOnlyError(error: any): boolean;
 export function throwAjaxError(undoCallback: any, defaultMessage: any): (error: any) => never;
 export function flashAjaxError(modal: any, defaultMessage: any): (error: any) => void;
 export function popupAjaxError(error: any): void;

package/declarations/app/lib/ajax-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ajax-error.d.ts","sourceRoot":"","sources":["../../../../discourse/app/lib/ajax-error.js"],"names":[],"mappings":"AAIA;;;;;;;EA+EC;AAED,mEAEC;AAED,yEACmB,UAAK,WAOvB;AAED,kEACU,UAAK,UAGd;AAED,iDASC"}
+{"version":3,"file":"ajax-error.d.ts","sourceRoot":"","sources":["../../../../discourse/app/lib/ajax-error.js"],"names":[],"mappings":"AAIA;;;;;;;EA+EC;AAED,mEAEC;AAED,qDAGC;AAED,yEACmB,UAAK,WAOvB;AAED,kEACU,UAAK,UAGd;AAED,iDASC"}

package/declarations/app/lib/api.d.ts

@@ -9,4 +9,5 @@ export function apiInitializer(apiCodeCallback: (api: import("./plugin-api.gjs")
     after: string;
     initialize(): any;
 };
+export { _INTERNAL_SOURCE_KEY } from "discourse/lib/customization-source";
 //# sourceMappingURL=api.d.ts.map

package/declarations/app/lib/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../discourse/app/lib/api.js"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,gDAHW,CAAC,GAAG,EAAE,OAAO,kBAAkB,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,GAAG,SAChE,MAAM;;;;EAchB"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../discourse/app/lib/api.js"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,gDAHW,CAAC,GAAG,EAAE,OAAO,kBAAkB,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,GAAG,SAChE,MAAM;;;;EAchB"}

package/declarations/app/lib/beacon-pageview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"beacon-pageview.d.ts","sourceRoot":"","sources":["../../../../discourse/app/lib/beacon-pageview.js"],"names":[],"mappings":"AAKA,oDAEC;AAED;;;;;SAoBC"}
+{"version":3,"file":"beacon-pageview.d.ts","sourceRoot":"","sources":["../../../../discourse/app/lib/beacon-pageview.js"],"names":[],"mappings":"AAKA,oDAEC;AAED;;;;;SAqBC"}

package/declarations/app/lib/blocks/-internals/components/block-layout-wrapper.d.ts

@@ -1,82 +1,18 @@
-/**
- * @typedef {import("@glint/template").ComponentLike} CurriedComponent
- */
-/**
- * @typedef {Object} WrappedBlockLayoutArgs
- * @property {string} outletName - The outlet name for class generation.
- * @property {string} name - The block's full registered name.
- * @property {string|null} namespace - The block's namespace prefix.
- * @property {boolean} isContainer - Whether this is a container block.
- * @property {string|null} [id] - Optional block ID for BEM modifiers and targeting.
- * @property {CurriedComponent} Component - The curried block component to render.
- * @property {string} [classNames] - Additional CSS classes from layout entry.
- * @property {string} [decoratorClassNames] - Extra CSS classes from the @block decorator.
- */
-/**
- * @typedef {Object} WrappedBlockLayoutSignature
- * @property {WrappedBlockLayoutArgs} Args
- */
-/**
- * Wraps a block in a standard layout wrapper with BEM-style classes.
- *
- * @param {Object} blockData - Block rendering data.
- * @param {string} blockData.outletName - The outlet name for class generation.
- * @param {string} blockData.name - The block's full registered name.
- * @param {string} blockData.namespace - The block's namespace prefix.
- * @param {boolean} blockData.isContainer - Whether this is a container block.
- * @param {string|null} [blockData.id] - Optional block ID for BEM modifiers.
- * @param {CurriedComponent} blockData.Component - The curried block component.
- * @param {string} [blockData.classNames] - Additional CSS classes from layout entry.
- * @param {string} [blockData.decoratorClassNames] - Extra CSS classes from the @block decorator.
- * @param {import("@ember/owner").default} owner - The application owner for currying.
- * @returns {CurriedComponent} The wrapped component.
- */
-export function wrapBlockLayout(blockData: {
-    outletName: string;
-    name: string;
-    namespace: string;
-    isContainer: boolean;
-    id?: string | null;
-    Component: CurriedComponent;
-    classNames?: string;
-    decoratorClassNames?: string;
-}, owner: import("@ember/owner").default): CurriedComponent;
-export type CurriedComponent = import("@glint/template").ComponentLike;
-export type WrappedBlockLayoutArgs = {
-    /**
-     * - The outlet name for class generation.
-     */
+import type Owner from "@ember/owner";
+import type { BlockComponent } from "discourse/lib/blocks/-internals/types";
+interface WrappedBlockLayoutArgs {
     outletName: string;
-    /**
-     * - The block's full registered name.
-     */
-    name: string;
-    /**
-     * - The block's namespace prefix.
-     */
-    namespace: string | null;
-    /**
-     * - Whether this is a container block.
-     */
+    name?: string;
+    namespace?: string | null;
     isContainer: boolean;
-    /**
-     * - Optional block ID for BEM modifiers and targeting.
-     */
-    id?: string | null;
-    /**
-     * - The curried block component to render.
-     */
-    Component: CurriedComponent;
-    /**
-     * - Additional CSS classes from layout entry.
-     */
+    id?: string;
+    Component: BlockComponent;
     classNames?: string;
-    /**
-     * - Extra CSS classes from the
-     */
-    decoratorClassNames?: string;
-};
-export type WrappedBlockLayoutSignature = {
-    Args: WrappedBlockLayoutArgs;
-};
+    decoratorClassNames?: string | null;
+}
+/**
+ * Wraps a block in a standard layout wrapper with BEM-style classes.
+ */
+export declare function wrapBlockLayout(blockData: WrappedBlockLayoutArgs, owner: Owner): BlockComponent;
+export {};
 //# sourceMappingURL=block-layout-wrapper.d.ts.map

package/declarations/app/lib/blocks/-internals/components/block-layout-wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block-layout-wrapper.d.ts","sourceRoot":"","sources":["../../../../../../../discourse/app/lib/blocks/-internals/components/block-layout-wrapper.gjs"],"names":[],"mappings":"AA2HA;;GAEG;AAEH;;;;;;;;;;GAUG;AAEH;;;GAGG;AAEH;;;;;;;;;;;;;;GAcG;AACH,2CAXG;IAA0B,UAAU,EAA5B,MAAM;IACY,IAAI,EAAtB,MAAM;IACY,SAAS,EAA3B,MAAM;IACa,WAAW,EAA9B,OAAO;IACiB,EAAE,GAA1B,MAAM,GAAC,IAAI;IACiB,SAAS,EAArC,gBAAgB;IACG,UAAU,GAA7B,MAAM;IACa,mBAAmB,GAAtC,MAAM;CAA+D,SACrE,OAAO,cAAc,EAAE,OAAO,GAC5B,gBAAgB,CAI5B;+BArCY,OAAO,iBAAiB,EAAE,aAAa;;;;;gBAKtC,MAAM;;;;UACN,MAAM;;;;eACN,MAAM,GAAC,IAAI;;;;iBACX,OAAO;;;;SACP,MAAM,GAAC,IAAI;;;;eACX,gBAAgB;;;;iBAChB,MAAM;;;;0BACN,MAAM;;;UAKN,sBAAsB"}
+{"version":3,"file":"block-layout-wrapper.d.ts","sourceRoot":"","sources":["../../../../../../../discourse/app/lib/blocks/-internals/components/block-layout-wrapper.gts"],"names":[],"mappings":"AAwGA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAG5E,UAAU,sBAAsB;IAE9B,UAAU,EAAE,MAAM,CAAC;IAEnB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,WAAW,EAAE,OAAO,CAAC;IAErB,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,SAAS,EAAE,cAAc,CAAC;IAE1B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,sBAAsB,EACjC,KAAK,EAAE,KAAK,GACX,cAAc,CAEhB"}

package/declarations/app/lib/blocks/-internals/components/block-outlet-inline-error.d.ts

@@ -1,13 +1,16 @@
+import Component from "@glimmer/component";
+import { type TrustedHTML } from "@ember/template";
+interface BlockOutletInlineErrorSignature {
+    Args: {
+        error: Error;
+    };
+}
 /**
  * Displays an error inline within a block outlet.
  * Uses FlashMessage to render the error in a consistent format.
- *
- * @param {Error|string|Object} error - The error to display. Can be an Error object,
- *   a string, an HTTP response object with responseJSON/responseText, or a jqXHR object.
  */
-export default class BlockOutletInlineError extends Component<any> {
-    constructor(owner: import("@ember/-internals/owner").default, args: any);
-    get errorMessage(): any;
+export default class BlockOutletInlineError extends Component<BlockOutletInlineErrorSignature> {
+    get errorMessage(): string | TrustedHTML;
 }
-import Component from "@glimmer/component";
+export {};
 //# sourceMappingURL=block-outlet-inline-error.d.ts.map

package/declarations/app/lib/blocks/-internals/components/block-outlet-inline-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block-outlet-inline-error.d.ts","sourceRoot":"","sources":["../../../../../../../discourse/app/lib/blocks/-internals/components/block-outlet-inline-error.gjs"],"names":[],"mappings":"AA6BA;;;;;;GAMG;AACH;;IACE,wBAKC;CAeF;sBAjCqB,oBAAoB"}
+{"version":3,"file":"block-outlet-inline-error.d.ts","sourceRoot":"","sources":["../../../../../../../discourse/app/lib/blocks/-internals/components/block-outlet-inline-error.gts"],"names":[],"mappings":"AAAA,OAkCO,SAAS,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,KAAK,WAAW,EAAa,MAAM,iBAAiB,CAAC;AAI9D,UAAU,+BAA+B;IACvC,IAAI,EAAE;QAIJ,KAAK,EAAE,KAAK,CAAC;KACd,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,sBAAuB,SAAQ,SAAS,CAAC,+BAA+B,CAAC;IAC5F,IAAI,YAAY,IAAI,MAAM,GAAG,WAAW,CASvC;CAeF"}