@entropy-softworks/ui 2026.8.35 → 2026.8.37

package/lib/demos/extension-popup.d.ts

@@ -0,0 +1,212 @@
+/**
+ * The Vault browser-extension popup, as a shared component.
+ *
+ * A faithful recreation of `clients/extension` — the real popup's routes,
+ * layout, copy, field labels, sort options and tag/folder structure — running on
+ * sample data that never leaves the device. Interactive: open an item, copy a
+ * field, reveal a TOTP, switch tabs, walk into settings.
+ *
+ * It lives HERE rather than in either consumer because both the marketing site
+ * and the Vault app show it, and two copies of a 1,000-line recreation would
+ * drift the moment the real extension changed. Same reasoning as sharing
+ * `PasswordGenerator` instead of rewriting it per app.
+ *
+ * Two things the website's original did that this deliberately does not:
+ *
+ *  * **No `auto` mode.** That drove a synthetic cursor with `querySelector` and
+ *    `getBoundingClientRect`, which has no meaning on native. It belongs to that
+ *    page's choreography, not to the extension, so the showcase keeps it.
+ *  * **No drag-and-drop in the tags tab.** It used `@dnd-kit`, which is DOM-only.
+ *    The grip handles remain as affordances because removing them would change
+ *    the layout this exists to reproduce, but they do not drag.
+ *
+ * Everything else is the original, moved rather than rewritten.
+ */
+import React from "react";
+import { ScrollView } from "react-native";
+/**
+ * The real popup's frame, in px.
+ *
+ * `HEIGHT` is Chrome's *maximum* for a browser action popup, not a fixed size —
+ * the real popup is as tall as it needs to be, up to this. So a host with less
+ * vertical room may render it shorter (see the `height` prop) without the thing
+ * on screen becoming a lie about what the extension looks like; the item list
+ * scrolls inside, exactly as it does at full height.
+ */
+export declare const EXTENSION_POPUP_WIDTH = 380;
+export declare const EXTENSION_POPUP_HEIGHT = 600;
+/** Below this the chrome crowds out the list and it stops reading as the popup. */
+export declare const EXTENSION_POPUP_MIN_HEIGHT = 320;
+export declare function useInk(): {
+    fg: string;
+    muted: string;
+    bg: string;
+    border: string;
+    secondary: string;
+    danger: string;
+    star: string;
+};
+export declare function vaultVars(dark: boolean): Record<string, string>;
+export interface Account {
+    username: string;
+    password: string;
+    totp_secret?: string;
+    notes?: string;
+}
+export interface Tag {
+    name: string;
+    color: string;
+    icon?: "tag" | "circle" | "star";
+}
+export interface Item {
+    id: string;
+    name: string;
+    url: string;
+    favorite: boolean;
+    tags: Tag[];
+    accounts: Account[];
+    created: string;
+    updated: string;
+}
+export declare const T: {
+    social: Tag;
+    shopping: Tag;
+    finance: Tag;
+    streaming: Tag;
+    gaming: Tag;
+};
+export declare const ITEMS: Item[];
+export declare const SORT_OPTIONS: readonly [{
+    readonly value: "name_asc";
+    readonly label: "Name (A-Z)";
+    readonly cmp: (a: Item, b: Item) => number;
+}, {
+    readonly value: "name_desc";
+    readonly label: "Name (Z-A)";
+    readonly cmp: (a: Item, b: Item) => number;
+}, {
+    readonly value: "updated_newest";
+    readonly label: "Recently updated";
+    readonly cmp: (a: Item, b: Item) => number;
+}, {
+    readonly value: "created_newest";
+    readonly label: "Newest first";
+    readonly cmp: (a: Item, b: Item) => number;
+}, {
+    readonly value: "created_oldest";
+    readonly label: "Oldest first";
+    readonly cmp: (a: Item, b: Item) => number;
+}];
+export declare function host(url: string): string;
+export declare function favicon(url: string): string;
+export declare function ItemIcon({ url, size, radius, }: {
+    url: string;
+    size?: number;
+    radius?: number;
+}): React.JSX.Element;
+export declare function useCopy(): {
+    copied: string | null;
+    copy: (key: string, text: string) => void;
+};
+export declare function totpCode(seed: string, step: number): string;
+export declare function useTotp(secret?: string): {
+    code: string;
+    remaining: number;
+};
+export declare function RingCountdown({ remaining, size, period, color, }: {
+    remaining: number;
+    size?: number;
+    period?: number;
+    color: string;
+}): React.JSX.Element;
+export declare function VaultItemRow({ item, ink, onPress, highlight, }: {
+    item: Item;
+    ink: ReturnType<typeof useInk>;
+    onPress: () => void;
+    highlight?: boolean;
+}): React.JSX.Element;
+export declare function Dropdown({ open, onToggle, label, icon, children, ink, }: {
+    open: boolean;
+    onToggle: () => void;
+    label: string;
+    icon?: React.ReactNode;
+    children: React.ReactNode;
+    ink: ReturnType<typeof useInk>;
+}): React.JSX.Element;
+export declare function VaultList({ ink, onOpen, items, scrollRef, highlightId, }: {
+    ink: ReturnType<typeof useInk>;
+    onOpen: (id: string) => void;
+    items?: Item[];
+    scrollRef?: React.Ref<ScrollView>;
+    highlightId?: string | null;
+}): React.JSX.Element;
+export declare function FieldRow({ label, value, ink, copied, copy, secret, totp, }: {
+    label: string;
+    value: string;
+    ink: ReturnType<typeof useInk>;
+    copied: string | null;
+    copy: (k: string, t: string) => void;
+    secret?: boolean;
+    totp?: ReturnType<typeof useTotp>;
+}): React.JSX.Element;
+export declare function ItemDetail({ item, ink, onBack, onDelete, forceCopiedLabel, scrollRef, }: {
+    item: Item;
+    ink: ReturnType<typeof useInk>;
+    onBack: () => void;
+    onDelete?: () => void;
+    forceCopiedLabel?: string | null;
+    scrollRef?: React.Ref<ScrollView>;
+}): React.JSX.Element | null;
+/**
+ * The mark in the popup header.
+ *
+ * Supplied by the caller rather than loaded from a path. The original pointed
+ * at `/products/vault_light.png`, which only resolves on the marketing site —
+ * a shared package cannot reach into one consumer's public directory. Falls
+ * back to the wordmark so the header is never empty.
+ */
+export declare function VaultMark({ logo }: {
+    logo?: React.ReactNode;
+}): React.JSX.Element;
+export type ExtRoute = {
+    r: "main";
+} | {
+    r: "detail";
+    id: string;
+} | {
+    r: "settings";
+} | {
+    r: "new";
+};
+/**
+ * A parent-driven view of the popup.
+ *
+ * Lets a scene puppet the popup — scroll the list, highlight a row, open it,
+ * show a field as copied — while the popup keeps owning how any of that looks.
+ * All of it is RN-safe, which is why it survived the move.
+ *
+ * What did NOT survive is the original's self-driving `auto` mode: it steered a
+ * synthetic cursor with `querySelector` and `getBoundingClientRect`, which have
+ * no meaning on native. A scene that wants that keeps its own cursor and drives
+ * this controller instead.
+ */
+export interface ExtensionPopupController {
+    route: ExtRoute;
+    highlightId: string | null;
+    autoCopied: string | null;
+    listScrollRef: React.Ref<ScrollView>;
+    detailScrollRef: React.Ref<ScrollView>;
+}
+/**
+ * The browser-extension popup.
+ *
+ * Interactive by default. Pass `external` to have a parent scene drive it.
+ */
+export declare function ExtensionPopup({ logo, external, height, }?: {
+    logo?: React.ReactNode;
+    external?: ExtensionPopupController;
+    /** Frame height. Defaults to the full 600; see `EXTENSION_POPUP_HEIGHT`. */
+    height?: number;
+}): React.JSX.Element;
+export default ExtensionPopup;
+//# sourceMappingURL=extension-popup.d.ts.map

package/lib/demos/extension-popup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-popup.d.ts","sourceRoot":"","sources":["../../src/demos/extension-popup.tsx"],"names":[],"mappings":"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"}