@antelopejs/dms-ai 0.1.5 → 0.2.0

package/frontend-vue/app/runtime/header-action.ts

@@ -1,64 +0,0 @@
-import { useDmsState as useState } from "#dms/frontend-module";
-import {
-	HEADER_ACTIONS_STATE_KEY,
-	LAUNCHER_ACTION_ID,
-	LAUNCHER_ICON,
-	LAUNCHER_LABEL,
-	LAUNCHER_ORDER,
-	TOGGLE_SHORTCUT_LABEL_MAC,
-	TOGGLE_SHORTCUT_LABEL_OTHER,
-} from "./constants";
-
-interface UserAgentData {
-	platform?: string;
-}
-
-interface NavigatorUserAgentData {
-	userAgentData?: UserAgentData;
-}
-
-// The shortcut combo accepts meta OR ctrl, so show the modifier each platform
-// actually uses (⌘ on Apple, Ctrl elsewhere).
-function isApplePlatform(): boolean {
-	const nav = globalThis.navigator as
-		| (Navigator & NavigatorUserAgentData)
-		| undefined;
-	if (nav === undefined) return false;
-	const platform = nav.userAgentData?.platform ?? nav.platform ?? "";
-	return /mac|iphone|ipad|ipod/i.test(platform);
-}
-
-function launcherLabel(): string {
-	const shortcut = isApplePlatform()
-		? TOGGLE_SHORTCUT_LABEL_MAC
-		: TOGGLE_SHORTCUT_LABEL_OTHER;
-	return `${LAUNCHER_LABEL} (${shortcut})`;
-}
-
-// Our view of the shared header-action shape the DMS core renders. Declared
-// locally so this layer has no build-time dependency on the core layer; the
-// only contract is the state key and these fields.
-interface HeaderAction {
-	id: string;
-	icon: string;
-	label: string;
-	onSelect: () => void;
-	order?: number;
-}
-
-// Register the assistant launcher in the core's generic header-action registry.
-// Idempotent so a re-running plugin can't add a duplicate button.
-export function registerLauncherAction(onSelect: () => void): void {
-	const actions = useState<HeaderAction[]>(HEADER_ACTIONS_STATE_KEY, () => []);
-	if (actions.value.some((action) => action.id === LAUNCHER_ACTION_ID)) return;
-	actions.value = [
-		...actions.value,
-		{
-			id: LAUNCHER_ACTION_ID,
-			icon: LAUNCHER_ICON,
-			label: launcherLabel(),
-			order: LAUNCHER_ORDER,
-			onSelect,
-		},
-	];
-}

package/frontend-vue/app/runtime/overlay-prefs.ts

@@ -1,89 +0,0 @@
-import {
-	OVERLAY_PREFS_DEBOUNCE_MS,
-	OVERLAY_PREFS_STORAGE_KEY,
-} from "./constants";
-
-export interface OverlayPrefs {
-	width: number;
-	isOpen: boolean;
-}
-
-let pendingTimer: ReturnType<typeof setTimeout> | null = null;
-let pendingPrefs: OverlayPrefs | null = null;
-
-function tryReadStorage(): string | null {
-	try {
-		return globalThis.localStorage.getItem(OVERLAY_PREFS_STORAGE_KEY);
-	} catch {
-		return null;
-	}
-}
-
-function tryWriteStorage(payload: string): void {
-	try {
-		globalThis.localStorage.setItem(OVERLAY_PREFS_STORAGE_KEY, payload);
-	} catch {
-		return;
-	}
-}
-
-function isFiniteNumber(value: unknown): value is number {
-	return typeof value === "number" && Number.isFinite(value);
-}
-
-function isValidPrefs(value: unknown): value is OverlayPrefs {
-	if (value === null || typeof value !== "object") return false;
-	const candidate = value as Record<string, unknown>;
-	if (!isFiniteNumber(candidate.width)) return false;
-	if (typeof candidate.isOpen !== "boolean") return false;
-	return true;
-}
-
-function parsePrefs(raw: string): OverlayPrefs | null {
-	try {
-		const parsed: unknown = JSON.parse(raw);
-		return isValidPrefs(parsed) ? parsed : null;
-	} catch {
-		return null;
-	}
-}
-
-export function readPrefs(): OverlayPrefs | null {
-	const raw = tryReadStorage();
-	if (raw === null) return null;
-	return parsePrefs(raw);
-}
-
-function flushPending(): void {
-	if (pendingPrefs === null) return;
-	tryWriteStorage(JSON.stringify(pendingPrefs));
-	pendingPrefs = null;
-	pendingTimer = null;
-}
-
-export function writePrefsDebounced(prefs: OverlayPrefs): void {
-	pendingPrefs = prefs;
-	if (pendingTimer !== null) clearTimeout(pendingTimer);
-	pendingTimer = setTimeout(flushPending, OVERLAY_PREFS_DEBOUNCE_MS);
-}
-
-export function flushPrefsForTesting(): void {
-	if (pendingTimer !== null) {
-		clearTimeout(pendingTimer);
-		pendingTimer = null;
-	}
-	flushPending();
-}
-
-export function resetPrefsForTesting(): void {
-	if (pendingTimer !== null) {
-		clearTimeout(pendingTimer);
-		pendingTimer = null;
-	}
-	pendingPrefs = null;
-	try {
-		globalThis.localStorage.removeItem(OVERLAY_PREFS_STORAGE_KEY);
-	} catch {
-		return;
-	}
-}

