@mlightcad/cad-simple-viewer 1.7.3 → 1.7.5

package/lib/ui/AcUiFileOpenPanel.d.ts

@@ -0,0 +1,156 @@
+import { type AcApDataSourceMenuItem } from '../app/dataSource/acapBuildDataSourceMenu';
+import type { AcApDataSource } from '../app/dataSource/AcApDataSource';
+import type { AcApDataSourceAccountProfile } from '../app/dataSource/AcApDataSource';
+import { type AcEdUiTheme } from '../editor/global/AcEdUiTheme';
+/** Width / height of the {@link AcUiFileOpenPanel} source card. */
+export interface AcUiFileOpenPanelCardSize {
+    /** Card width. Number values are pixels. Defaults to `100%`. */
+    width?: number | string;
+    /** Card height. Number values are pixels. Defaults to `150`. */
+    height?: number | string;
+}
+/** Result kinds emitted by {@link AcUiFileOpenPanel}. */
+export type AcUiFileOpenPanelResult = {
+    kind: 'local';
+    file: File;
+} | {
+    kind: 'url';
+    url: string;
+} | {
+    kind: 'data-source';
+    item: AcApDataSourceMenuItem;
+} | {
+    kind: 'new-drawing';
+};
+/**
+ * Options for {@link AcUiFileOpenPanel}.
+ */
+export interface AcUiFileOpenPanelOptions {
+    /** Element that receives the panel root. */
+    host: HTMLElement;
+    /** Accepted extensions for the drop zone / file input. */
+    accept?: string;
+    /** Optional title above the actions. */
+    title?: string;
+    /** Optional subtitle under the title. */
+    subtitle?: string;
+    /**
+     * Isolated card palette (`light` / `dark`), independent of the host app theme.
+     * When omitted, the panel follows {@link resolveUiTheme} from the host / document.
+     */
+    theme?: AcEdUiTheme;
+    /**
+     * Card box size. Numbers are treated as CSS pixels.
+     * Defaults to width `100%` and height `150`.
+     */
+    cardSize?: AcUiFileOpenPanelCardSize;
+    /** When true, URL is available in the source menu. Defaults to true. */
+    showUrl?: boolean;
+    /** When true, shows a New Drawing button. Defaults to false. */
+    showNewDrawing?: boolean;
+    /**
+     * Extra cloud menu items when a source is not yet registered on a manager.
+     * Prefer registering real {@link AcApDataSource} instances and passing
+     * {@link getSources} so hosts stay provider-agnostic.
+     */
+    extraMenuItems?: AcApDataSourceMenuItem[] | (() => AcApDataSourceMenuItem[]);
+    /**
+     * Optional account profile override. Prefer {@link AcApDataSource.getAccountProfile}.
+     */
+    getAccountProfile?: (sourceId: string) => AcApDataSourceAccountProfile | undefined;
+    /**
+     * Registered / landing data sources used to build cloud entries.
+     * Built-in `local` / `url` are filtered out (handled by the panel UI).
+     * Defaults to {@link AcApDocManager.tryGetInstance}`.dataSourceManager.list()`.
+     */
+    getSources?: () => AcApDataSource[];
+    /**
+     * Called when the user picks a local file, URL, cloud action, or new drawing.
+     */
+    onResult?: (result: AcUiFileOpenPanelResult) => void;
+    onLocalFile?: (file: File) => void;
+    onUrl?: (url: string) => void;
+    onDataSourceAction?: (item: AcApDataSourceMenuItem) => void;
+    onNewDrawing?: () => void;
+}
+/**
+ * Framework-free landing panel for opening CAD files.
+ *
+ * Card body swaps by source; bottom chevron opens a source menu.
+ * Pass {@link AcUiFileOpenPanelOptions.theme} for an isolated light/dark
+ * palette, and {@link AcUiFileOpenPanelOptions.cardSize} for width/height.
+ */
+export declare class AcUiFileOpenPanel {
+    static readonly styleId = "ml-ui-file-open-panel-styles-v3";
+    private readonly options;
+    private readonly root;
+    private readonly card;
+    private readonly contentEl;
+    private readonly footerBtn;
+    private readonly footerLabel;
+    private readonly footerChevron;
+    private readonly menuEl;
+    private readonly urlInput;
+    private readonly fileInput;
+    private readonly dropzone;
+    private readonly urlRow;
+    private readonly sourceActionsEl;
+    private activeView;
+    private menuOpen;
+    private disposed;
+    private unsubManager;
+    private unsubTheme;
+    private onDocPointerDown;
+    constructor(options: AcUiFileOpenPanelOptions);
+    /** Root element of the panel. */
+    get element(): HTMLDivElement;
+    /** Rebuilds the source menu and active body content. */
+    refreshSourceButtons(): void;
+    /**
+     * Sets an isolated card theme, or `undefined` to follow the host app theme.
+     *
+     * @param theme - `light`, `dark`, or `undefined` to track {@link resolveUiTheme}
+     */
+    setTheme(theme: AcEdUiTheme | undefined): void;
+    /**
+     * Updates the source card width and/or height.
+     *
+     * @param size - Partial size; omitted sides keep their current option value
+     */
+    setCardSize(size: AcUiFileOpenPanelCardSize): void;
+    /** Removes the panel from the host and unsubscribes. */
+    dispose(): void;
+    private applyTheme;
+    private applyCardSize;
+    private syncSourceChrome;
+    private selectSource;
+    /**
+     * When switching to an auth-required cloud source, start sign-in immediately
+     * (separate from pick, so the File Picker popup is not blocked).
+     */
+    private maybeAutoSignIn;
+    private toggleMenu;
+    private openMenu;
+    private closeMenu;
+    private resolveSourceOptions;
+    private resolveSourceLabel;
+    private renderActiveView;
+    private canPickSource;
+    private buildPickMenuItem;
+    private resolveAccountProfile;
+    private initialsFromName;
+    private renderSourceActions;
+    private resolveMenuItems;
+    private resolveSources;
+    private resolveExtraMenuItems;
+    private bindManagerEvents;
+    private submitUrl;
+    private onDrag;
+    private onDrop;
+    private isSupportedFileName;
+    private emitLocal;
+    private emit;
+    private createDivider;
+    static ensureStyles(): void;
+}
+//# sourceMappingURL=AcUiFileOpenPanel.d.ts.map

package/lib/ui/AcUiFileOpenPanel.d.ts.map

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