@raclettejs/core 0.1.30 → 0.1.32-nightly

package/services/frontend/src/orchestrator/composables/useExport/types.ts

@@ -0,0 +1,141 @@
+// ─── Core Export Format Interface ────────────────────────────────────────────
+
+/**
+ * Defines a data export format. Implement this to add custom formats.
+ *
+ * @template T - The expected shape of the data (defaults to unknown for safety)
+ *
+ * @example
+ * const xmlFormat: ExportFormat<Record<string, unknown>> = {
+ *   id: 'xml',
+ *   label: 'XML',
+ *   extension: 'xml',
+ *   mimeType: 'application/xml',
+ *   serialize: (data) => toXml(data),
+ * }
+ */
+export interface ExportFormat<T = unknown> {
+  /** Unique identifier used to reference this format in the `formats` prop */
+  id: string
+  /** Display label shown in the format selector tabs */
+  label: string
+  /** File extension appended to the filename on download (without leading dot) */
+  extension: string
+  /** MIME type used for the downloaded Blob */
+  mimeType: string
+  /**
+   * Transform `data` into a string for clipboard copy or file download.
+   * May throw — the component catches all errors and shows them inline.
+   */
+  serialize: (data: T) => string
+}
+
+export interface ExportPayload<TItem = unknown, TMeta = unknown> {
+  items: TItem[]
+  meta?: TMeta
+}
+
+export type ExportDataScope = "combined" | "items" | "meta"
+
+// ─── Built-in Format IDs ──────────────────────────────────────────────────────
+
+export type BuiltinFormatId = "json" | "yaml"
+
+/** A format entry in the `formats` prop: either a builtin ID or a custom format object */
+export type FormatEntry = BuiltinFormatId | ExportFormat
+
+// ─── Component Props ──────────────────────────────────────────────────────────
+
+export interface RacletteExportProps {
+  /**
+   * The data to export. Accepts any value: object, array, string, number, etc.
+   * Each serializer handles edge cases gracefully.
+   */
+  data: ExportPayload
+
+  /**
+   * Base filename for downloads (no extension). Extension is appended automatically.
+   * @default 'export'
+   */
+  filename?: string
+
+  /**
+   * Ordered list of formats to offer. Mix builtin IDs and custom ExportFormat objects.
+   * This single prop controls both inclusion and order.
+   * @default ['json', 'yaml']
+   */
+  formats?: FormatEntry[]
+
+  /**
+   * ID of the format that should be active when the popover opens.
+   * Falls back to the first format in the list if not found.
+   */
+  defaultFormat?: string
+
+  /**
+   * Label for the default trigger button (only used when no default slot is provided).
+   * @default 'Export'
+   */
+  buttonLabel?: string
+
+  /**
+   * Disables the trigger button and prevents the popover from opening.
+   * @default false
+   */
+  disabled?: boolean
+
+  /**
+   * Whether the preview pane starts collapsed.
+   * @default true
+   */
+  previewCollapsed?: boolean
+
+  /**
+   * Shows a scope switch inside the popover to choose whether to export:
+   * - the combined payload object
+   * - only items
+   * - only meta
+   * @default true
+   */
+  showDataScopeSwitch?: boolean
+}
+
+// ─── Component Emits ──────────────────────────────────────────────────────────
+
+export interface ExportSuccessPayload {
+  /** ID of the format that was used */
+  formatId: string
+  /** Whether the user copied or downloaded */
+  action: "copy" | "download"
+}
+
+export interface ExportErrorPayload {
+  /** ID of the format that failed */
+  formatId: string
+  /** Whether the copy or download was attempted */
+  action: "copy" | "download" | "serialize"
+  /** The caught error */
+  error: unknown
+}
+
+export interface RacletteExportEmits {
+  (e: "export-success", payload: ExportSuccessPayload): void
+  (e: "export-error", payload: ExportErrorPayload): void
+}
+
+// ─── Slot Props ───────────────────────────────────────────────────────────────
+
+export interface TriggerSlotProps {
+  /** Opens the export popover */
+  open: () => void
+  /** Whether the popover is currently open */
+  isOpen: boolean
+  /** Mirrors the `disabled` prop */
+  disabled: boolean
+}
+
+// ─── Serialization Result ─────────────────────────────────────────────────────
+
+export type SerializeResult =
+  | { ok: true; value: string }
+  | { ok: false; error: string }

package/services/frontend/src/orchestrator/i18n/de-DE.json

@@ -33,6 +33,30 @@
       "more_soonDescription": "Wir befinden uns noch in der Beta-Phase, aber liefern bereits! Schau dir unsere Roadmap an",
       "roadmap": "Roadmap auf Gitlab"
     },
