@epam/ai-dial-chat-hooks 1.3.0-dev.28 → 1.3.0-dev.282

package/scheduled-tasks.js

@@ -5,4 +5,9 @@ import { prepareScheduledTaskCreateBody as o, prepareScheduledTaskUpdateBody as
 import { createScheduledTasksApiClient as c } from "./scheduled-task/scheduled-tasks-api-client.js";
 import { useScheduledTasks as l } from "./scheduled-task/use-scheduled-tasks.js";
 import { mergeRunsById as u, useScheduledTaskRuns as d } from "./scheduled-task/use-scheduled-task-runs.js";
-export { t as ScheduledTaskTriggerDescriptionKind, e as UnsupportedTriggerReason, c as createScheduledTasksApiClient, n as describeScheduledTaskTrigger, r as mapFormValuesToCreateBody, i as mapFormValuesToUpdateBody, a as mapScheduledTaskDtoToFormValues, u as mergeRunsById, o as prepareScheduledTaskCreateBody, s as prepareScheduledTaskUpdateBody, d as useScheduledTaskRuns, l as useScheduledTasks };
+import { getNextCronOccurrence as f } from "./scheduled-task/scheduled-task-next-occurrence.js";
+import { checkScheduledTaskAuthSessionError as p } from "./scheduled-task/check-scheduled-task-auth-session-error.js";
+import { useScheduledTaskSkillDisplayNames as m } from "./scheduled-task/useScheduledTaskSkillDisplayNames/useScheduledTaskSkillDisplayNames.js";
+import { ActiveScheduledTaskDetailState as h, ActiveScheduledTaskStatus as g, resolveActiveScheduledTask as _ } from "./scheduled-task/active-scheduled-task.js";
+import { useActiveScheduledTaskDetails as v } from "./scheduled-task/useActiveScheduledTaskDetails.js";
+export { h as ActiveScheduledTaskDetailState, g as ActiveScheduledTaskStatus, t as ScheduledTaskTriggerDescriptionKind, e as UnsupportedTriggerReason, p as checkScheduledTaskAuthSessionError, c as createScheduledTasksApiClient, n as describeScheduledTaskTrigger, f as getNextCronOccurrence, r as mapFormValuesToCreateBody, i as mapFormValuesToUpdateBody, a as mapScheduledTaskDtoToFormValues, u as mergeRunsById, o as prepareScheduledTaskCreateBody, s as prepareScheduledTaskUpdateBody, _ as resolveActiveScheduledTask, v as useActiveScheduledTaskDetails, d as useScheduledTaskRuns, m as useScheduledTaskSkillDisplayNames, l as useScheduledTasks };

package/scroll-anchoring.d.ts

@@ -1,50 +1,2 @@
-import { RefObject } from 'react';
-
-/**
- * Owns chat-list scrolling: anchors a new turn near the viewport top, keeps
- * the position stable while the response streams, and reports whether the
- * scroll-to-bottom button should be shown.
- *
- * The temporary spacer is technical scroll room, not user-visible content:
- * it is sized to the minimum required to make the anchor reachable and manual
- * scrolling is clamped before the user can move past the real message content.
- */
-export declare const useConversationScroll: <T>({ messages, isAssistantTyping, conversationId, }: UseConversationScrollParams<T>) => UseConversationScrollResult;
-
-/** Parameters for {@link useConversationScroll}. `T` is never read — only `messages.length` is used to detect growth/reset. */
-export declare interface UseConversationScrollParams<T> {
-    /** Messages currently rendered in the list. */
-    messages: T[];
-    /** Whether an assistant response is currently streaming in. */
-    isAssistantTyping: boolean;
-    /** Identifier of the conversation being displayed. */
-    conversationId: string;
-}
-
-/** Return value of {@link useConversationScroll}. */
-export declare interface UseConversationScrollResult {
-    /** Attach to the scrollable message-list element. */
-    containerRef: RefObject<HTMLDivElement | null>;
-    /** Attach to the element wrapping all rendered messages (used to detect content growth). */
-    contentRef: RefObject<HTMLDivElement | null>;
-    /**
-     * Attach to a spacer element, a sibling rendered right after `contentRef`
-     * inside `containerRef`. Its height is set imperatively, not via React
-     * state. Render it with `shrink-0` and an initial `style={{ height: 0 }}`.
-     */
-    spacerRef: RefObject<HTMLDivElement | null>;
-    /** Callback ref to register/unregister a rendered message's DOM node by index. */
-    setMessageRef: (index: number, el: HTMLDivElement | null) => void;
-    /** Whether the scroll-to-bottom button should be shown. */
-    isScrollButtonVisible: boolean;
-    /** Smoothly scrolls to the current bottom of the actual message content. */
-    scrollToBottom: () => void;
-    /**
-     * Arms the message at `index` to be scrolled near the top of the viewport
-     * on the next render — call right before triggering a send, regenerate,
-     * or edit-and-resubmit so the resulting message anchors near the top.
-     */
-    armAnchor: (index: number) => void;
-}
-
-export { }
+export * from './entry-points/scroll-anchoring.js'
+export {}

package/scroll-anchoring.js

@@ -1,2 +1 @@
-import { useConversationScroll as e } from "./conversation/useConversationScroll/useConversationScroll.js";
-export { e as useConversationScroll };
+export { useConversationScroll } from "./conversation/useConversationScroll/useConversationScroll.js";

package/shared/application-schema.d.ts

@@ -0,0 +1,16 @@
+/** Shape of an application schema sufficient to classify it. */
+export interface QuickAppSchemaLike {
+    id?: string;
+    displayName?: string;
+}
+/** True when `schema` is the custom-app (code app) schema. */
+export declare const isCustomAppSchema: (schema?: QuickAppSchemaLike) => boolean;
+/** True when `schema` is a Quick App 2.0 schema. */
+export declare const isQuickAppSchema: (schema?: QuickAppSchemaLike) => boolean;
+/** An application schema with a resolved id, as returned by {@link getRunnerSchemas}. */
+export type RunnerSchema<T extends QuickAppSchemaLike> = T & {
+    id: string;
+};
+/** Returns the schemas that create schema-based apps: unique by id, without id-less entries or the custom-app schema. */
+export declare const getRunnerSchemas: <T extends QuickAppSchemaLike>(schemas: T[]) => RunnerSchema<T>[];
+//# sourceMappingURL=application-schema.d.ts.map

package/shared/application-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-schema.d.ts","sourceRoot":"","sources":["../../src/shared/application-schema.ts"],"names":[],"mappings":"AAMA,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,GAAI,SAAS,kBAAkB,KAAG,OAChB,CAAC;AAQjD,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,GAAI,SAAS,kBAAkB,KAAG,OAGpB,CAAC;AAE5C,yFAAyF;AACzF,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,kBAAkB,IAAI,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,yHAAyH;AACzH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,kBAAkB,EAC3D,SAAS,CAAC,EAAE,KACX,YAAY,CAAC,CAAC,CAAC,EASjB,CAAC"}

package/shared/application-schema.js

@@ -1,7 +1,7 @@
 //#region src/shared/application-schema.ts
-var e = "custom_app", t = (t) => !!t && t.id === e, n = (e) => !!e && (!!e.id?.endsWith("quickapps2") || e.displayName === "Quick app 2.0"), r = (e) => {
+var e = (e) => !!e && e.id === "custom_app", t = (e) => !!e && (!!e.id?.endsWith("quickapps2") || e.displayName === "Quick app 2.0"), n = (t) => {
 	let n = /* @__PURE__ */ new Set();
-	return e.filter((e) => !e.id || t(e) || n.has(e.id) ? !1 : (n.add(e.id), !0));
+	return t.filter((t) => !t.id || e(t) || n.has(t.id) ? !1 : (n.add(t.id), !0));
 };
 //#endregion
-export { r as getRunnerSchemas, t as isCustomAppSchema, n as isQuickAppSchema };
+export { n as getRunnerSchemas, e as isCustomAppSchema, t as isQuickAppSchema };

package/shared/browser-timezone.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolves the browser's current IANA timezone for request-scoped downstream
+ * context. Detection is best-effort because embedded or restricted runtimes
+ * may expose an incomplete `Intl` implementation.
+ */
+export declare const getBrowserTimezone: () => string | undefined;
+//# sourceMappingURL=browser-timezone.d.ts.map

package/shared/browser-timezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-timezone.d.ts","sourceRoot":"","sources":["../../src/shared/browser-timezone.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAO,MAAM,GAAG,SAM9C,CAAC"}

package/shared/client-channel.d.ts

@@ -0,0 +1,53 @@
+/** A DIAL Core client-channel RPC request event, as framed on the `subscribe` SSE stream. */
+export interface ClientChannelRpcRequest {
+    /** RPC correlation id the host answers with. */
+    id: string;
+    /** RPC method name, e.g. `TOOLSET_SIGNIN_METHOD`. */
+    method: string;
+    /** Method-specific parameters. */
+    params?: Record<string, unknown>;
+}
+/** Method name for a mid-completion toolset sign-in interrupt. */
+export declare const TOOLSET_SIGNIN_METHOD = "toolset/signin";
+/** Method name for a mid-completion application external-service sign-in interrupt. */
+export declare const EXTERNAL_SERVICE_SIGNIN_METHOD = "external-service/signin";
+/** Kind of sign-in a pending client-channel event asks for. */
+export declare enum PendingSigninEventKind {
+    /** A `toolset/signin` request. */
+    Toolset = "toolset",
+    /** An `external-service/signin` request. */
+    ExternalService = "external-service"
+}
+/** A pending `toolset/signin` event awaiting a login/decline resolution. */
+export interface PendingToolsetSigninEvent {
+    /** Discriminant. */
+    kind: PendingSigninEventKind.Toolset;
+    /** RPC correlation id — every login/decline action resolves exactly this id. */
+    id: string;
+    /** Id of the toolset to sign in to. */
+    toolsetId: string;
+}
+/**
+ * A pending `external-service/signin` event awaiting a login/decline
+ * resolution. The underlying RPC event's `params.url` is shaped
+ * `applications/{bucket}/{app}/external_services/{name}` (parsed by
+ * `parseExternalServiceUrl`): `appId` is the application's own resource id
+ * (used to fetch its details for display metadata), `serviceName` keys the
+ * application's `external_services` map for this specific dependency's
+ * `displayName`/`authSettings`, and is also required (rejoined with `appId`
+ * via `buildExternalServiceScopeId`) as the exact scope id DIAL Core expects
+ * for sign-in/sign-out.
+ */
+export interface PendingExternalServiceSigninEvent {
+    /** Discriminant. */
+    kind: PendingSigninEventKind.ExternalService;
+    /** RPC correlation id — every login/decline action resolves exactly this id. */
+    id: string;
+    /** Resource id of the application that depends on the service. */
+    appId: string;
+    /** Key of the service in the application's `external_services` map. */
+    serviceName: string;
+}
+/** A pending sign-in event of either kind. */
+export type PendingSigninEvent = PendingToolsetSigninEvent | PendingExternalServiceSigninEvent;
+//# sourceMappingURL=client-channel.d.ts.map

package/shared/client-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-channel.d.ts","sourceRoot":"","sources":["../../src/shared/client-channel.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,MAAM,WAAW,uBAAuB;IACtC,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,kEAAkE;AAClE,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAEtD,uFAAuF;AACvF,eAAO,MAAM,8BAA8B,4BAA4B,CAAC;AAExE,+DAA+D;AAC/D,oBAAY,sBAAsB;IAChC,kCAAkC;IAClC,OAAO,YAAY;IACnB,4CAA4C;IAC5C,eAAe,qBAAqB;CACrC;AAED,4EAA4E;AAC5E,MAAM,WAAW,yBAAyB;IACxC,oBAAoB;IACpB,IAAI,EAAE,sBAAsB,CAAC,OAAO,CAAC;IACrC,gFAAgF;IAChF,EAAE,EAAE,MAAM,CAAC;IACX,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iCAAiC;IAChD,oBAAoB;IACpB,IAAI,EAAE,sBAAsB,CAAC,eAAe,CAAC;IAC7C,gFAAgF;IAChF,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAC5B,yBAAyB,GAAG,iCAAiC,CAAC"}

package/shared/client-channel.js

@@ -0,0 +1,6 @@
+//#region src/shared/client-channel.ts
+var e = "toolset/signin", t = "external-service/signin", n = /* @__PURE__ */ function(e) {
+	return e.Toolset = "toolset", e.ExternalService = "external-service", e;
+}({});
+//#endregion
+export { t as EXTERNAL_SERVICE_SIGNIN_METHOD, n as PendingSigninEventKind, e as TOOLSET_SIGNIN_METHOD };

package/shared/cron-day-of-month.d.ts

@@ -0,0 +1,21 @@
+/** APScheduler `day` expression for the last day of the month. */
+export declare const CRON_LAST_DAY_OF_MONTH = "last";
+/**
+ * Calendar days between `date`'s UTC date and its local date: `-1` when UTC is
+ * still on the previous day (east of UTC), `1` when it has reached the next.
+ */
+export declare const getUtcDayShift: (date: Date) => number;
+/**
+ * Converts a local day-of-month to the UTC `day` cron value. The local 1st
+ * shifted back is always the previous month's last day, hence `'last'`. The
+ * local 31st shifted forward stays `'1'`: a single cron field cannot express
+ * "the 1st after a 31-day month only".
+ */
+export declare const toUtcCronDayOfMonth: (localDay: number, utcDayShift: number) => string;
+/**
+ * Inverts {@link toUtcCronDayOfMonth}; returns `undefined` for a value the
+ * form cannot represent. A UTC 31st shifted forward maps to the 1st, so tasks
+ * saved before `'last'` was emitted still open in the editor.
+ */
+export declare const toLocalDayOfMonth: (utcDay: string, utcDayShift: number) => string | undefined;
+//# sourceMappingURL=cron-day-of-month.d.ts.map

package/shared/cron-day-of-month.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-day-of-month.d.ts","sourceRoot":"","sources":["../../src/shared/cron-day-of-month.ts"],"names":[],"mappings":"AAQA,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAK7C;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,IAAI,KAAG,MAKzC,CAAC;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,EAChB,aAAa,MAAM,KAClB,MAKF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,aAAa,MAAM,KAClB,MAAM,GAAG,SAcX,CAAC"}

package/shared/cron-day-of-month.js

@@ -1,13 +1,13 @@
 //#region src/shared/cron-day-of-month.ts
-var e = "last", t = 31, n = 864e5, r = (e) => Math.round((Date.UTC(e.getUTCFullYear(), e.getUTCMonth(), e.getUTCDate()) - Date.UTC(e.getFullYear(), e.getMonth(), e.getDate())) / n), i = (n, r) => {
-	let i = n + r;
-	return i < 1 ? e : i > t ? "1" : String(i);
-}, a = (e, n) => {
-	if (e === "last") return n === -1 ? "1" : void 0;
-	let r = Number(e);
-	if (!/^\d+$/.test(e) || r < 1 || r > t) return;
-	let i = r - n;
-	return i < 1 ? String(t) : i > t ? "1" : String(i);
+var e = "last", t = (e) => Math.round((Date.UTC(e.getUTCFullYear(), e.getUTCMonth(), e.getUTCDate()) - Date.UTC(e.getFullYear(), e.getMonth(), e.getDate())) / 864e5), n = (t, n) => {
+	let r = t + n;
+	return r < 1 ? e : r > 31 ? "1" : String(r);
+}, r = (e, t) => {
+	if (e === "last") return t === -1 ? "1" : void 0;
+	let n = Number(e);
+	if (!/^\d+$/.test(e) || n < 1 || n > 31) return;
+	let r = n - t;
+	return r < 1 ? "31" : r > 31 ? "1" : String(r);
 };
 //#endregion
-export { e as CRON_LAST_DAY_OF_MONTH, r as getUtcDayShift, a as toLocalDayOfMonth, i as toUtcCronDayOfMonth };
+export { e as CRON_LAST_DAY_OF_MONTH, t as getUtcDayShift, r as toLocalDayOfMonth, n as toUtcCronDayOfMonth };

package/shared/cron-weekday.d.ts

@@ -0,0 +1,5 @@
+/** Converts an APScheduler weekday (Monday=0..Sunday=6) to a JS `Date` weekday (Sunday=0..Saturday=6). */
+export declare const apSchedulerDayToJsDay: (apSchedulerDay: number) => number;
+/** Converts a JS `Date` weekday (Sunday=0..Saturday=6) to an APScheduler weekday (Monday=0..Sunday=6). */
+export declare const jsDayToApSchedulerDay: (jsDay: number) => number;
+//# sourceMappingURL=cron-weekday.d.ts.map

package/shared/cron-weekday.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-weekday.d.ts","sourceRoot":"","sources":["../../src/shared/cron-weekday.ts"],"names":[],"mappings":"AAMA,0GAA0G;AAC1G,eAAO,MAAM,qBAAqB,GAAI,gBAAgB,MAAM,KAAG,MACrC,CAAC;AAE3B,0GAA0G;AAC1G,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,KAAG,MAAyB,CAAC"}

package/shared/custom-apps.d.ts

@@ -0,0 +1,7 @@
+/** True when `value` is a well-formed absolute `http(s)://` URL. */
+export declare const isValidAbsoluteUrl: (value: string) => boolean;
+/** Parses a custom app's `featuresData` JSON string, or `undefined` if it is empty or invalid. */
+export declare const parseFeaturesData: (value: string) => Record<string, unknown> | undefined;
+/** True when `value` is empty, or a JSON object containing only the allowed `featuresData` keys. */
+export declare const isValidFeaturesData: (value: string) => boolean;
+//# sourceMappingURL=custom-apps.d.ts.map

package/shared/custom-apps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-apps.d.ts","sourceRoot":"","sources":["../../src/shared/custom-apps.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,OASlD,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,GAC5B,OAAO,MAAM,KACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAQ5B,CAAC;AAIF,oGAAoG;AACpG,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,KAAG,OAenD,CAAC"}

package/shared/external-services.d.ts

@@ -0,0 +1,16 @@
+export interface ParsedExternalServiceUrl {
+    /** The application's own resource id — used for `GET /api/v1/deployments/{appId}/details`. */
+    appId: string;
+    /** Key into `applicationDetails.externalServices` for this specific dependency. */
+    serviceName: string;
+}
+export declare const parseExternalServiceUrl: (url: string) => ParsedExternalServiceUrl | null;
+/** Reconstructs the exact scope id Core expects as `ResourceSignInRequest`/`ResourceSignOutRequest`'s `url` field. */
+export declare const buildExternalServiceScopeId: (appId: string, serviceName: string) => string;
+/**
+ * Derives a human-readable fallback label from an external service's raw
+ * `serviceName` when metadata hasn't resolved yet — mirrors
+ * `getToolsetFallbackName`'s percent-decoding behavior (`oauth/toolset-id`).
+ */
+export declare const getExternalServiceFallbackName: (serviceName: string) => string;
+//# sourceMappingURL=external-services.d.ts.map

package/shared/external-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-services.d.ts","sourceRoot":"","sources":["../../src/shared/external-services.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,wBAAwB;IACvC,8FAA8F;IAC9F,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,uBAAuB,GAClC,KAAK,MAAM,KACV,wBAAwB,GAAG,IAS7B,CAAC;AAEF,sHAAsH;AACtH,eAAO,MAAM,2BAA2B,GACtC,OAAO,MAAM,EACb,aAAa,MAAM,KAClB,MAAiE,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GAAI,aAAa,MAAM,KAAG,MAMpE,CAAC"}

package/shared/formatting.d.ts

@@ -0,0 +1,5 @@
+/** Pads a number or numeric string to at least 2 digits with a leading zero (e.g. `9` / `'9'` → `'09'`). */
+export declare const padTwoDigits: (value: number | string) => string;
+/** Formats a Unix timestamp (ms) as a locale-formatted calendar date, e.g. `'22/7/2026'`. */
+export declare const formatCalendarDate: (timestampMs: number) => string;
+//# sourceMappingURL=formatting.d.ts.map

package/shared/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/shared/formatting.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,GAAG,MAAM,KAAG,MACtB,CAAC;AAEjC,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,GAAI,aAAa,MAAM,KAAG,MACb,CAAC"}

package/shared/locale.d.ts

@@ -0,0 +1,45 @@
+import { LocaleTextEntryDto } from '@epam/ai-dial-chat-api-client';
+import { LocaleOption, LocalizedTextEntry } from '@epam/ai-dial-chat-shared';
+/** Lowercased base language of a BCP-47 tag, e.g. `'en-US'` -> `'en'`. */
+export declare const toBaseLocale: (locale: string) => string;
+/**
+ * DIAL Core's shape for a user-facing text field: either a plain string (no
+ * localized variants — displayed identically for every locale) or a map of
+ * locale code to translated value.
+ */
+export type LocalizedText = string | Record<string, string>;
+/**
+ * Resolves a `LocalizedText` value to a single display string for
+ * `activeLocale`: exact locale match, then base-language match, then
+ * `primaryLocale`, then the first defined value in the map, then `''`. A
+ * plain string is returned unchanged — it has no locale variants.
+ */
+export declare const resolveLocalizedText: (value: LocalizedText | undefined | null, activeLocale: string, primaryLocale: string) => string;
+/** Appends a locale's uppercased code to a field label, e.g. `'Name [EN]'`. */
+export declare const appendLocaleCode: (label: string, locale: string) => string;
+/**
+ * Composes the "Add locale" popup's entries into the write-payload shape:
+ * strips the popup's client-only `id`, drops rows with no `language`, drops
+ * rows with neither `name` nor `description`, drops rows colliding with
+ * `primaryLocale` (that content belongs in the primary field, not here), and
+ * dedupes by `language` (last row for a given language wins). Returns
+ * `undefined` (not `[]`) when nothing remains, so a request untouched by
+ * this feature stays byte-identical to today.
+ */
+export declare const composeLocalePayload: (otherLocales: LocalizedTextEntry[], primaryLocale: string) => LocaleTextEntryDto[] | undefined;
+/**
+ * Inverse of {@link composeLocalePayload}: builds the popup's `otherLocales`
+ * entries from a `displayName`/`description` pair as read from DIAL Core.
+ * A plain string on both (or both absent) means no additional locales exist
+ * yet, so this returns `[]`. Otherwise one entry is built per locale key
+ * present in either map, excluding `primaryLocale` — that key is already the
+ * primary Name/Description field, not a row in the popup.
+ */
+export declare const decomposeLocalizedFields: (displayName: LocalizedText | undefined, description: LocalizedText | undefined, primaryLocale: string) => LocalizedTextEntry[];
+/**
+ * Selectable additional-locale options for a locale-picker popup, drawn from
+ * `additionalLocaleCodes` and excluding whichever code is already the
+ * primary Name/Description field.
+ */
+export declare const buildAdditionalLocaleOptions: (additionalLocaleCodes: string[], primaryLocale: string) => LocaleOption[];
+//# sourceMappingURL=locale.d.ts.map

package/shared/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/shared/locale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAEnC,0EAA0E;AAC1E,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,KAAG,MACV,CAAC;AAErC;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,aAAa,GAAG,SAAS,GAAG,IAAI,EACvC,cAAc,MAAM,EACpB,eAAe,MAAM,KACpB,MAWF,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,MACb,CAAC;AAErD;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,kBAAkB,EAAE,EAClC,eAAe,MAAM,KACpB,kBAAkB,EAAE,GAAG,SAczB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,GACnC,aAAa,aAAa,GAAG,SAAS,EACtC,aAAa,aAAa,GAAG,SAAS,EACtC,eAAe,MAAM,KACpB,kBAAkB,EAgBpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GACvC,uBAAuB,MAAM,EAAE,EAC/B,eAAe,MAAM,KACpB,YAAY,EAG0C,CAAC"}

package/shared/locale.js

@@ -6,14 +6,14 @@ var e = (e) => e.split("-")[0].toLowerCase(), t = (t, n, r) => {
 	return t[n] ?? t[i] ?? t[r] ?? Object.values(t).find((e) => e !== void 0) ?? "";
 }, n = (t, n) => `${t} [${e(n).toUpperCase()}]`, r = (e, t) => {
 	let n = /* @__PURE__ */ new Map();
-	for (let r of e) !r.language || r.language === t || !r.name && !r.description || n.set(r.language, {
+	for (let r of e) r.language && r.language !== t && (r.name || r.description) && n.set(r.language, {
 		language: r.language,
 		name: r.name || void 0,
 		description: r.description || void 0
 	});
 	return n.size > 0 ? Array.from(n.values()) : void 0;
 }, i = (e, t, n) => {
-	let r = typeof e == "object" ? e : {}, i = typeof t == "object" ? t : {}, a = new Set([...Object.keys(r), ...Object.keys(i)]);
+	let r = typeof e == "object" ? e : {}, i = typeof t == "object" ? t : {}, a = /* @__PURE__ */ new Set([...Object.keys(r), ...Object.keys(i)]);
 	a.delete(n);
 	let o = 0;
 	return Array.from(a, (e) => ({

package/shared/read-sse-events.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Reads a newline-delimited SSE stream, JSON-decoding each `data:` line and
+ * passing it to `onEvent`. Stops reading — and always releases the reader —
+ * as soon as `onEvent` returns `true`, when the stream ends, or when
+ * `reader.read()` rejects (a network error, or the caller aborting the
+ * stream's own `AbortSignal`, e.g. on timeout). Malformed lines and
+ * non-`data:` lines (comments, keepalives) are skipped silently.
+ */
+export declare const readSseEvents: <TEvent>(stream: ReadableStream<Uint8Array>, onEvent: (event: TEvent) => Promise<boolean> | boolean) => Promise<void>;
+//# sourceMappingURL=read-sse-events.d.ts.map

package/shared/read-sse-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-sse-events.d.ts","sourceRoot":"","sources":["../../src/shared/read-sse-events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GAAU,MAAM,EACxC,QAAQ,cAAc,CAAC,UAAU,CAAC,EAClC,SAAS,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,KACrD,OAAO,CAAC,IAAI,CAyCd,CAAC"}

package/shared/read-sse-events.js

@@ -0,0 +1,33 @@
+//#region src/shared/read-sse-events.ts
+var e = async (e, t) => {
+	let n = e.getReader(), r = new TextDecoder(), i = "";
+	try {
+		for (;;) {
+			let { done: e, value: a } = await n.read();
+			if (e) break;
+			i += r.decode(a, { stream: !0 });
+			let o = i.split("\n");
+			i = o.pop() ?? "";
+			let s = !1;
+			for (let e of o) {
+				let n = e.trim();
+				if (!n.startsWith("data:")) continue;
+				let r = n.slice(5).trim(), i;
+				try {
+					i = JSON.parse(r);
+				} catch {
+					continue;
+				}
+				if (await t(i)) {
+					s = !0;
+					break;
+				}
+			}
+			if (s) break;
+		}
+	} catch {} finally {
+		n.releaseLock();
+	}
+};
+//#endregion
+export { e as readSseEvents };

package/shared/string-utils.d.ts

@@ -0,0 +1,11 @@
+/** Case-insensitive substring match. */
+export declare const includesIgnoreCase: (str: string, query: string) => boolean;
+/** Decodes a URI-encoded path segment, returning the original string if decoding fails. */
+export declare const safeDecodeURI: (path: string) => string;
+/** Alias of {@link safeDecodeURI} for call sites decoding a URI component rather than a path. */
+export declare const safeDecodeURIComponent: (path: string) => string;
+/** Strips trailing slashes from a path segment. */
+export declare const stripTrailingSlashes: (path: string) => string;
+/** Strips leading and trailing slashes from a path segment. */
+export declare const stripSurroundingSlashes: (path: string) => string;
+//# sourceMappingURL=string-utils.d.ts.map

package/shared/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/shared/string-utils.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,OACf,CAAC;AAElD,2FAA2F;AAC3F,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAM5C,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,sBAAsB,SATC,MAAM,KAAG,MASM,CAAC;AAUpD,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,MAInD,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,MAMtD,CAAC"}

package/shared/theme-colors.d.ts

@@ -0,0 +1,16 @@
+/** Colour scheme the operating system reports through `prefers-color-scheme`. */
+export declare enum ColorScheme {
+    /** The OS asks for a dark scheme. */
+    Dark = "dark",
+    /** The OS asks for a light scheme, or states no preference. */
+    Light = "light"
+}
+/** Returns the colour scheme the OS currently prefers. */
+export declare const getOsPreferredTheme: () => ColorScheme;
+/**
+ * Writes `colors` to `element` as `--<key>` custom properties after removing
+ * the ones the previous call wrote to that element. Without `colors` it only
+ * removes them; properties it never wrote are left alone.
+ */
+export declare const applyThemeColors: (element: HTMLElement, colors?: Readonly<Record<string, string>>) => void;
+//# sourceMappingURL=theme-colors.d.ts.map

package/shared/theme-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-colors.d.ts","sourceRoot":"","sources":["../../src/shared/theme-colors.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,oBAAY,WAAW;IACrB,qCAAqC;IACrC,IAAI,SAAS;IACb,+DAA+D;IAC/D,KAAK,UAAU;CAChB;AAED,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,QAAO,WAGhB,CAAC;AAWxB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,WAAW,EACpB,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KACxC,IAkBF,CAAC"}

package/shared/theme-colors.js

@@ -0,0 +1,14 @@
+//#region src/shared/theme-colors.ts
+var e = /* @__PURE__ */ function(e) {
+	return e.Dark = "dark", e.Light = "light", e;
+}({}), t = () => window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light", n = /* @__PURE__ */ new WeakMap(), r = (e, t) => {
+	let r = n.get(e);
+	if (r && (r.forEach((t) => e.style.removeProperty(t)), n.delete(e)), !t) return;
+	let i = Object.entries(t).map(([t, n]) => {
+		let r = `--${t}`;
+		return e.style.setProperty(r, n), r;
+	});
+	i.length > 0 && n.set(e, i);
+};
+//#endregion
+export { e as ColorScheme, r as applyThemeColors, t as getOsPreferredTheme };

package/shared/toolset-login-events.d.ts

@@ -0,0 +1,15 @@
+/** Detail payload for a successful toolset login, generic over the app's own credentials-level type. */
+export interface ToolsetLoginSuccessDetail<T> {
+    /** Already-encoded toolset id/url, as passed into `useToolsetLogin`'s `login`. */
+    toolsetId: string;
+    credentialsLevel: T;
+}
+/**
+ * Broadcasts a successful toolset login to any listener within the current
+ * window — host-to-host, not `postMessage`, since this notifies other React
+ * trees in the same document (e.g. a mounted `AppEditorIframe`), not an
+ * embedded cross-origin iframe.
+ */
+export declare const emitToolsetLoginSuccess: <T>(detail: ToolsetLoginSuccessDetail<T>) => void;
+export declare const subscribeToolsetLoginSuccess: <T>(listener: (detail: ToolsetLoginSuccessDetail<T>) => void) => (() => void);
+//# sourceMappingURL=toolset-login-events.d.ts.map

package/shared/toolset-login-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolset-login-events.d.ts","sourceRoot":"","sources":["../../src/shared/toolset-login-events.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,CAAC,CAAC;CACrB;AAMD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,EACvC,QAAQ,yBAAyB,CAAC,CAAC,CAAC,KACnC,IAMF,CAAC;AAMF,eAAO,MAAM,4BAA4B,GAAI,CAAC,EAC5C,UAAU,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAC,KAAK,IAAI,KACvD,CAAC,MAAM,IAAI,CAcb,CAAC"}

package/shared/usage-stat.d.ts

@@ -0,0 +1,3 @@
+/** `true` when `total` is a real cap: finite, positive, and below DIAL Core's unlimited sentinel. */
+export declare const isCappedStat: (total: number) => boolean;
+//# sourceMappingURL=usage-stat.d.ts.map

package/shared/usage-stat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-stat.d.ts","sourceRoot":"","sources":["../../src/shared/usage-stat.ts"],"names":[],"mappings":"AAMA,qGAAqG;AACrG,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAC4B,CAAC"}

package/shared/usage-stat.js

@@ -0,0 +1,4 @@
+//#region src/shared/usage-stat.ts
+var e = 2 ** 53 - 1, t = (t) => Number.isFinite(t) && t > 0 && t < e;
+//#endregion
+export { t as isCappedStat };

package/shared/usePersistedState/usePersistedState.d.ts

@@ -0,0 +1,28 @@
+/** Host storage operations; a nullish read means no stored value. */
+export interface PersistedStateStorage<TStored> {
+    /** Reads a host-owned key. */
+    read: (key: string) => TStored | null | undefined;
+    /** Writes a host-owned key. */
+    write: (key: string, value: TStored) => void;
+}
+/** Host serialization policy. */
+export interface PersistedStateCodec<T, TStored> {
+    /** Converts storage data into state. */
+    decode: (value: TStored) => T;
+    /** Converts state into storage data. */
+    encode: (value: T) => TStored;
+}
+/** Inputs for mount-initialized persisted state. */
+export interface UsePersistedStateOptions<T, TStored> {
+    /** Host-owned storage key. */
+    key: string;
+    /** Fallback when reading or decoding fails. */
+    initialValue: T;
+    /** Host storage implementation. */
+    storage: PersistedStateStorage<TStored>;
+    /** Host serialization implementation. */
+    codec: PersistedStateCodec<T, TStored>;
+}
+/** Initializes once from storage and preserves in-memory updates when persistence fails. */
+export declare const usePersistedState: <T, TStored>({ key, initialValue, storage, codec, }: UsePersistedStateOptions<T, TStored>) => [T, (value: T) => void];
+//# sourceMappingURL=usePersistedState.d.ts.map

package/shared/usePersistedState/usePersistedState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePersistedState.d.ts","sourceRoot":"","sources":["../../../src/shared/usePersistedState/usePersistedState.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,MAAM,WAAW,qBAAqB,CAAC,OAAO;IAC5C,8BAA8B;IAC9B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD,+BAA+B;IAC/B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC9C;AACD,iCAAiC;AACjC,MAAM,WAAW,mBAAmB,CAAC,CAAC,EAAE,OAAO;IAC7C,wCAAwC;IACxC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,CAAC;IAC9B,wCAAwC;IACxC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;CAC/B;AACD,oDAAoD;AACpD,MAAM,WAAW,wBAAwB,CAAC,CAAC,EAAE,OAAO;IAClD,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,YAAY,EAAE,CAAC,CAAC;IAChB,mCAAmC;IACnC,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACxC,yCAAyC;IACzC,KAAK,EAAE,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;CACxC;AACD,4FAA4F;AAC5F,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAAE,OAAO,EAAE,wCAK3C,wBAAwB,CAAC,CAAC,EAAE,OAAO,CAAC,KAAG,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAuB/D,CAAC"}

package/shared/usePersistedState/usePersistedState.js

@@ -0,0 +1,24 @@
+import { useCallback as e, useState as t } from "react";
+//#region src/shared/usePersistedState/usePersistedState.ts
+var n = ({ key: n, initialValue: r, storage: i, codec: a }) => {
+	let [o, s] = t(() => {
+		try {
+			let e = i.read(n);
+			return e == null ? r : a.decode(e);
+		} catch {
+			return r;
+		}
+	}), c = i.write, l = a.encode;
+	return [o, e((e) => {
+		s(e);
+		try {
+			c(n, l(e));
+		} catch {}
+	}, [
+		n,
+		c,
+		l
+	])];
+};
+//#endregion
+export { n as usePersistedState };