@infinia/plugin-ui 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,20 @@
+import type { App } from 'vue';
+import { type InjectionKey } from 'vue';
+import type { FengYuClient } from '@infinia/plugin-sdk';
+/**
+ * Injection key for the per-app {@link FengYuClient}. Plugins call
+ * {@link provideFengYuClient} from their root install and retrieve the client
+ * anywhere in the component tree via {@link useFengYuClient}.
+ */
+export declare const FENGYU_CLIENT_KEY: InjectionKey<FengYuClient>;
+/**
+ * Provide a {@link FengYuClient} instance to an application so any descendant
+ * component can resolve it through {@link useFengYuClient}.
+ */
+export declare function provideFengYuClient(app: App, client: FengYuClient): void;
+/**
+ * Retrieve the {@link FengYuClient} provided at app root. Throws if no client
+ * was provided — this surfaces wiring mistakes early instead of failing later
+ * on the first host round-trip.
+ */
+export declare function useFengYuClient(): FengYuClient;

package/dist/components/FyConfirmDialog.vue.d.ts

@@ -0,0 +1,27 @@
+type __VLS_Props = {
+    modelValue?: boolean;
+    title: string;
+    message?: string;
+    destructive?: boolean;
+    /** Text for the confirm button. Defaults to "Delete" when destructive. */
+    confirmText?: string;
+    /** Text for the cancel button. */
+    cancelText?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    cancel: () => any;
+    "update:modelValue": (value: boolean) => any;
+    confirm: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCancel?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+    onConfirm?: (() => any) | undefined;
+}>, {
+    modelValue: boolean;
+    message: string;
+    destructive: boolean;
+    confirmText: string;
+    cancelText: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FyDirectoryPicker.vue.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SDK-backed directory picker. Delegates to {@link FengYuClient.files.inputDirectory}
+ * {@link FengYuClient.files.workspaceDirectory}, or
+ * {@link FengYuClient.files.outputDirectory} based on the `mode` prop.
+ *
+ * Behavioral contract mirrors {@link FyFilePicker}: cancellation (`null`) emits
+ * `cancel` and no alert; permission denials render {@link FyPermissionNotice}
+ * without auto-retry; other errors render {@link FyErrorState} with retry.
+ * Concurrent clicks are guarded by `loading`.
+ */
+import type { FileRef } from '@infinia/plugin-sdk';
+type __VLS_Props = {
+    /** v-model: the selected directory, or `null` when nothing is chosen. */
+    modelValue?: FileRef | null;
+    /** Which host SDK method to call: input vs. output directory picker. */
+    mode?: 'input' | 'workspace' | 'output';
+    /** Button label. */
+    label?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    error: (error: Error) => any;
+    cancel: () => any;
+    "update:modelValue": (value: FileRef | null) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onError?: ((error: Error) => any) | undefined;
+    onCancel?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: FileRef | null) => any) | undefined;
+}>, {
+    label: string;
+    modelValue: FileRef | null;
+    mode: "input" | "workspace" | "output";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FyEmptyState.vue.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Standard empty state: a status region with an icon and text. Provide the
+ * `action` slot for a primary call-to-action (e.g. "Create").
+ */
+type __VLS_Props = {
+    title?: string;
+    message?: string;
+    /**
+     * Icon to display. Inline SVG path data (a string from `@mdi/js`, e.g.
+     * `mdiFolderOpenOutline`) is preferred — the mdi webfont is not reliably
+     * bundled into plugin iframes. A legacy `mdi-*` name falls back to
+     * `v-icon` and may render as tofu squares.
+     */
+    icon?: string;
+};
+declare var __VLS_11: {};
+type __VLS_Slots = {} & {
+    action?: (props: typeof __VLS_11) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    icon: string;
+    title: string;
+    message: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/FyErrorState.vue.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Standard error state: an alert region with an icon, readable title/message,
+ * and a default retry button that emits `retry`. Provide the `action` slot to
+ * replace the default button with a custom control.
+ */
+type __VLS_Props = {
+    title?: string;
+    message?: string;
+    /** MDI icon name; defaults to an alert outline. */
+    icon?: string;
+};
+declare var __VLS_9: {};
+type __VLS_Slots = {} & {
+    action?: (props: typeof __VLS_9) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    retry: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onRetry?: (() => any) | undefined;
+}>, {
+    icon: string;
+    title: string;
+    message: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/FyFilePicker.vue.d.ts

@@ -0,0 +1,41 @@
+/**
+ * SDK-backed file picker. Wraps {@link FengYuClient.files.open} so a plugin can
+ * request a host file through a single button.
+ *
+ * Behavioral contract:
+ * - Emits `update:modelValue` (the `FileRef`, or `null`) for v-model.
+ * - Cancellation — the host resolving `null` — emits `cancel` and renders NO
+ *   alert region; cancellation is a normal empty result, never an error.
+ * - Rejections whose message indicates a permission denial render
+ *   {@link FyPermissionNotice} and do NOT auto-retry.
+ * - All other rejections render {@link FyErrorState}; its retry action re-runs
+ *   the pick.
+ * - A `loading` guard blocks concurrent picks.
+ */
+import type { FileFilter, FileRef } from '@infinia/plugin-sdk';
+type __VLS_Props = {
+    /** v-model: the selected file, or `null` when nothing is chosen. */
+    modelValue?: FileRef | null;
+    /** Extension allowlist forwarded to the host file dialog. */
+    extensions?: string[];
+    /** Named extension filters forwarded to the host file dialog. */
+    filters?: FileFilter[];
+    /** Button label. */
+    label?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    error: (error: Error) => any;
+    cancel: () => any;
+    "update:modelValue": (value: FileRef | null) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onError?: ((error: Error) => any) | undefined;
+    onCancel?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: FileRef | null) => any) | undefined;
+}>, {
+    label: string;
+    modelValue: FileRef | null;
+    filters: FileFilter[];
+    extensions: string[];
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FyIcon.vue.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Inline-Svg icon renderer for FengYu plugin UIs.
+ *
+ * Plugin UIs run in a sandboxed iframe whose `connect-src` is `none`, and the
+ * Material Design Icons webfont cannot be reliably inlined by the production
+ * build (the `@mdi/font` stylesheet declares two `src:` blocks; only the legacy
+ * `.eot` survives, which modern browsers ignore — so `mdi-*` font glyphs render
+ * as tofu squares). The robust, network-free path is to ship icons as inline
+ * SVG `<path>` data, sourced from `@mdi/js` (a tree-shakeable bundle of path
+ * constants). `FyIcon` renders that data; no font, no fetch, no CSP surface.
+ *
+ * Usage:
+ * ```ts
+ * import { mdiHammerWrench } from '@mdi/js'
+ * <FyIcon :path="mdiHammerWrench" />
+ * ```
+ */
+type __VLS_Props = {
+    /** SVG path `d` data, e.g. `mdiHammerWrench` from `@mdi/js`. Empty renders nothing. */
+    path?: string;
+    /** Icon edge length in px. */
+    size?: number;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    path: string;
+    size: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FyLoadingState.vue.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Standard loading state: a status region with an indeterminate spinner and
+ * optional label. Provide the `action` slot for a primary control (e.g.
+ * "Cancel").
+ */
+type __VLS_Props = {
+    label?: string;
+};
+declare var __VLS_6: {};
+type __VLS_Slots = {} & {
+    action?: (props: typeof __VLS_6) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    label: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/FyNotificationCenter.vue.d.ts

@@ -0,0 +1,6 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {
+    notify: (message: string) => Promise<void>;
+    localMessages: import("vue").Ref<string[], string[]>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FyPageHeader.vue.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Page header: a title, optional description, and an `actions` slot for
+ * toolbar buttons aligned to the trailing edge.
+ */
+type __VLS_Props = {
+    title: string;
+    description?: string;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    actions?: (props: typeof __VLS_1) => 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>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/FyPermissionNotice.vue.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Standard permission-denied notice: an alert region explaining that the user
+ * lacks access, with an optional `action` slot (e.g. "Request access").
+ */
+type __VLS_Props = {
+    title?: string;
+    message?: string;
+    /** MDI icon name; defaults to a lock outline. */
+    icon?: string;
+};
+declare var __VLS_9: {};
+type __VLS_Slots = {} & {
+    action?: (props: typeof __VLS_9) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    icon: string;
+    title: string;
+    message: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/FyPluginShell.vue.d.ts

@@ -0,0 +1,52 @@
+/**
+ * A single navigation entry rendered by {@link FyPluginShell}.
+ *
+ * - `value` identifies the active item and is emitted via `update:modelValue`.
+ * - `icon` is either inline SVG path data (preferred — a string from
+ *   `@mdi/js` beginning with `M`, rendered via {@link FyIcon}) or a legacy
+ *   `mdi-*` webfont name (rendered via `v-icon`; note the webfont is not
+ *   reliably bundled and may show tofu squares, so prefer path data).
+ * - `disabled` items do not emit on click.
+ */
+export interface FyNavItem {
+    value: string;
+    title: string;
+    icon?: string;
+    disabled?: boolean;
+}
+type __VLS_Props = {
+    /**
+     * Shell title shown in the mobile (temporary) app bar. The desktop drawer
+     * shows nav item titles by default (icon + label); the user can collapse it
+     * to an icon-only rail via the toggle at the drawer top.
+     */
+    title?: string;
+    /** Navigation items to render. */
+    items?: FyNavItem[];
+    /** Active item value (v-model). */
+    modelValue?: string;
+    /** Viewport width (px) below which the drawer becomes temporary. */
+    railBreakpoint?: number;
+};
+declare var __VLS_85: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_85) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {
+    title: string;
+    items: FyNavItem[];
+    modelValue: string;
+    railBreakpoint: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/FyStepWizard.vue.d.ts

@@ -0,0 +1,56 @@
+import type { FyWizardSnapshot, FyWizardActionsSlotProps, FyWizardErrorSlotProps, FyWizardLabelsInput, FyWizardStep, FyWizardStepLabelSlotProps, FyWizardStepState, FyWizardSlotActions, FyWizardValidationResult } from '../wizard';
+export interface Props<T = unknown> {
+    steps: FyWizardStep[];
+    modelValue?: string;
+    states?: Record<string, FyWizardStepState>;
+    context?: T;
+    completed?: boolean;
+    snapshot?: FyWizardSnapshot;
+    validateStep?: (step: string, context: T, signal: AbortSignal) => boolean | FyWizardValidationResult | Promise<boolean | FyWizardValidationResult>;
+    resolveNext?: (step: string, context: T) => string | null;
+    invalidateAfter?: (changedStep: string, context: T) => string[];
+    /** @deprecated Use validateStep instead. */
+    canContinue?: (from: string, to: string) => boolean | Promise<boolean>;
+    backText?: string;
+    nextText?: string;
+    finishText?: string;
+    retryText?: string;
+    optionalText?: string;
+    labels?: FyWizardLabelsInput;
+}
+declare const __VLS_export: <TContext = unknown>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<Props<TContext> & {
+        onComplete?: ((snapshot?: FyWizardSnapshot | undefined) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+        onTransition?: ((from: string, to: string) => any) | undefined;
+        "onUpdate:states"?: ((states: Record<string, FyWizardStepState>) => any) | undefined;
+        "onUpdate:completed"?: ((completed: boolean) => any) | undefined;
+        "onValidation-error"?: ((step: string, message?: string | undefined) => any) | undefined;
+        "onRestore-error"?: ((message: string) => any) | undefined;
+        onSnapshot?: ((snapshot: FyWizardSnapshot) => any) | undefined;
+        onBlocked?: ((reason?: unknown) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: {}) => void;
+    attrs: any;
+    slots: {
+        [name: string]: ((props: any) => unknown) | undefined;
+        'step-label'(props: FyWizardStepLabelSlotProps<TContext>): unknown;
+        error(props: FyWizardErrorSlotProps<TContext>): unknown;
+        actions(props: FyWizardActionsSlotProps<TContext>): unknown;
+        complete(props: {
+            actions: FyWizardSlotActions;
+        }): unknown;
+    };
+    emit: ((evt: "complete", snapshot?: FyWizardSnapshot | undefined) => void) & ((evt: "update:modelValue", value: string) => void) & ((evt: "transition", from: string, to: string) => void) & ((evt: "update:states", states: Record<string, FyWizardStepState>) => void) & ((evt: "update:completed", completed: boolean) => void) & ((evt: "validation-error", step: string, message?: string | undefined) => void) & ((evt: "restore-error", message: string) => void) & ((evt: "snapshot", snapshot: FyWizardSnapshot) => void) & ((evt: "blocked", reason?: unknown) => void);
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/components/FyTaskTable.vue.d.ts

@@ -0,0 +1,40 @@
+export interface FyTaskRow {
+    id: string;
+    name: string;
+    status: 'queued' | 'running' | 'success' | 'error' | 'cancelled';
+    detail?: string;
+}
+export type FyTaskStatus = FyTaskRow['status'];
+type __VLS_Props = {
+    tasks: FyTaskRow[];
+    page?: number;
+    itemsPerPage?: number;
+    loading?: boolean;
+    error?: string;
+    headers?: {
+        title: string;
+        key: string;
+        sortable?: boolean;
+        align?: 'start' | 'center' | 'end';
+    }[];
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:page": (value: number) => any;
+    "update:itemsPerPage": (value: number) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:page"?: ((value: number) => any) | undefined;
+    "onUpdate:itemsPerPage"?: ((value: number) => any) | undefined;
+}>, {
+    error: string;
+    loading: boolean;
+    page: number;
+    itemsPerPage: number;
+    headers: {
+        title: string;
+        key: string;
+        sortable?: boolean;
+        align?: "start" | "center" | "end";
+    }[];
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/FyToolbar.vue.d.ts

@@ -0,0 +1,13 @@
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/composables/useFengYuNotify.d.ts

@@ -0,0 +1,17 @@
+import { type Ref } from 'vue';
+import type { FengYuClient } from '@infinia/plugin-sdk';
+/**
+ * Deliver a notification to the host, falling back to a local queue when the
+ * host rejects (returns `false`) or throws. Cancellation/thrown errors are not
+ * propagated: the message is kept locally so the plugin UI can still surface it.
+ */
+export declare function sendFengYuNotification(client: FengYuClient, message: string, local: Ref<string[]>): Promise<void>;
+/**
+ * Notification helper bound to a {@link FengYuClient}. `notify` forwards to the
+ * host and mirrors any rejected/thrown message into `localMessages`, which a
+ * {@link FyNotificationCenter} renders as a fallback snackbar queue.
+ */
+export declare function useFengYuNotify(client: FengYuClient): {
+    notify: (message: string) => Promise<void>;
+    localMessages: Ref<string[]>;
+};

package/dist/composables/useFengYuPick.d.ts

@@ -0,0 +1,48 @@
+import type { FileRef } from '@infinia/plugin-sdk';
+/**
+ * Event emit signature shared by the SDK-backed pickers. Mirrors the
+ * `defineEmits` of {@link FyFilePicker} / {@link FyDirectoryPicker}:
+ * `update:modelValue` (the `FileRef`, or `null`), `cancel`, and `error`.
+ */
+export interface FengYuPickEmit {
+    (event: 'update:modelValue', value: FileRef | null): void;
+    (event: 'cancel'): void;
+    (event: 'error', error: Error): void;
+}
+/**
+ * Options for {@link useFengYuPick}. The composable owns the pick lifecycle
+ * (loading, error/permission routing, emit contract) and delegates the actual
+ * SDK invocation to `request`, so each picker parameterizes only the call.
+ */
+export interface UseFengYuPickOptions {
+    /** Invokes the SDK call and resolves the `FileRef`, or `null` when cancelled. */
+    request: () => Promise<FileRef | null>;
+    /** Emit function for v-model + lifecycle events. */
+    emit: FengYuPickEmit;
+}
+/**
+ * A rejection whose message reads as a permission/access denial. Centralized
+ * here so {@link FyFilePicker} and {@link FyDirectoryPicker} share one heuristic.
+ */
+export declare function isPermissionError(error: unknown): boolean;
+/**
+ * Shared pick lifecycle for the SDK-backed pickers. Owns `loading`,
+ * `errorMessage`, and `permissionDenied`, and implements the behavioral
+ * contract both pickers share:
+ *
+ * - Concurrent clicks are guarded by `loading`.
+ * - The previous error/permission state is cleared before a new request.
+ * - A `null` result is a normal cancellation: emit `update:modelValue(null)` +
+ *   `cancel`, render NO alert.
+ * - A rejection is wrapped as an `Error`, routed to `permissionDenied` (via
+ *   {@link isPermissionError}) or `errorMessage`, and emitted via `error`.
+ *
+ * The component keeps the rendering decision (which notice to show) in its own
+ * template; this composable only surfaces the state.
+ */
+export declare function useFengYuPick(options: UseFengYuPickOptions): {
+    loading: import("vue").Ref<boolean, boolean>;
+    errorMessage: import("vue").Ref<string | null, string | null>;
+    permissionDenied: import("vue").Ref<boolean, boolean>;
+    pick: () => Promise<void>;
+};

package/dist/createFengYuVuetify.d.ts

@@ -0,0 +1,20 @@
+import { createVuetify } from 'vuetify';
+import type { FengYuClient } from '@infinia/plugin-sdk';
+import 'vuetify/styles';
+import '@mdi/font/css/materialdesignicons.css';
+import './styles/codex.css';
+export type FengYuVuetifyOptions = {
+    theme?: string;
+    locale?: string;
+};
+/** Map an Environment.theme value (or option) to the registered Vuetify theme name. */
+export declare function themeName(value?: string): string;
+/** Map an Environment.locale (BCP-47-ish) to a registered Vuetify locale id. */
+export declare function localeName(value?: string): string;
+export declare function createFengYuVuetify(options?: FengYuVuetifyOptions): ReturnType<typeof createVuetify>;
+/**
+ * Connect a {@link FengYuClient} to a Vuetify instance: apply the current host
+ * environment once, then react to `environment` events. Returns the client's
+ * unsubscribe function so the caller can dispose the binding on teardown.
+ */
+export declare function bindFengYuEnvironment(vuetify: ReturnType<typeof createFengYuVuetify>, client: FengYuClient): Promise<() => void>;

package/dist/defaults.d.ts

@@ -0,0 +1,10 @@
+import type { DefaultsInstance } from 'vuetify';
+/**
+ * FengYu Codex global Vuetify defaults.
+ *
+ * A compact, low-elevation, softly-rounded baseline that matches the Codex
+ * desktop look: comfortable-density inputs/buttons, flat cards, dialogs/menus
+ * that float on the smallest elevation needed to read, and `lg`/`xl` rounding.
+ * These are layered on top of the md3 blueprint defaults.
+ */
+export declare const fengyuDefaults: DefaultsInstance;

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @infinia/plugin-ui — Codex-style Vuetify foundation for FengYu generated plugins.
+ *
+ * Public surface:
+ * - {@link createFengYuVuetify}: build a pre-configured Vuetify instance.
+ * - {@link bindFengYuEnvironment}: sync theme/locale from the host SDK.
+ * - {@link provideFengYuClient} / {@link useFengYuClient}: per-app client DI.
+ * - {@link themeName} / {@link localeName}: environment → Vuetify id helpers.
+ * - {@link fengyuCodexLight} / {@link fengyuCodexDark}: theme definitions.
+ * - {@link fengyuDefaults}: global Vuetify defaults.
+ */
+export { createFengYuVuetify, bindFengYuEnvironment, themeName, localeName } from './createFengYuVuetify';
+export type { FengYuVuetifyOptions } from './createFengYuVuetify';
+export { fengyuCodexLight, fengyuCodexDark } from './theme';
+export { fengyuDefaults } from './defaults';
+export { provideFengYuClient, useFengYuClient, FENGYU_CLIENT_KEY } from './client';
+export { default as FyPluginShell } from './components/FyPluginShell.vue';
+export type { FyNavItem } from './components/FyPluginShell.vue';
+export { default as FyIcon } from './components/FyIcon.vue';
+export { default as FyPageHeader } from './components/FyPageHeader.vue';
+export { default as FyToolbar } from './components/FyToolbar.vue';
+export { default as FyEmptyState } from './components/FyEmptyState.vue';
+export { default as FyLoadingState } from './components/FyLoadingState.vue';
+export { default as FyErrorState } from './components/FyErrorState.vue';
+export { default as FyPermissionNotice } from './components/FyPermissionNotice.vue';
+export { default as FyFilePicker } from './components/FyFilePicker.vue';
+export { default as FyDirectoryPicker } from './components/FyDirectoryPicker.vue';
+export { default as FyNotificationCenter } from './components/FyNotificationCenter.vue';
+export { default as FyStepWizard } from './components/FyStepWizard.vue';
+export { FY_WIZARD_SNAPSHOT_VERSION, FY_WIZARD_DEFAULT_LABELS, buildWizardSnapshot, createWizardStates, invalidateWizardStates, normalizeWizardSnapshot, } from './wizard';
+export type { FyWizardSnapshot, FyWizardActionsSlotProps, FyWizardErrorSlotProps, FyWizardLabels, FyWizardLabelsInput, FyWizardSnapshotResult, FyWizardSlotActions, FyWizardStep, FyWizardStepLabelSlotProps, FyWizardStepSlotProps, FyWizardStepState, FyWizardStepStatus, FyWizardStatusLabels, FyWizardValidationResult, } from './wizard';
+export { default as FyConfirmDialog } from './components/FyConfirmDialog.vue';
+export { default as FyTaskTable } from './components/FyTaskTable.vue';
+export type { FyTaskRow, FyTaskStatus } from './components/FyTaskTable.vue';
+export { useFengYuNotify, sendFengYuNotification } from './composables/useFengYuNotify';
+export type { FengYuClient, Environment, Theme, FileRef, FileFilter } from '@infinia/plugin-sdk';