+    "baseDataTable": {
+      "searchPlaceholder": "{dataName} durchsuchen",
+      "createDataButton": "{dataName} erstellen",
+      "deleteDataTitle": "{dataName} löschen",
+      "restoreDataTitle": "{dataName} widerherstellen",
+      "deleteDataConfirmMessage": "Bist du sicher, dass du {article} {dataName} <strong>{value}</strong> löschen willst?",
+      "deleteDataConfirmButton": "Löschen",
+      "deleteDataConfirmCancel": "Abbrechen"
+    },
+    "dataExporter": {
+      "lines": "Zeilen",
+      "title": "Daten exportieren",
+      "scopeLabel": "Daten",
+      "scopeCombined": "Kombiniert",
+      "scopeItems": "Elemente",
+      "scopeMeta": "Metadaten",
+      "noValidFormats": "Keine gueltigen Formate konfiguriert.",
+      "preview": "Vorschau",
+      "previewTruncatedAt": "Vorschau bei {count} Zeilen abgeschnitten",
+      "copied": "Kopiert!",
+      "copyFailed": "Fehlgeschlagen",
+      "copy": "Kopieren",
+      "download": "Herunterladen"
+    },
     "dataSync": {
       "update": {
         "$docCountOf$docTypeHaveBeenHandled": "{docCount} Dokumente vom Typ {docType} wurden erfolgreich geupdated",
@@ -219,4 +243,5 @@
       "sl-SL": "Slowenisch (Slowenien)"
     }
   }
-}
+}
+

package/services/frontend/src/orchestrator/i18n/en-EU.json

@@ -33,6 +33,30 @@
       "more_soonDescription": "We are still in Beta but on our way to deliver! Checkout our Roadmap",
       "roadmap": "Roadmap on Gitlab"
     },
+    "baseDataTable": {
+      "searchPlaceholder": "Search {dataName}",
+      "createDataButton": "Create {dataName}",
+      "deleteDataTitle": "Delete {dataName}",
+      "restoreDataTitle": "Restore {dataName}",
+      "deleteDataConfirmMessage": "Are you sure you want to delete {article} {dataName} <strong>{value}</strong>?",
+      "deleteDataConfirmButton": "Delete",
+      "deleteDataConfirmCancel": "Cancel"
+    },
+    "dataExporter": {
+      "lines": "Lines",
+      "title": "Export Data",
+      "scopeLabel": "Data",
+      "scopeCombined": "Combined",
+      "scopeItems": "Items",
+      "scopeMeta": "Meta",
+      "noValidFormats": "No valid formats configured.",
+      "preview": "Preview",
+      "previewTruncatedAt": "Preview truncated at {count} lines",
+      "copied": "Copied!",
+      "copyFailed": "Failed",
+      "copy": "Copy",
+      "download": "Download"
+    },
     "dataSync": {
       "update": {
         "$docCountOf$docTypeHaveBeenHandled": "{docCount} documents of type {docType} were successfully updated",
@@ -219,4 +243,5 @@
       "sl-SL": "Slovenian (Slovenia)"
     }
   }
-}
+}
+

package/services/frontend/src/orchestrator/i18n/sk.json

@@ -33,6 +33,30 @@
       "more_soonDescription": "Stále sme v beta verzii, ale pracujeme na tom, aby sme doručili! Pozrite si našu cestovnú mapu",
       "roadmap": "Cestovná mapa na Gitlabe"
     },
+    "baseDataTable": {
+      "searchPlaceholder": "Hľadať {dataName}",
+      "createDataButton": "Vytvoriť {dataName}",
+      "deleteDataTitle": "Odstrániť {dataName}",
+      "restoreDataTitle": "Obnoviť {dataName}",
+      "deleteDataConfirmMessage": "Naozaj chcete odstrániť {article} {dataName} <strong>{value}</strong>?",
+      "deleteDataConfirmButton": "Odstrániť",
+      "deleteDataConfirmCancel": "Zrušiť"
+    },
+    "dataExporter": {
+      "lines": "riadky",
+      "title": "Export údajov",
+      "scopeLabel": "Údaje",
+      "scopeCombined": "Kombinované",
+      "scopeItems": "Položky",
+      "scopeMeta": "Meta",
+      "noValidFormats": "Nie sú nakonfigurované žiadne platné formáty.",
+      "preview": "Náhľad",
+      "previewTruncatedAt": "Náhľad je skrátený na {count} riadkov",
+      "copied": "Skopírované!",
+      "copyFailed": "Zlyhalo",
+      "copy": "Kopírovať",
+      "download": "Stiahnuť"
+    },
     "dataSync": {
       "update": {
         "$docCountOf$docTypeHaveBeenHandled": "{docCount} dokumentov typu {docType} bolo úspešne aktualizovaných",
@@ -219,4 +243,5 @@
       "sl-SL": "Slovinčina (Slovinsko)"
     }
   }
-}
+}
+

package/services/frontend/src/orchestrator/i18n/tl-TL.json

@@ -33,6 +33,20 @@
       "more_soonDescription": "Beta wItaH 'ach wIghoS – Roadmap yIlegh!",
       "roadmap": "GitlabDaq Roadmap"
     },
+    "dataExporter": {
+      "title": "Export Data",
+      "scopeLabel": "Data",
+      "scopeCombined": "Combined",
+      "scopeItems": "Items",
+      "scopeMeta": "Meta",
+      "noValidFormats": "No valid formats configured.",
+      "preview": "Preview",
+      "previewTruncatedAt": "Preview truncated at {count} lines",
+      "copied": "Copied!",
+      "copyFailed": "Failed",
+      "copy": "Copy",
+      "download": "Download"
+    },
     "dataSync": {
       "update": {
         "$docCountOf$docTypeHaveBeenHandled": "{docCount} {docType} puS ghItlhmey Qapla’ vI’taH",

package/services/frontend/src/orchestrator/setup/vuetify.ts

@@ -34,7 +34,6 @@ const initVuetify = (instanceAdapter, dateLocale) => {
     components,
     directives,
     theme: {
-      defaultTheme: "dark",
       themes: {
         dark,
         light,