@brftech/filex-core 0.1.56 → 0.1.61

package/src/styles/variables.css

@@ -1,90 +1,90 @@
-/**
- * CSS variables — theme hooks.
- *
- * Consumer overrides by setting `--fe-*` on a higher scope.
- */
-:root {
-  --fe-bg: #ffffff;
-  --fe-bg-elev: #f7f8fa;
-  --fe-bg-hover: #edf0f5;
-  --fe-bg-selected: #dfe8ff;
-  --fe-border: #e2e6ed;
-  --fe-border-strong: #c7ced9;
-  --fe-text: #1a1e27;
-  --fe-text-muted: #5a6475;
-  --fe-text-on-primary: #ffffff;
-  --fe-primary: #3b82f6;
-  --fe-primary-hover: #2563eb;
-  --fe-danger: #dc2626;
-  --fe-danger-hover: #b91c1c;
-  --fe-shadow: 0 10px 32px rgba(15, 23, 42, 0.14);
-  --fe-shadow-sm: 0 2px 6px rgba(15, 23, 42, 0.08);
-  --fe-radius: 8px;
-  --fe-radius-sm: 4px;
-  --fe-radius-lg: 12px;
-  --fe-font: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
-  --fe-font-mono: ui-monospace, "SF Mono", Consolas, Menlo, monospace;
-  --fe-gap: 12px;
-}
-
-.fe--theme-dark,
-:root[data-theme='dark'] .fe,
-.fe.fe--theme-dark,
-/* Tailwind dark-mode class shipped by the host admin shell —
- * web/src/lib/theme.ts toggles document.documentElement.classList
- * .toggle('dark', dark), so we adopt the same hook here. Without
- * this selector the embedded explorer stayed on the :root light
- * defaults even when the rest of the admin UI flipped dark.
- *
- * The bare `:root.dark` / `.dark` selectors (no `.fe` descendant)
- * also publish the variables at the html-level so non-SFC consumers —
- * the standalone /files/edit Editor.vue route, which doesn't wrap its
- * host div in `.fe` — pick up the dark palette via CSS-variable
- * cascade. v0.1.11 added the bare selectors after operators reported
- * the new tab opening light when the admin panel was dark. */
-:root.dark,
-.dark,
-:root.dark .fe,
-.dark .fe,
-/* Teleported context menu lives outside the `.fe` parent, so we have
- * to apply the same dark-mode variable overrides on its backdrop too —
- * otherwise it stays on the :root light defaults and the menu renders
- * as white-on-white inside dark hosts. */
-.fe-ctx-backdrop--theme-dark,
-.fe-ctx-backdrop--theme-auto[data-prefers-dark='1'] {
-  --fe-bg: #0f1419;
-  --fe-bg-elev: #161c25;
-  --fe-bg-hover: #1f2733;
-  --fe-bg-selected: #23324a;
-  --fe-border: #2a323e;
-  --fe-border-strong: #3a4453;
-  --fe-text: #e5e9f0;
-  --fe-text-muted: #8b95a7;
-  --fe-primary: #60a5fa;
-  --fe-primary-hover: #3b82f6;
-  --fe-danger: #f87171;
-  --fe-danger-hover: #ef4444;
-  --fe-shadow: 0 12px 32px rgba(0, 0, 0, 0.45);
-  --fe-shadow-sm: 0 2px 6px rgba(0, 0, 0, 0.25);
-}
-
-@media (prefers-color-scheme: dark) {
-  .fe:not(.fe--theme-light),
-  /* Same trick for the teleported backdrop in auto mode. */
-  .fe-ctx-backdrop--theme-auto:not(.fe-ctx-backdrop--theme-light) {
-    --fe-bg: #0f1419;
-    --fe-bg-elev: #161c25;
-    --fe-bg-hover: #1f2733;
-    --fe-bg-selected: #23324a;
-    --fe-border: #2a323e;
-    --fe-border-strong: #3a4453;
-    --fe-text: #e5e9f0;
-    --fe-text-muted: #8b95a7;
-    --fe-primary: #60a5fa;
-    --fe-primary-hover: #3b82f6;
-    --fe-danger: #f87171;
-    --fe-danger-hover: #ef4444;
-    --fe-shadow: 0 12px 32px rgba(0, 0, 0, 0.45);
-    --fe-shadow-sm: 0 2px 6px rgba(0, 0, 0, 0.25);
-  }
-}
+/**
+ * CSS variables — theme hooks.
+ *
+ * Consumer overrides by setting `--fe-*` on a higher scope.
+ */
+:root {
+  --fe-bg: #ffffff;
+  --fe-bg-elev: #f7f8fa;
+  --fe-bg-hover: #edf0f5;
+  --fe-bg-selected: #dfe8ff;
+  --fe-border: #e2e6ed;
+  --fe-border-strong: #c7ced9;
+  --fe-text: #1a1e27;
+  --fe-text-muted: #5a6475;
+  --fe-text-on-primary: #ffffff;
+  --fe-primary: #3b82f6;
+  --fe-primary-hover: #2563eb;
+  --fe-danger: #dc2626;
+  --fe-danger-hover: #b91c1c;
+  --fe-shadow: 0 10px 32px rgba(15, 23, 42, 0.14);
+  --fe-shadow-sm: 0 2px 6px rgba(15, 23, 42, 0.08);
+  --fe-radius: 8px;
+  --fe-radius-sm: 4px;
+  --fe-radius-lg: 12px;
+  --fe-font: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  --fe-font-mono: ui-monospace, "SF Mono", Consolas, Menlo, monospace;
+  --fe-gap: 12px;
+}
+
+.fe--theme-dark,
+:root[data-theme='dark'] .fe,
+.fe.fe--theme-dark,
+/* Tailwind dark-mode class shipped by the host admin shell —
+ * web/src/lib/theme.ts toggles document.documentElement.classList
+ * .toggle('dark', dark), so we adopt the same hook here. Without
+ * this selector the embedded explorer stayed on the :root light
+ * defaults even when the rest of the admin UI flipped dark.
+ *
+ * The bare `:root.dark` / `.dark` selectors (no `.fe` descendant)
+ * also publish the variables at the html-level so non-SFC consumers —
+ * the standalone /files/edit Editor.vue route, which doesn't wrap its
+ * host div in `.fe` — pick up the dark palette via CSS-variable
+ * cascade. v0.1.11 added the bare selectors after operators reported
+ * the new tab opening light when the admin panel was dark. */
+:root.dark,
+.dark,
+:root.dark .fe,
+.dark .fe,
+/* Teleported context menu lives outside the `.fe` parent, so we have
+ * to apply the same dark-mode variable overrides on its backdrop too —
+ * otherwise it stays on the :root light defaults and the menu renders
+ * as white-on-white inside dark hosts. */
+.fe-ctx-backdrop--theme-dark,
+.fe-ctx-backdrop--theme-auto[data-prefers-dark='1'] {
+  --fe-bg: #0f1419;
+  --fe-bg-elev: #161c25;
+  --fe-bg-hover: #1f2733;
+  --fe-bg-selected: #23324a;
+  --fe-border: #2a323e;
+  --fe-border-strong: #3a4453;
+  --fe-text: #e5e9f0;
+  --fe-text-muted: #8b95a7;
+  --fe-primary: #60a5fa;
+  --fe-primary-hover: #3b82f6;
+  --fe-danger: #f87171;
+  --fe-danger-hover: #ef4444;
+  --fe-shadow: 0 12px 32px rgba(0, 0, 0, 0.45);
+  --fe-shadow-sm: 0 2px 6px rgba(0, 0, 0, 0.25);
+}
+
+@media (prefers-color-scheme: dark) {
+  .fe:not(.fe--theme-light),
+  /* Same trick for the teleported backdrop in auto mode. */
+  .fe-ctx-backdrop--theme-auto:not(.fe-ctx-backdrop--theme-light) {
+    --fe-bg: #0f1419;
+    --fe-bg-elev: #161c25;
+    --fe-bg-hover: #1f2733;
+    --fe-bg-selected: #23324a;
+    --fe-border: #2a323e;
+    --fe-border-strong: #3a4453;
+    --fe-text: #e5e9f0;
+    --fe-text-muted: #8b95a7;
+    --fe-primary: #60a5fa;
+    --fe-primary-hover: #3b82f6;
+    --fe-danger: #f87171;
+    --fe-danger-hover: #ef4444;
+    --fe-shadow: 0 12px 32px rgba(0, 0, 0, 0.45);
+    --fe-shadow-sm: 0 2px 6px rgba(0, 0, 0, 0.25);
+  }
+}

