@intentic/extension-ui 1.336.0 → 1.338.0

package/README.md

@@ -20,6 +20,16 @@ flowchart LR
   re-exports, and a `dist/index.js` bridge that throws when loaded outside an intentic host.
 - `names.mjs` lists the runtime export names by hand, because the `.vue` graph cannot load in Node. The editor's shim
   generator reads it, a dev-time assertion in `hostModules.ts` catches drift, and `extensionUiNames.test.ts` fails it.
+- A bundle links these names, so they are versioned with the extension API. `surface.json` in
+  [extension-api](../extension-api) records them per `extensionApiVersion` (`uiKitExports`, from 2.31.0), and the
+  editor's `surface-guard.test.ts` holds them to semver: a new name moves the version a minor, and a name leaves only
+  if `extensionUiDeprecated` in `names.mjs` lists it, in a major at or past the floor it gives. An extension whose
+  `engines.intentic` range the host satisfies then finds every name it was built with. One that asks for a name anyway
+  is stopped before it links: the editor's loader reads the bundle's imports and says which name is missing and that
+  the extension needs updating, where the browser would only say the module "does not provide an export named …".
+- `RepoRail` and `errorMessage` are deprecated and stay until 3.0.0 (`RepoPicker` and `messageOr` replace them).
+  (2026-10-15: `RepoRail` left the kit on 2026-10-12 with no version moving, and every installed extension still
+  importing it stopped loading. It is back unchanged, and nothing recorded the kit's names before this.)
 - `./diff`, `./format`, `./i18n` and `./worker` skip the component barrel, for extension tests that run without a Vue
   compiler. Each is published as a bridge holding what `src/index.ts` re-exports from that file, so a name a subpath
   file exports must also be re-exported from the barrel and listed in `names.mjs`, or an extension installed from git
@@ -31,7 +41,7 @@ flowchart LR
 
 - [src/index.ts](src/index.ts) — the kit: every name an extension may import, with usage notes.
 - [scripts/build.mjs](scripts/build.mjs) — builds the published types and the host bridge from `_editor/ui`.
-- [names.mjs](names.mjs) — the runtime export names the shims and the host check read.
+- [names.mjs](names.mjs) — the runtime export names the shims and the host check read, and the deprecated ones.
 - [../../_editor/web/src/extension-host/hostModules.ts](../../_editor/web/src/extension-host/hostModules.ts) — where the shell publishes its instances to extension bundles.
 
 ## Commands

package/dist/index.js

@@ -55,6 +55,7 @@ export const ProgressRing = m["ProgressRing"];
 export const ProjectChip = m["ProjectChip"];
 export const ProseField = m["ProseField"];
 export const RepoPicker = m["RepoPicker"];
+export const RepoRail = m["RepoRail"];
 export const ResizeSeam = m["ResizeSeam"];
 export const ResponsiveOverlay = m["ResponsiveOverlay"];
 export const Row = m["Row"];

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

@@ -1,4 +1,4 @@
-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, type IconButtonVariants, type TextButtonVariants, type InputVariants, type ChipVariants, type SectionLabelVariants, type ButtonTier, type ButtonTone, Code, CodeField, ConfirmDialog, ContextMenu, OverflowActions, ActionSheet, type ActionItem, CopyButton, AddressField, StatusTally, type TallyItem, DagEditor, DagGraph, type DagEdge, type DagNode, DiffStat, DisclosureRow, FilterBar, Icon, type IconName, ImageView, InfoDialog, InfoHint, InfoTable, type FileFormat, formatOf, 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, RepoPicker, type RepoPickerAll, ProseField, ResizeSeam, ResponsiveOverlay, Row, RowGroup, SearchBar, SegmentedControl, seriesColor, sinceOf, useLoadingReveal, SkeletonRows, SkeletonSnapshot, vSkeletonSource, SplitView, StatStrip, StatusBadge, type StatusVariant, StepSection, timeWindows, type TimeWindow, timeWindowWords, useCompact, useDevice, useListNavigation, useNow, useLatest, messageOr, messageOr as errorMessage, noticeFrom, noticeOf, useAsyncAction, useNarrow, useRailMemory, useScrollReset, type StickyTop, useStickyTop, useTheme, } from "../../ui/src/index.js";
+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, type IconButtonVariants, type TextButtonVariants, type InputVariants, type ChipVariants, type SectionLabelVariants, type ButtonTier, type ButtonTone, Code, CodeField, ConfirmDialog, ContextMenu, OverflowActions, ActionSheet, type ActionItem, CopyButton, AddressField, StatusTally, type TallyItem, DagEditor, DagGraph, type DagEdge, type DagNode, DiffStat, DisclosureRow, FilterBar, Icon, type IconName, ImageView, InfoDialog, InfoHint, InfoTable, type FileFormat, formatOf, 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, RepoPicker, type RepoPickerAll, RepoRail, type RepoRailAll, type RepoRailGroup, type RepoRailRow, ProseField, ResizeSeam, ResponsiveOverlay, Row, RowGroup, SearchBar, SegmentedControl, seriesColor, sinceOf, useLoadingReveal, SkeletonRows, SkeletonSnapshot, vSkeletonSource, SplitView, StatStrip, StatusBadge, type StatusVariant, StepSection, timeWindows, type TimeWindow, timeWindowWords, useCompact, useDevice, useListNavigation, useNow, useLatest, messageOr, messageOr as errorMessage, noticeFrom, noticeOf, useAsyncAction, useNarrow, useRailMemory, useScrollReset, type StickyTop, useStickyTop, useTheme, } from "../../ui/src/index.js";
 export { formatBytes, formatClock, formatCompact, formatCount, formatDate, formatDateLong, formatDateTime, formatDayMonth, formatDayMonthTime, formatDuration, formatElapsed, formatMoney, formatPercent, formatTime, formatTimestamp, formatTokens, formatWeekdayTime, formatWhen, freshness, timeAgo, } from "./format.js";
 export { type DiffMark, diffMark, type Signal, type TintWeight, type Tone, toneDot, toneFill, toneHover, toneInk, tonePlate, toneRim, toneTint, toneWash, } from "./tone.js";
 export { diffSequence, pairEdits, similarity, wordDiff } from "./diff.js";

