@ikonai/sdk-react-ui 1.11.0 → 1.11.3

package/auth/auth-service.d.ts

@@ -103,7 +103,7 @@ export declare function parseOAuthError(): OAuthErrorResult | null;
 /**
  * True when the URL asks this tab to skip the local-dev auto-login (`?ikon-signed-out`).
  *
- * A local `ikon app run` signs the developer straight in, which is what you want while building —
+ * A local `ikon run` signs the developer straight in, which is what you want while building —
  * and exactly what you cannot have while checking the signed-out product. Without this, seeing the
  * public site means logging out by hand in a throwaway browser profile, so it tends not to happen
  * and the guest experience ships unlooked-at. Local dev only: it suppresses the injected developer

package/auth/storage.d.ts

@@ -66,7 +66,7 @@ export declare function isSignedInBootLikely(): boolean;
  */
 export declare function clearAuthSession(): void;
 /**
- * Mark dev auto-login as having been attempted for the given `ikon app run` id (stored in sessionStorage
+ * Mark dev auto-login as having been attempted for the given `ikon run` id (stored in sessionStorage
  * so it survives the logout's localStorage.clear() + reload). A no-op when no run id is available.
  */
 export declare function markAutoLoginAttempted(runId: string | undefined): void;

package/auth/types.d.ts

@@ -15,7 +15,7 @@ export type AuthMethod = LoginMethod | 'sso';
  * Authenticated user information.
  *
  * `provider` covers the interactive login methods plus 'anonymous' (guest backend session) and 'dev'
- * (local `ikon app run` developer auto-login).
+ * (local `ikon run` developer auto-login).
  */
 export interface AuthUser {
     id: string;
@@ -60,12 +60,12 @@ export interface AuthConfig {
     /** Optional custom auth URL. If not provided, derived from environment. */
     authUrl?: string;
     /**
-     * Developer JWT injected by a local `ikon app run` to auto-login as the `ikon login` developer.
+     * Developer JWT injected by a local `ikon run` to auto-login as the `ikon login` developer.
      * Local dev only — never set in deployed builds.
      */
     devLoginToken?: string;
     /**
-     * Unique id for the current `ikon app run`. Auto-login is suppressed once the user logs out within a
+     * Unique id for the current `ikon run`. Auto-login is suppressed once the user logs out within a
      * run, but a new run mints a new id and re-enables it. Paired with {@link devLoginToken}.
      */
     devLoginRunId?: string;

package/base/base-div.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-div.d.ts","sourceRoot":"","sources":["../../../../sdk/sdk-react-ui/src/base/base-div.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAmbnE,wBAAgB,qBAAqB,IAAI,uBAAuB,CAmD/D;AAsDD,wBAAgB,mBAAmB,IAAI,uBAAuB,EAAE,CAO/D"}
+{"version":3,"file":"base-div.d.ts","sourceRoot":"","sources":["../../../../sdk/sdk-react-ui/src/base/base-div.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAocnE,wBAAgB,qBAAqB,IAAI,uBAAuB,CAmD/D;AAsDD,wBAAgB,mBAAmB,IAAI,uBAAuB,EAAE,CAO/D"}

package/base/focus-hint-dispatch.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Arbitrates `std.focus-hint` nodes: the ranking, cooldown and announcement half of the FocusHint
+ * contract. The renderer submits one hint per effect run; the dispatcher decides whether it acts,
+ * and when.
+ *
+ * - Hints submitted in the same tick compete. Within each scroll container only the highest
+ *   `ranking` scrolls it, on every re-send, which is what keeps a streaming reply followed. Focus
+ *   and the announcement go to the highest-ranked hint with something new, a hint key or region
+ *   text its region has not acted on yet. Ties go to the one submitted last, as rendering in
+ *   document order did before.
+ * - `cooldownMs` is per region, the element the hint was placed in. A hint arriving inside the
+ *   window is held and acts when the window ends, replacing any hint already held there, so a
+ *   churning region acts at most once per window and still lands on its latest state.
+ * - The announcement waits until the region's text has been still for a settle window (the longer
+ *   of `ANNOUNCEMENT_SETTLE_MS` and the cooldown), so a streamed reply is read once it stops, not
+ *   every time a chunk lands. It says what arrived: only the appended part when the text extends
+ *   what that region last announced, otherwise the whole text. Past the cap the oldest part is
+ *   dropped, so the newest content is what is read.
+ * - The announcement goes through one shared, visually hidden live region per politeness, so it
+ *   reaches a screen reader whatever the hinted element's own markup is.
+ */
+export type FocusHintPoliteness = 'polite' | 'assertive';
+export interface FocusHintSubmission {
+    /** The element the hint was placed in: its text is announced and its cooldown is kept. */
+    readonly region: HTMLElement;
+    readonly hintKey: string | undefined;
+    readonly ranking: number;
+    readonly cooldownMs: number;
+    /** Null for a hint that does not scroll. */
+    readonly scrollGroup: object | null;
+    /** Null for a hint that moves focus without an announcement. */
+    readonly politeness: FocusHintPoliteness | null;
+    /** Scrolls the region into view, returning what undoes its listeners. */
+    scroll(): (() => void) | undefined;
+    focus(): void;
+}
+export interface FocusHintHandle {
+    cancel(): void;
+}
+export declare function submitFocusHint(submission: FocusHintSubmission): FocusHintHandle;
+//# sourceMappingURL=focus-hint-dispatch.d.ts.map

package/base/focus-hint-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-hint-dispatch.d.ts","sourceRoot":"","sources":["../../../../sdk/sdk-react-ui/src/base/focus-hint-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,gEAAgE;IAChE,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAChD,yEAAyE;IACzE,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,IAAI,IAAI,CAAC;CAChB;AA8CD,wBAAgB,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,eAAe,CAoBhF"}