package/src/types/FileNode.ts

@@ -1,136 +1,136 @@
-/**
- * FileNode — node shape returned by the manager endpoint.
- *
- * Backend `?q=index` (or `GET /api/files/manager?action=index`) returns:
- *   { adapter, storages, dirname, files: FileNode[] }
- */
-export interface FileNode {
-  /** DB node ID — needed by the per-user meta routes (starred, tags,
-   *  recently-opened). Backend's projectFileNodes() emits it for every
-   *  row; only client-synthesized rows (e.g. multi-storage virtual
-   *  folders) lack one. */
-  id?: number;
-  /** Full adapter-qualified path: `local://receipts/2024/invoice.pdf` */
-  path: string;
-  /** Relative basename: `invoice.pdf` */
-  basename: string;
-  /** Adapter-stripped relative path: `receipts/2024/invoice.pdf` */
-  relativePath?: string;
-  /** `file` or `dir` */
-  type: 'file' | 'dir';
-  /** Extension (lowercased, no dot). Empty string = no extension. */
-  extension?: string;
-  /** Bytes. 0 = directory. */
-  size?: number;
-  /** Unix ms (backend "last_modified"). */
-  last_modified?: number;
-  /** MIME. */
-  mime_type?: string;
-  /** Optional thumbnail URL (backend may inline). */
-  thumb_url?: string | null;
-  /** Visibility: private | public. */
-  visibility?: 'private' | 'public';
-  /** File count for directories. */
-  count?: number;
-  /** Client-side tag (localStorage or backend). */
-  starred?: boolean;
-  /** Hex color tag. */
-  color?: string | null;
-  /** Server-side trash marker. */
-  trashed?: boolean;
-  /** RBAC effective level for the current user on this entry (backend
-   *  projectFileNodes emits it when a storage has RBAC on). '' / undefined =
-   *  ACL not enforced. Used to gate edit/manage affordances client-side. */
-  perm?: 'none' | 'viewer' | 'editor' | 'owner';
-  /** Generic — any additional fields the backend wants to inline. */
-  [k: string]: unknown;
-}
-
-export interface ShareInfo {
-  uuid: string;
-  url: string;
-  password_pin?: string | null;
-  expires_at?: string | null;
-  max_downloads?: number | null;
-  downloads?: number;
-  created_at?: string;
-}
-
-export interface UploadLimits {
-  max_upload_mb: number;
-}
-
-export type ExternalServiceState = 'ok' | 'error' | 'disabled' | 'unknown';
-
-export interface ExternalServiceStatus {
-  enabled: boolean;
-  state: ExternalServiceState;
-  url?: string;
-  last_check?: string;
-  detail?: string;
-}
-
-export interface Capabilities {
-  ffmpeg?: boolean;
-  ghostscript?: boolean;
-  libreoffice?: boolean;
-  onlyoffice_url?: string | null;
-  drawio_url?: string | null;
-  convert_url?: string | null;
-  max_chunk_mb?: number;
-  upload_limit_mb?: number;
-  external?: {
-    onlyoffice?: ExternalServiceStatus;
-    drawio?: ExternalServiceStatus;
-    mermaid?: ExternalServiceStatus;
-  };
-}
-
-/** Single source of truth for "is the IdP/editor/diagram service ready?".
- *  A capability is usable only when both flags say so — `enabled=true` but
- *  `state='error'` means an operator turned it on but a probe just failed,
- *  and we'd rather hide the entry than offer a button that 500s on click.
- */
-export function isExternalUsable(s: ExternalServiceStatus | undefined): boolean {
-  return !!s && s.enabled && s.state === 'ok';
-}
-
-export interface UploadInitResponse {
-  uploadId: string;
-  parts: Array<{ partNumber: number; presignedUrl: string }>;
-  expiresAt: string;
-  s3Key?: string;
-}
-
-export interface UploadFinalizeResponse {
-  s3Key: string;
-  url?: string;
-}
-
-export interface ArchiveEntry {
-  name: string;
-  size: number;
-  isDir: boolean;
-  lastModified?: number;
-}
-
-export type ViewMode = 'list' | 'grid';
-
-export interface ClipboardState {
-  mode: 'cut' | 'copy' | null;
-  items: FileNode[];
-  sourcePath: string | null;
-}
-
-/** A soft-deleted node as returned by the filex trash listing endpoint. */
-export interface TrashEntry {
-  id: number;
-  storage_id: number;
-  storage_name?: string;
-  path: string;
-  name: string;
-  size: number;
-  mime?: string;
-  deleted_at: string;
-  ttl_days?: number | null;
-}
+/**
+ * FileNode — node shape returned by the manager endpoint.
+ *
+ * Backend `?q=index` (or `GET /api/files/manager?action=index`) returns:
+ *   { adapter, storages, dirname, files: FileNode[] }
+ */
+export interface FileNode {
+  /** DB node ID — needed by the per-user meta routes (starred, tags,
+   *  recently-opened). Backend's projectFileNodes() emits it for every
+   *  row; only client-synthesized rows (e.g. multi-storage virtual
+   *  folders) lack one. */
+  id?: number;
+  /** Full adapter-qualified path: `local://receipts/2024/invoice.pdf` */
+  path: string;
+  /** Relative basename: `invoice.pdf` */
+  basename: string;
+  /** Adapter-stripped relative path: `receipts/2024/invoice.pdf` */
+  relativePath?: string;
+  /** `file` or `dir` */
+  type: 'file' | 'dir';
+  /** Extension (lowercased, no dot). Empty string = no extension. */
+  extension?: string;
+  /** Bytes. 0 = directory. */
+  size?: number;
+  /** Unix ms (backend "last_modified"). */
+  last_modified?: number;
+  /** MIME. */
+  mime_type?: string;
+  /** Optional thumbnail URL (backend may inline). */
+  thumb_url?: string | null;
+  /** Visibility: private | public. */
+  visibility?: 'private' | 'public';
+  /** File count for directories. */
+  count?: number;
+  /** Client-side tag (localStorage or backend). */
+  starred?: boolean;
+  /** Hex color tag. */
+  color?: string | null;
+  /** Server-side trash marker. */
+  trashed?: boolean;
+  /** RBAC effective level for the current user on this entry (backend
+   *  projectFileNodes emits it when a storage has RBAC on). '' / undefined =
+   *  ACL not enforced. Used to gate edit/manage affordances client-side. */
+  perm?: 'none' | 'viewer' | 'editor' | 'owner';
+  /** Generic — any additional fields the backend wants to inline. */
+  [k: string]: unknown;
+}
+
+export interface ShareInfo {
+  uuid: string;
+  url: string;
+  password_pin?: string | null;
+  expires_at?: string | null;
+  max_downloads?: number | null;
+  downloads?: number;
+  created_at?: string;
+}
+
+export interface UploadLimits {
+  max_upload_mb: number;
+}
+
+export type ExternalServiceState = 'ok' | 'error' | 'disabled' | 'unknown';
+
+export interface ExternalServiceStatus {
+  enabled: boolean;
+  state: ExternalServiceState;
+  url?: string;
+  last_check?: string;
+  detail?: string;
+}
+
+export interface Capabilities {
+  ffmpeg?: boolean;
+  ghostscript?: boolean;
+  libreoffice?: boolean;
+  onlyoffice_url?: string | null;
+  drawio_url?: string | null;
+  convert_url?: string | null;
+  max_chunk_mb?: number;
+  upload_limit_mb?: number;
+  external?: {
+    onlyoffice?: ExternalServiceStatus;
+    drawio?: ExternalServiceStatus;
+    mermaid?: ExternalServiceStatus;
+  };
+}
+
+/** Single source of truth for "is the IdP/editor/diagram service ready?".
+ *  A capability is usable only when both flags say so — `enabled=true` but
+ *  `state='error'` means an operator turned it on but a probe just failed,
+ *  and we'd rather hide the entry than offer a button that 500s on click.
+ */
+export function isExternalUsable(s: ExternalServiceStatus | undefined): boolean {
+  return !!s && s.enabled && s.state === 'ok';
+}
+
+export interface UploadInitResponse {
+  uploadId: string;
+  parts: Array<{ partNumber: number; presignedUrl: string }>;
+  expiresAt: string;
+  s3Key?: string;
+}
+
+export interface UploadFinalizeResponse {
+  s3Key: string;
+  url?: string;
+}
+
+export interface ArchiveEntry {
+  name: string;
+  size: number;
+  isDir: boolean;
+  lastModified?: number;
+}
+
+export type ViewMode = 'list' | 'grid';
+
+export interface ClipboardState {
+  mode: 'cut' | 'copy' | null;
+  items: FileNode[];
+  sourcePath: string | null;
+}
+
+/** A soft-deleted node as returned by the filex trash listing endpoint. */
+export interface TrashEntry {
+  id: number;
+  storage_id: number;
+  storage_name?: string;
+  path: string;
+  name: string;
+  size: number;
+  mime?: string;
+  deleted_at: string;
+  ttl_days?: number | null;
+}

