@intentic/extension-ui 1.287.0 → 1.290.0

package/dist/format.js

@@ -1,5 +1,5 @@
 // Generated by scripts/build.mjs: do not edit.
-// The formatting half of the kit, off the same host bridge as ./index.js.
+// The kit's format entry point, off the same host bridge as ./index.js.
 const host = globalThis.__intenticHost;
 if (host === undefined) {
     throw new Error("@intentic/extension-ui was loaded outside an intentic host: its helpers come from the app, not from this package.");

package/dist/i18n.js

@@ -0,0 +1,9 @@
+// Generated by scripts/build.mjs: do not edit.
+// The kit's i18n entry point, off the same host bridge as ./index.js.
+const host = globalThis.__intenticHost;
+if (host === undefined) {
+    throw new Error("@intentic/extension-ui was loaded outside an intentic host: its helpers come from the app, not from this package.");
+}
+const m = host.modules["@intentic/extension-ui"];
+export const activeLocale = m["activeLocale"];
+export const extensionT = m["extensionT"];

package/dist/index.js

@@ -67,10 +67,12 @@ export const StatusTally = m["StatusTally"];
 export const StepSection = m["StepSection"];
 export const TIME_WINDOWS = m["TIME_WINDOWS"];
 export const ToggleSwitch = m["ToggleSwitch"];
+export const activeLocale = m["activeLocale"];
 export const appLink = m["appLink"];
 export const browserOwnsClick = m["browserOwnsClick"];
 export const clipboardOf = m["clipboardOf"];
 export const errorMessage = m["errorMessage"];
+export const extensionT = m["extensionT"];
 export const fixStanceLook = m["fixStanceLook"];
 export const formatBytes = m["formatBytes"];
 export const formatDate = m["formatDate"];

package/dist/types/extension-ui/src/i18n.d.ts

@@ -0,0 +1,6 @@
+import { type Locale } from "../../ui/src/i18n/index.js";
+import type { Ref } from "vue";
+export type ExtensionT = (key: string, values?: Record<string, unknown>) => string;
+export declare const extensionT: (extensionId: string) => ExtensionT;
+export declare const activeLocale: Readonly<Ref<Locale>>;
+export type { Locale };

package/dist/types/extension-ui/src/index.d.ts

@@ -1,5 +1,6 @@
 export { AgentRunButton, type AgentRunAttempt, type AgentRunChoice, type AgentRunPicker, type ModelPicking, useAgentRunPick, type FixStanceLook, fixStanceLook, AnchoredOverlay, Avatar, Button, vAction, BarChart, BottomSheet, BrandMark, Card, clipboardOf, browserOwnsClick, appLink, openForwardedPort, ChangeStatusMark, type ChangeStatus, ui, Code, CodeField, ConfirmDialog, ContextMenu, CopyButton, StatusTally, type TallyItem, DagEditor, DagGraph, type DagEdge, type DagNode, DiffStat, DisclosureRow, FilterBar, Icon, type IconName, ImageView, InfoDialog, InfoHint, InfoTable, isRenderableImage, Markdown, MarkdownDocument, MarkdownFigure, Modal, type NavGroup, NavRail, NoteEditor, type NoteDraft, type NoteDraftOptions, useNoteDraft, useKeyedDraft, type NoticeModel, type NoticeTone, type NoticeAction, Notice, NoticeStack, Page, PageAction, PageHeader, ScrollFrame, PersonaFace, type PersonaLike, Picker, ProjectChip, type PickerGroup, type PickerOption, type PickerOptions, ProgressRing, RepoRail, type RepoRailAll, type RepoRailGroup, type RepoRailRow, ProseField, ResizeSeam, ResponsiveOverlay, Row, RowGroup, SearchBar, SegmentedControl, seriesColor, sinceOf, useLoadingReveal, SkeletonRows, SplitView, StatStrip, StatusBadge, type StatusVariant, StepSection, TIME_WINDOWS, type TimeWindow, timeWindowWords, useCompact, useDevice, useListNavigation, useNow, errorMessage, noticeFrom, noticeOf, useAsyncAction, useNarrow, useRailMemory, useScrollReset, type StickyTop, useStickyTop, useTheme, } from "../../ui/src/index.js";
 export { formatBytes, formatDate, formatDateTime, formatDayMonth, formatDuration, formatTime, formatTimestamp, formatTokens, formatWeekdayTime, freshness, timeAgo, } from "./format.js";
+export { activeLocale, extensionT } from "./i18n.js";
 export type { BarsFigure, BarsFigureItem, DagFigure, DagFigureEdge, DagFigureNode, Figure, FigureAccent, MermaidFigure, StatsFigure, StatsFigureItem, } from "../../ui/src/markdown/index.js";
 export { default as Checkbox } from "primevue/checkbox";
 export type { MenuItem } from "primevue/menuitem";

package/dist/types/ui/src/components/charts/DagGraph.vue.d.ts

@@ -18,6 +18,7 @@ declare const __VLS_export: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_se
             readonly x: number;
             readonly y: number;
         };
