@intentic/extension-ui 1.234.0 → 1.236.0

package/dist/index.js

@@ -98,5 +98,7 @@ export const useNarrow = m["useNarrow"];
 export const useNoteDraft = m["useNoteDraft"];
 export const useNow = m["useNow"];
 export const useRailMemory = m["useRailMemory"];
+export const useScrollReset = m["useScrollReset"];
+export const useStickyTop = m["useStickyTop"];
 export const useTheme = m["useTheme"];
 export const vAction = m["vAction"];

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

@@ -1,4 +1,4 @@
-export { AgentRunButton, type AgentRunChoice, type AgentRunPicker, type ModelPicking, useAgentRunPick, 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, 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, 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, useTheme, } from "../../ui/src/index.js";
+export { AgentRunButton, type AgentRunChoice, type AgentRunPicker, type ModelPicking, useAgentRunPick, 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, 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, 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, formatTime, formatTimestamp, formatTokens, formatWeekdayTime, freshness, timeAgo, } from "./format.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";

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

@@ -8,6 +8,7 @@ type __VLS_Props = {
     removing?: boolean;
     error?: string;
     verb?: string;
+    paged?: boolean;
 };
 declare var __VLS_9: {}, __VLS_12: {}, __VLS_20: {}, __VLS_23: {}, __VLS_47: {}, __VLS_65: {}, __VLS_67: {}, __VLS_92: {};
 type __VLS_Slots = {} & {

package/dist/types/ui/src/components/ScrollFrame.vue.d.ts

@@ -3,8 +3,9 @@ type __VLS_Props = {
     description?: string;
     grow?: boolean;
     scroll?: boolean;
+    sticky?: boolean;
 };
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {}, __VLS_9: {}, __VLS_11: {}, __VLS_13: {}, __VLS_15: {}, __VLS_17: {};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {}, __VLS_9: {}, __VLS_11: {}, __VLS_13: {}, __VLS_15: {}, __VLS_17: {}, __VLS_19: {}, __VLS_21: {};
 type __VLS_Slots = {} & {
     lead?: (props: typeof __VLS_1) => any;
 } & {
@@ -20,9 +21,13 @@ type __VLS_Slots = {} & {
 } & {
     strips?: (props: typeof __VLS_13) => any;
 } & {
-    default?: (props: typeof __VLS_15) => any;
+    description?: (props: typeof __VLS_15) => any;
 } & {
-    default?: (props: typeof __VLS_17) => any;
+    meta?: (props: typeof __VLS_17) => any;
+} & {
+    default?: (props: typeof __VLS_19) => any;
+} & {
+    default?: (props: typeof __VLS_21) => 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/SplitView.vue.d.ts

@@ -4,6 +4,7 @@ type __VLS_Props = {
     mobile?: `collapse` | `swap`;
     detailOpen?: boolean;
     scroll?: `panes` | `page`;
+    scrollKey?: unknown;
 };
 declare var __VLS_14: {}, __VLS_17: {}, __VLS_19: {}, __VLS_21: {}, __VLS_23: {}, __VLS_25: {
     compact: boolean;

package/dist/types/ui/src/composables/useScrollReset.d.ts

@@ -0,0 +1,2 @@
+import { type Ref } from "vue";
+export declare function useScrollReset(element: Readonly<Ref<HTMLElement | undefined>>, key: () => unknown): void;

package/dist/types/ui/src/composables/useStickyTop.d.ts

@@ -0,0 +1,6 @@
+import { type ComputedRef, type Ref } from "vue";
+export interface StickyTop {
+    readonly style: ComputedRef<Record<string, string>>;
+    readonly height: ComputedRef<number>;
+}
+export declare function useStickyTop(element: Readonly<Ref<HTMLElement | undefined>>): StickyTop;

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

@@ -73,6 +73,8 @@ export { type IconName } from "./icons/iconSets.js";
 export { useDevice } from "./composables/useDevice.js";
 export { useNarrow } from "./composables/useNarrow.js";
 export { useListNavigation } from "./composables/useListNavigation.js";
+export { useScrollReset } from "./composables/useScrollReset.js";
+export { type StickyTop, useStickyTop } from "./composables/useStickyTop.js";
 export { useRailMemory } from "./composables/useRailMemory.js";
 export { useNow } from "./composables/useNow.js";
 export { useLoadingReveal } from "./composables/loadingReveal.js";

package/names.mjs

@@ -91,6 +91,8 @@ export const extensionUiNames = [
     "useNoteDraft",
     "useNow",
     "useRailMemory",
+    "useScrollReset",
+    "useStickyTop",
     "useTheme",
     "vAction",
 ];

package/package.json

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

@@ -239,6 +239,14 @@ export {
      * tile again, because a tile opens a view at its bare address. Solving that per extension would be three
      * copies of one rule about what a link means versus what a memory is allowed to guess. */
     useRailMemory,
+    /* The other half of `scroll="page"`. A view whose rail SELECTS something (a note, a package page) hands the
+     * page scrollport a position that stops meaning anything the moment the selection moves, and every such
+     * view would otherwise re-derive the same answer: find the shell's scroller, put it back at the top. */
+    useScrollReset,
+    /* And what the next pinned thing under it has to clear, since a page-scrolling view that pins a filter bar
+     * over its content is the shape three of these sections now are. */
+    type StickyTop,
+    useStickyTop,
     useTheme,
 } from "@intentic/ui";
 // Also reachable as `@intentic/extension-ui/format`, see the note there for why an extension's pure logic