package/frontend-vue/app/runtime/panel-state.ts

@@ -1,88 +0,0 @@
-import { type Ref, readonly, ref } from "vue";
-import {
-	OVERLAY_DEFAULT_WIDTH_PX,
-	OVERLAY_MIN_WIDTH_PX,
-	OVERLAY_OUTSIDE_TOGGLE_SUPPRESS_MS,
-} from "./constants";
-import {
-	type OverlayPrefs,
-	readPrefs,
-	writePrefsDebounced,
-} from "./overlay-prefs";
-
-const MAX_WIDTH_VW_RATIO = 0.94;
-
-/** Whether the chat panel is open and how wide it is, remembered per browser. */
-export interface ChatPanelState {
-	isOpen: Readonly<Ref<boolean>>;
-	width: Readonly<Ref<number>>;
-	/** The keyboard shortcut's toggle: never suppressed. */
-	toggle: () => void;
-	/**
-	 * The header launcher's toggle. It ignores an open request right after an
-	 * outside click closed the panel: the launcher's `click` follows the same
-	 * `pointerdown` that closed it, and would open it again at once.
-	 */
-	toggleFromLauncher: () => void;
-	close: () => void;
-	/** An outside click closed the panel; `timeStamp` is the event's. */
-	closeFromOutside: (timeStamp: number) => void;
-	/** Resizes live, between the minimum width and most of the viewport. */
-	resize: (width: number) => void;
-	/** Remembers the width once a resize is over. */
-	commitWidth: () => void;
-}
-
-function maxWidth(): number {
-	const viewportWidth = globalThis.innerWidth ?? OVERLAY_DEFAULT_WIDTH_PX * 3;
-	return Math.max(
-		OVERLAY_MIN_WIDTH_PX,
-		Math.round(viewportWidth * MAX_WIDTH_VW_RATIO),
-	);
-}
-
-export function clampWidth(width: number): number {
-	return Math.min(Math.max(width, OVERLAY_MIN_WIDTH_PX), maxWidth());
-}
-
-function resolveInitialPrefs(): OverlayPrefs {
-	const stored = readPrefs();
-	if (stored === null)
-		return { width: OVERLAY_DEFAULT_WIDTH_PX, isOpen: false };
-	return { width: clampWidth(stored.width), isOpen: stored.isOpen };
-}
-
-function isRightAfter(timeStamp: number): boolean {
-	return performance.now() - timeStamp < OVERLAY_OUTSIDE_TOGGLE_SUPPRESS_MS;
-}
-
-export function createChatPanelState(): ChatPanelState {
-	const initial = resolveInitialPrefs();
-	const isOpen = ref(initial.isOpen);
-	const width = ref(initial.width);
-	let outsideCloseAt = Number.NEGATIVE_INFINITY;
-	const persist = (): void =>
-		writePrefsDebounced({ width: width.value, isOpen: isOpen.value });
-	const setOpen = (next: boolean): void => {
-		isOpen.value = next;
-		persist();
-	};
-	return {
-		isOpen: readonly(isOpen),
-		width: readonly(width),
-		toggle: () => setOpen(!isOpen.value),
-		toggleFromLauncher: () => {
-			if (!isOpen.value && isRightAfter(outsideCloseAt)) return;
-			setOpen(!isOpen.value);
-		},
-		close: () => setOpen(false),
-		closeFromOutside: (timeStamp) => {
-			outsideCloseAt = timeStamp;
-			setOpen(false);
-		},
-		resize: (next) => {
-			width.value = clampWidth(next);
-		},
-		commitWidth: persist,
-	};
-}

package/frontend-vue/tests/overlay-prefs.test.ts