package/src/types/index.ts

@@ -1,27 +1,27 @@
-/**
- * @brftech/filex-core — public types.
- *
- * Types are split across two files for legacy reasons; this barrel
- * re-exports the lot so consumers only ever need the package root.
- */
-
-export type {
-  ExplorerConfig,
-  ExplorerEmits,
-  AuthConfig,
-  ThemeMode,
-  LocaleCode,
-  EndpointMap,
-} from './ExplorerConfig';
-
-export type {
-  FileNode,
-  ShareInfo,
-  UploadLimits,
-  Capabilities,
-  UploadInitResponse,
-  UploadFinalizeResponse,
-  ArchiveEntry,
-  ViewMode,
-  ClipboardState,
-} from './FileNode';
+/**
+ * @brftech/filex-core — public types.
+ *
+ * Types are split across two files for legacy reasons; this barrel
+ * re-exports the lot so consumers only ever need the package root.
+ */
+
+export type {
+  ExplorerConfig,
+  ExplorerEmits,
+  AuthConfig,
+  ThemeMode,
+  LocaleCode,
+  EndpointMap,
+} from './ExplorerConfig';
+
+export type {
+  FileNode,
+  ShareInfo,
+  UploadLimits,
+  Capabilities,
+  UploadInitResponse,
+  UploadFinalizeResponse,
+  ArchiveEntry,
+  ViewMode,
+  ClipboardState,
+} from './FileNode';