+        touchPan?: boolean;
     } & {
         modelValue?: string | undefined;
     }) & {

package/dist/types/ui/src/components/forms/NoteEditor.vue.d.ts

@@ -28,15 +28,15 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_88) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    save: () => any;
     cancel: () => any;
+    save: () => any;
     remove: () => any;
     edit: () => any;
     "update:source": (value: string) => any;
     "update:confirming": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onSave?: (() => any) | undefined;
     onCancel?: (() => any) | undefined;
+    onSave?: (() => any) | undefined;
     onRemove?: (() => any) | undefined;
     onEdit?: (() => any) | undefined;
     "onUpdate:source"?: ((value: string) => any) | undefined;

package/dist/types/ui/src/components/markdown/MarkdownDocument.vue.d.ts

@@ -29,12 +29,12 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
     dirty: import("vue").ComputedRef<boolean>;
     status: import("vue").ComputedRef<string>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    save: (value: string) => any;
     change: (value: string) => any;
+    save: (value: string) => any;
     "update:modelValue": (value: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    onSave?: ((value: string) => any) | undefined;
     onChange?: ((value: string) => any) | undefined;
+    onSave?: ((value: string) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/types/ui/src/components/overlays/ConfirmDialog.vue.d.ts

@@ -3,6 +3,7 @@ declare const __VLS_export: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_se
     props: import("vue").PublicProps & __VLS_PrettifyLocal<{
         open: boolean;
         header: string;
+        headerIcon?: IconName;
         confirmLabel: string;
         confirmIcon?: IconName;
         items?: readonly T[];

package/dist/types/ui/src/components/overlays/Modal.vue.d.ts

@@ -5,9 +5,12 @@ type __VLS_Props = {
     scroll?: boolean;
     dismissable?: boolean;
     position?: `center` | `top`;
+    labelledBy?: string;
     appendTo?: HTMLElement | string;
 };
-declare var __VLS_12: {}, __VLS_14: {}, __VLS_17: {};
+declare var __VLS_12: {
+    titleClass: string;
+}, __VLS_14: {}, __VLS_17: {};
 type __VLS_Slots = {} & {
     header?: (props: typeof __VLS_12) => any;
 } & {

package/dist/types/ui/src/i18n/i18n.d.ts

@@ -0,0 +1,24 @@
+import { type ComputedRef, type App } from "vue";
+import { BASE_LOCALE, type Locale } from "./locales.js";
+export type MessageTree = {
+    readonly [key: string]: string | MessageTree;
+};
+export interface Catalog {
+    readonly namespace?: string;
+    readonly base: MessageTree;
+    readonly load: (locale: Exclude<Locale, typeof BASE_LOCALE>) => Promise<{
+        readonly default: MessageTree;
+    }>;
+}
+declare const i18n: import("vue-i18n").I18n<{}, {}, {}, string, false>;
+export declare const activeLocale: ComputedRef<Locale>;
+export declare const registerCatalog: (catalog: Catalog) => Promise<void>;
+export declare const setLocale: (locale: Locale) => Promise<void>;
+export declare const startI18n: () => Promise<void>;
+export declare const installI18n: (app: App) => void;
+export type TypedT = typeof i18n.global.t;
+export type LooseT = (key: string, values?: Record<string, unknown>) => string;
+export declare function useT(): TypedT;
+export declare function useT(namespace: string): LooseT;
+export declare const t: TypedT;
+export { BASE_LOCALE, isLocale, type Locale, LOCALE_CODES, LOCALE_KEY, LOCALES, negotiate } from "./locales.js";

package/dist/types/ui/src/i18n/index.d.ts

@@ -0,0 +1,7 @@
+import base from "./locales/en.json";
+declare module "vue-i18n" {
+    interface DefineLocaleMessage {
+        readonly ui: typeof base;
+    }
+}
+export { activeLocale, BASE_LOCALE, type Catalog, installI18n, isLocale, type Locale, LOCALE_CODES, LOCALE_KEY, LOCALES, type LooseT, type MessageTree, negotiate, registerCatalog, setLocale, startI18n, t, type TypedT, useT, } from "./i18n.js";

package/dist/types/ui/src/i18n/locales.d.ts

@@ -0,0 +1,32 @@
+export interface LocaleEntry {
+    readonly endonym: string;
+    readonly tag: string;
+}
+export declare const LOCALES: {
+    readonly en: {
+        readonly endonym: "English";
+        readonly tag: "en";
+    };
+    readonly de: {
+        readonly endonym: "Deutsch";
+        readonly tag: "de";
+    };
+    readonly es: {
+        readonly endonym: "Español";
+        readonly tag: "es";
+    };
+    readonly fr: {
+        readonly endonym: "Français";
+        readonly tag: "fr";
+    };
+    readonly pl: {
+        readonly endonym: "Polski";
+        readonly tag: "pl";
+    };
+};
+export type Locale = keyof typeof LOCALES;
+export declare const BASE_LOCALE = "en";
+export declare const LOCALE_CODES: readonly Locale[];
+export declare const isLocale: (value: unknown) => value is Locale;
+export declare const negotiate: (preferred: readonly string[]) => Locale;
+export declare const LOCALE_KEY = "ui-locale";

package/dist/types/ui/src/lib/format.d.ts

@@ -2,6 +2,7 @@ export declare const formatBytes: (bytes: number | undefined) => string;
 export declare const formatDuration: (seconds: number) => string;
 export declare const formatTokens: (tokens: number) => string;
 export declare const initialsOf: (name: string) => string | undefined;
+export declare const setFormatLocale: (tag: string) => void;
 export declare const formatDate: (at: number) => string;
 export declare const formatDayMonth: (at: number) => string;
 export declare const formatDateTime: (at: number) => string;

package/dist/types/ui/src/lib/portPreview.d.ts

@@ -16,6 +16,7 @@ export interface ProbeOptions {
     readonly onWaiting?: (elapsedMs: number, slow: boolean) => void;
     readonly stillWanted?: () => boolean;
 }
+export declare const probePreviewOnce: (url: string) => Promise<PreviewProbe>;
 export declare const probePreview: (url: string, options?: ProbeOptions) => Promise<PreviewProbe>;
 export interface ForwardedPortTab {
     readonly port: number;

package/names.mjs

@@ -38,6 +38,8 @@ export const extensionUiNames = [
     "formatTokens",
     "formatWeekdayTime",
     "freshness",
+    "activeLocale",
+    "extensionT",
     "Icon",
     "ImageView",
     "InfoDialog",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentic/extension-ui",
-  "version": "1.287.0",
+  "version": "1.290.0",
   "description": "The UI kit intentic extensions render with, host-provided at runtime (the app's own components via the import map), so extension UI is always native to the shell",
   "license": "MIT",
   "type": "module",
@@ -31,6 +31,11 @@
       "types": "./dist/types/extension-ui/src/format.d.ts",
       "default": "./dist/format.js"
     },
+    "./i18n": {
+      "@intentic/src": "./src/i18n.ts",
+      "types": "./dist/types/extension-ui/src/i18n.d.ts",
+      "default": "./dist/i18n.js"
+    },
     "./names": "./names.mjs"
   },
   "dependencies": {

package/src/i18n.ts

@@ -0,0 +1,39 @@
+import { activeLocale as active, type Locale, useT } from "@intentic/ui/i18n";
+import type { Ref } from "vue";
+
+// The kit's translator, reachable without the component barrel: `index.ts` pulls in every .vue component, which breaks
+// an extension's node-environment tests that have no Vue plugin to parse SFCs with. A source-level door for in-repo
+// extensions and their tests; a git-installed bundle resolves through the import map instead, which carries the same
+// names, and either way the words come from the host's one instance rather than a second copy of vue-i18n.
+//
+// EVERY EXPORT BELOW IS ANNOTATED BY HAND, and that is load-bearing. This package is published; an inferred type here
+// would name `vue-i18n` in the emitted declarations and make an outside extension author install a library they never
+// call, just to type-check. Spelled out, the published types reach no further than `vue` and the locale table.
+
+/**
+ * Translating an extension's own keys. A plain string rather than a checked union: an extension's catalog belongs to
+ * its own package, and no schema on this side has ever seen it.
+ */
+export type ExtensionT = (key: string, values?: Record<string, unknown>) => string;
+
+/**
+ * One extension's translator, bound to the slice of the message tree the host mounted its catalog under. Keys are its
+ * own — `t("panel.title")` for what lives at `ext.<id>.panel.title` — so nothing it writes can collide with the app's
+ * keys or another extension's.
+ *
+ * Bind it once per extension rather than per component:
+ *
+ * ```ts
+ * // src/i18n.ts
+ * export const t = extensionT(extensionIdOf(manifest));
+ * ```
+ *
+ * The messages themselves are declared on the extension's module (`export const messages`), which the host loads for
+ * the reader's language before it calls `activate`.
+ */
+export const extensionT = (extensionId: string): ExtensionT => useT(`ext.${extensionId}`);
+
+/** The language on screen, for the rare contribution that formats something itself. Read-only: change it with nothing. */
+export const activeLocale: Readonly<Ref<Locale>> = active;
+
+export type { Locale };

package/src/index.ts

@@ -169,6 +169,11 @@ export {
     freshness,
     timeAgo,
 } from "./format.js";
+// The extension's own words. `extensionT(id)` is the translator for the catalog the host mounted from the module's
+// `messages` export; `activeLocale` is the language on screen, for a contribution that formats something itself.
+// The `Locale` type comes off `@intentic/extension-ui/i18n`, not from here: this file's re-exports become runtime
+// bindings on the host bridge, and a type has none.
+export { activeLocale, extensionT } from "./i18n.js";
 // Types only, so an extension can build a figure straight from facts it holds instead of round-tripping through
 // markdown. The parser and document splitter stay in `<Markdown>`, not here.
 export type {