@@ -1,91 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-import {
-	OVERLAY_PREFS_DEBOUNCE_MS,
-	OVERLAY_PREFS_STORAGE_KEY,
-} from "../app/runtime/constants";
-import {
-	flushPrefsForTesting,
-	type OverlayPrefs,
-	readPrefs,
-	resetPrefsForTesting,
-	writePrefsDebounced,
-} from "../app/runtime/overlay-prefs";
-
-const SAMPLE_PREFS: OverlayPrefs = {
-	width: 400,
-	isOpen: false,
-};
-
-const FIRST_PREFS: OverlayPrefs = {
-	width: 300,
-	isOpen: false,
-};
-
-const SECOND_PREFS: OverlayPrefs = {
-	width: 320,
-	isOpen: false,
-};
-
-const FINAL_PREFS: OverlayPrefs = {
-	width: 360,
-	isOpen: true,
-};
-
-describe("overlay-prefs storage", () => {
-	beforeEach(() => {
-		resetPrefsForTesting();
-	});
-
-	afterEach(() => {
-		resetPrefsForTesting();
-	});
-
-	it("returns null when no prefs are stored", () => {
-		expect(readPrefs()).toBeNull();
-	});
-
-	it("round-trips a prefs object via debounced write then read", () => {
-		writePrefsDebounced(SAMPLE_PREFS);
-		flushPrefsForTesting();
-		expect(readPrefs()).toEqual(SAMPLE_PREFS);
-	});
-
-	it("returns null when the stored payload is malformed JSON", () => {
-		globalThis.localStorage.setItem(OVERLAY_PREFS_STORAGE_KEY, "{not json");
-		expect(readPrefs()).toBeNull();
-	});
-
-	it("returns null when the stored payload is missing fields", () => {
-		globalThis.localStorage.setItem(
-			OVERLAY_PREFS_STORAGE_KEY,
-			JSON.stringify({ x: 0, y: 0 }),
-		);
-		expect(readPrefs()).toBeNull();
-	});
-});
-
-describe("writePrefsDebounced timing", () => {
-	beforeEach(() => {
-		vi.useFakeTimers();
-		resetPrefsForTesting();
-	});
-
-	afterEach(() => {
-		vi.useRealTimers();
-		resetPrefsForTesting();
-	});
-
-	it("does not persist before the debounce window elapses", () => {
-		writePrefsDebounced(FIRST_PREFS);
-		vi.advanceTimersByTime(OVERLAY_PREFS_DEBOUNCE_MS - 1);
-		expect(readPrefs()).toBeNull();
-	});
-
-	it("persists only the last call when invoked rapidly", () => {
-		writePrefsDebounced(FIRST_PREFS);
-		writePrefsDebounced(SECOND_PREFS);
-		writePrefsDebounced(FINAL_PREFS);
-		vi.advanceTimersByTime(OVERLAY_PREFS_DEBOUNCE_MS);
-		expect(readPrefs()).toEqual(FINAL_PREFS);
-	});
-});

package/frontend-vue/tests/panel-state.test.ts

@@ -1,58 +0,0 @@
-import { afterEach, describe, expect, it } from "vitest";
-import {
-	OVERLAY_DEFAULT_WIDTH_PX,
-	OVERLAY_MIN_WIDTH_PX,
-	OVERLAY_OUTSIDE_TOGGLE_SUPPRESS_MS,
-} from "../app/runtime/constants";
-import {
-	flushPrefsForTesting,
-	readPrefs,
-	resetPrefsForTesting,
-} from "../app/runtime/overlay-prefs";
-import { clampWidth, createChatPanelState } from "../app/runtime/panel-state";
-
-afterEach(() => {
-	resetPrefsForTesting();
-});
-
-describe("chat panel state", () => {
-	it("starts closed at the default width, then remembers what the user chose", () => {
-		const panel = createChatPanelState();
-		expect(panel.isOpen.value).toBe(false);
-		expect(panel.width.value).toBe(OVERLAY_DEFAULT_WIDTH_PX);
-		panel.toggle();
-		panel.resize(520);
-		panel.commitWidth();
-		flushPrefsForTesting();
-		expect(readPrefs()).toEqual({ width: 520, isOpen: true });
-		const reloaded = createChatPanelState();
-		expect(reloaded.isOpen.value).toBe(true);
-		expect(reloaded.width.value).toBe(520);
-	});
-
-	it("keeps the width between the minimum and most of the viewport", () => {
-		expect(clampWidth(10)).toBe(OVERLAY_MIN_WIDTH_PX);
-		expect(clampWidth(100_000)).toBeLessThan(globalThis.innerWidth);
-	});
-
-	it("does not let the launcher reopen the panel an outside click just closed", () => {
-		const panel = createChatPanelState();
-		panel.toggle();
-		panel.closeFromOutside(performance.now());
-		panel.toggleFromLauncher();
-		expect(panel.isOpen.value).toBe(false);
-	});
-
-	it("lets the launcher open the panel again a moment later, and the shortcut at once", () => {
-		const panel = createChatPanelState();
-		panel.toggle();
-		panel.closeFromOutside(performance.now());
-		panel.toggle();
-		expect(panel.isOpen.value).toBe(true);
-		panel.closeFromOutside(
-			performance.now() - OVERLAY_OUTSIDE_TOGGLE_SUPPRESS_MS - 1,
-		);
-		panel.toggleFromLauncher();
-		expect(panel.isOpen.value).toBe(true);
-	});
-});