package/src/types/peers.d.ts

@@ -1,45 +1,45 @@
-/**
- * Type shims for peer-style optional dependencies.
- *
- * These libraries are lazy-loaded via dynamic import and listed under
- * `peerDependenciesMeta.optional` (and `optionalDependencies` for
- * convenience). We don't want hard `@types/*` deps just to please the
- * compiler, so we declare them as `any` here. The dynamic import call
- * sites cast through `any` anyway.
- *
- * Keep in sync with packages/webcomponent/src/peers.d.ts and
- * packages/react/src/peers.d.ts — the rolled-up `dist/index.d.ts`
- * forwards these references and vue-tsc walks the type graph in the
- * sibling packages, so the same shims must live there too.
- */
-declare module 'markdown-it';
-declare module 'highlight.js';
-declare module 'monaco-editor';
-declare module '@google/model-viewer';
-declare module 'epubjs';
-declare module 'mermaid';
-declare module 'utif';
-declare module 'ag-psd';
-declare module 'pdfjs-dist';
-declare module 'pdfjs-dist/legacy/build/pdf';
-declare module 'pdfjs-dist/build/pdf.worker.min';
-declare module 'papaparse';
-declare module 'katex';
-
-/**
- * Custom element registered by `@google/model-viewer` — keeps the
- * compiler happy when the SFC template includes `<model-viewer>`.
- */
-declare namespace JSX {
-  interface IntrinsicElements {
-    'model-viewer': {
-      src?: string;
-      alt?: string;
-      'auto-rotate'?: boolean | string;
-      'camera-controls'?: boolean | string;
-      'touch-action'?: string;
-      'shadow-intensity'?: string | number;
-      [key: string]: unknown;
-    };
-  }
-}
+/**
+ * Type shims for peer-style optional dependencies.
+ *
+ * These libraries are lazy-loaded via dynamic import and listed under
+ * `peerDependenciesMeta.optional` (and `optionalDependencies` for
+ * convenience). We don't want hard `@types/*` deps just to please the
+ * compiler, so we declare them as `any` here. The dynamic import call
+ * sites cast through `any` anyway.
+ *
+ * Keep in sync with packages/webcomponent/src/peers.d.ts and
+ * packages/react/src/peers.d.ts — the rolled-up `dist/index.d.ts`
+ * forwards these references and vue-tsc walks the type graph in the
+ * sibling packages, so the same shims must live there too.
+ */
+declare module 'markdown-it';
+declare module 'highlight.js';
+declare module 'monaco-editor';
+declare module '@google/model-viewer';
+declare module 'epubjs';
+declare module 'mermaid';
+declare module 'utif';
+declare module 'ag-psd';
+declare module 'pdfjs-dist';
+declare module 'pdfjs-dist/legacy/build/pdf';
+declare module 'pdfjs-dist/build/pdf.worker.min';
+declare module 'papaparse';
+declare module 'katex';
+
+/**
+ * Custom element registered by `@google/model-viewer` — keeps the
+ * compiler happy when the SFC template includes `<model-viewer>`.
+ */
+declare namespace JSX {
+  interface IntrinsicElements {
+    'model-viewer': {
+      src?: string;
+      alt?: string;
+      'auto-rotate'?: boolean | string;
+      'camera-controls'?: boolean | string;
+      'touch-action'?: string;
+      'shadow-intensity'?: string | number;
+      [key: string]: unknown;
+    };
+  }
+}