package/dist/types/ui/src/components/feedback/InfoHint.vue.d.ts

@@ -2,9 +2,11 @@ type __VLS_Props = {
     label: string;
     text?: string;
 };
-declare var __VLS_12: {};
+declare var __VLS_1: {}, __VLS_14: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_12) => any;
+    trigger?: (props: typeof __VLS_1) => any;
+} & {
+    default?: (props: typeof __VLS_14) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/types/ui/src/components/feedback/changeStatus.d.ts

@@ -1,4 +1,4 @@
-import type { ChangeStatus } from "@intentic/sandbox-contract";
+import type { ChangeStatus } from "@intentic/sandbox-contract/schemas/git/git";
 export type { ChangeStatus };
 export declare const STATUS_LETTER: Record<ChangeStatus, string>;
 export declare const STATUS_CLASS: Record<ChangeStatus, string>;

package/dist/types/ui/src/components/layout/RepoRail.vue.d.ts

@@ -0,0 +1,17 @@
+import type { RepoRailAll, RepoRailGroup } from "./repoRail.js";
+type __VLS_Props = {
+    groups: readonly RepoRailGroup[];
+    all: RepoRailAll;
+    memory: string;
+};
+type __VLS_ModelProps = {
+    modelValue?: string | undefined;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string | undefined) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/ui/src/components/layout/repoRail.d.ts

@@ -0,0 +1,22 @@
+import type { IconName } from "../../icons/iconSets.js";
+import type { TooltipValue } from "../../lib/tooltip.js";
+export interface RepoRailRow {
+    readonly value: string;
+    readonly label: string;
+    readonly icon: IconName;
+    readonly meta: string;
+    readonly tone?: string;
+    readonly tooltip?: TooltipValue;
+    readonly mono?: boolean;
+}
+export interface RepoRailGroup {
+    readonly key: string;
+    readonly label?: string;
+    readonly rows: readonly RepoRailRow[];
+}
+export interface RepoRailAll {
+    readonly icon: IconName;
+    readonly meta: string;
+    readonly tone?: string;
+    readonly tooltip?: TooltipValue;
+}

package/dist/types/ui/src/icons/iconSets.d.ts

@@ -301,6 +301,9 @@ export declare const ICONS: {
     play: {
         outline: string;
     };
+    print: {
+        outline: string;
+    };
     plus: {
         outline: string;
     };

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

@@ -60,6 +60,8 @@ export { default as ProgressRing } from "./components/charts/ProgressRing.vue";
 export { default as ProseField } from "./components/forms/ProseField.vue";
 export { default as RepoPicker } from "./components/forms/RepoPicker.vue";
 export { type RepoPickerAll } from "./components/forms/repoPicker.js";
+export { default as RepoRail } from "./components/layout/RepoRail.vue";
+export { type RepoRailAll, type RepoRailGroup, type RepoRailRow } from "./components/layout/repoRail.js";
 export { default as ResizeSeam } from "./components/layout/ResizeSeam.vue";
 export { default as ResponsiveOverlay } from "./components/overlays/ResponsiveOverlay.vue";
 export { default as Row } from "./components/rows/Row.vue";

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

@@ -20,6 +20,7 @@ export declare const formatClock: (at: number) => string;
 export declare const formatWeekdayTime: (at: number) => string;
 export declare const formatDayMonthTime: (at: number) => string;
 export declare const formatWhen: (at: number, now?: number) => string;
+export declare const formatDayHeading: (at: number, now?: number) => string;
 export declare const timeAgo: (at: number, { now, days }?: {
     now?: number;
     days?: boolean;

package/names.mjs

@@ -1,6 +1,9 @@
 // The kit's export names: the single source consumed by the web app's shim generator
-// (_editor/web/scripts/generate-ext-shims.mjs) and hostModules' dev-time coverage assertion. Update alongside
-// src/index.ts; the assertion catches drift on the next dev boot, and extensionUiNames.test.ts fails it in CI.
+// (_editor/web/scripts/generate-ext-shims.mjs), hostModules' dev-time coverage assertion and the loader's check of a
+// bundle's imports (extension-host/bundleLinks.ts). Update alongside src/index.ts; the assertion catches drift on the
+// next dev boot, and extensionUiNames.test.ts fails it in CI. A bundle links these by name, so they are versioned with
+// the extension API: surface.json records them per extensionApiVersion (`uiKitExports`), a new one is a minor, and one
+// leaves only from the deprecated list below, in a major (surface-guard.test.ts).
 export const extensionUiNames = [
     "AgentRunButton",
     "AnchoredOverlay",
@@ -94,6 +97,7 @@ export const extensionUiNames = [
     "ProjectChip",
     "ProseField",
     "RepoPicker",
+    "RepoRail",
     "ResizeSeam",
     "ResponsiveOverlay",
     "Row",
@@ -135,3 +139,22 @@ export const extensionUiNames = [
     "vAction",
     "wordDiff",
 ];
+
+// Names kept only so extensions built against them still link: what to use instead, when it was deprecated, and the
+// first extension API version that may drop it. A name leaves the kit only from this list, and only in a major at or
+// past its floor; the entry stays after it goes, as the record that its going was declared.
+export const extensionUiDeprecated = [
+    {
+        name: "errorMessage",
+        use: "messageOr",
+        deprecated: "2026-10-06",
+        removableIn: "3.0.0",
+    },
+    {
+        // The repository column RepoPicker replaced on 2026-10-12, removed that day with no version moving and restored.
+        name: "RepoRail",
+        use: "RepoPicker",
+        deprecated: "2026-10-15",
+        removableIn: "3.0.0",
+    },
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentic/extension-ui",
-  "version": "1.336.0",
+  "version": "1.338.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",

package/src/index.ts

@@ -126,6 +126,13 @@ export {
     // URL's `?repo=` through `api.route`, left out when the host bound the view to a repository. Never a rail column.
     RepoPicker,
     type RepoPickerAll,
+    // Deprecated (2026-10-15): the repository column `RepoPicker` replaced. It left the kit on 2026-10-12 with no
+    // version moving, and every extension still importing it stopped loading, so it is back for them alone; removable
+    // from extension API 3.0.0 (`extensionUiDeprecated` in names.mjs).
+    RepoRail,
+    type RepoRailAll,
+    type RepoRailGroup,
+    type RepoRailRow,
     // Prose typeset as a document (`ProseField`) and a pane the reader can resize (`ResizeSeam`).
     ProseField,
     ResizeSeam,
@@ -166,7 +173,8 @@ export {
     useLatest,
     // The thrown thing's message, or a fallback when it has none.
     messageOr,
-    // Deprecated: the old name of `messageOr`, kept so extensions built against it still link.
+    // Deprecated (2026-10-06): the old name of `messageOr`, kept so extensions built against it still link; removable
+    // from extension API 3.0.0 (`extensionUiDeprecated` in names.mjs).
     messageOr as errorMessage,
     noticeFrom,
     noticeOf,