@tekkare/romulus 0.1.36 → 0.1.38

package/dist/runtime/utils/export.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Vocabulaire de l'export OIP : ce qu'une page declare, ce que le wizard
+ * (`RmExportPanel`) en fait, ce que les generateurs (`useRmExport`) consomment.
+ *
+ * Un seul contrat pour toutes les apps, parce que l'export est la sortie de
+ * chaque ecran : sans vocabulaire commun, chaque page reecrit sa feuille de
+ * calcul, sa page de garde et son nom de fichier, et deux exports du meme
+ * produit ne se ressemblent plus.
+ *
+ * Le schema de colonne est celui de `write-excel-file` (`column`, `type`,
+ * `format`, `value(row)`) : c'est deja la forme utilisee par les apps, et la
+ * garder evite de traduire les schemas existants. Les autres formats (CSV,
+ * PDF) appellent le meme `value(row)`, donc une colonne se decrit une fois.
+ */
+/** Une colonne de tableau, telle que `write-excel-file` l'attend. */
+export interface RmExportColumn {
+    column: string;
+    type?: unknown;
+    format?: string;
+    width?: number;
+    wrap?: boolean;
+    alignVertical?: string;
+    value: (row: any) => any;
+}
+/** Un onglet du classeur : son nom, ses colonnes, ses lignes. */
+export interface RmExportSheet {
+    name: string;
+    schema: RmExportColumn[];
+    data: any[];
+}
+/** Chiffre cle repris sur la page de garde. */
+export interface RmExportKpi {
+    label: string;
+    value: string | number;
+}
+/** Source citee, avec sa derniere mise a jour. */
+export interface RmExportSource {
+    name: string;
+    date?: string | Date | null;
+    emoji?: string;
+}
+/** Filtre actif, tel qu'il s'ecrit dans le recapitulatif de l'export. */
+export interface RmExportFilter {
+    label: string;
+    value: string;
+}
+/**
+ * Un format d'export.
+ *
+ * Les trois drapeaux disent au wizard quelles etapes ont un sens, plutot que
+ * de lui faire connaitre les formats par leur nom : un PNG n'a ni colonnes ni
+ * mise en page, un CSV n'a pas de graphique. Un format ajoute plus tard
+ * (Parquet, PowerPoint) herite du bon comportement en posant ses drapeaux,
+ * sans toucher au composant.
+ */
+export interface RmExportFormat {
+    key: string;
+    label: string;
+    /** Icone Phosphor, nom PascalCase sans le prefixe `Ph`. */
+    icon: string;
+    color?: string;
+    desc?: string;
+    /** Le format porte des lignes de tableau : plage et colonnes s'appliquent. */
+    tabular?: boolean;
+    /** Le format rend les graphiques. */
+    visual?: boolean;
+    /** Le format est mis en page : le choix A4 s'applique. */
+    paged?: boolean;
+    /** Format annonce mais pas encore livre : la carte reste visible, grisee. */
+    disabled?: boolean;
+    /** Raison affichee sur une carte grisee. */
+    disabledHint?: string;
+}
+/** Nature d'une section : elle decide de quels formats la section releve. */
+export type RmExportSectionKind = 'table' | 'visual' | 'meta';
+/** Section proposee a l'etape « Donnees ». */
+export interface RmExportSection {
+    key: string;
+    label: string;
+    kind: RmExportSectionKind;
+    /** Cochee a l'ouverture. */
+    on?: boolean;
+}
+/** Plage de lignes : filtrees, toute la base, la selection. */
+export interface RmExportRange {
+    key: string;
+    label: string;
+    rows: number;
+}
+/** Option de l'etape « Personnaliser » (logo, sources, ZIP...). */
+export interface RmExportOption {
+    key: string;
+    label: string;
+    on?: boolean;
+    disabled?: boolean;
+}
+/** Mise en page, pour les formats pagines. */
+export interface RmExportLayout {
+    key: string;
+    label: string;
+}
+/** Configuration complete, ce que le wizard emet. */
+export interface RmExportConfig {
+    format: string;
+    range: string;
+    sections: string[];
+    columns: string[];
+    options: string[];
+    fileName: string;
+    layout: string;
+    schedule: 'once' | 'recurring';
+    frequency: string;
+    email: boolean;
+}
+/** Modele pre-rempli propose avant d'ouvrir le wizard. */
+export interface RmExportTemplate {
+    key: string;
+    name: string;
+    meta: string;
+    icon: string;
+    color?: string;
+    config: Partial<RmExportConfig>;
+}
+/** Ligne de l'historique « Exports recents ». */
+export interface RmExportRecent {
+    name: string;
+    format: string;
+    rows?: number;
+    size?: string;
+    /** Date de l'export, ISO ou Date. */
+    at: string | Date;
+}
+/**
+ * Ce que les generateurs consomment. La page fournit le contenu, le wizard
+ * fournit la configuration ; `useRmExport` croise les deux.
+ */
+export interface RmExportPayload {
+    /** Titre du document (page de garde PDF, en-tete du classeur). */
+    title: string;
+    subtitle?: string;
+    kpi?: RmExportKpi[];
+    sources?: RmExportSource[];
+    filters?: RmExportFilter[];
+    sheets: RmExportSheet[];
+    /**
+     * Graphiques a rasteriser ou vectoriser. Les charts Romulus sont rendus par
+     * ECharts en SVG : on recupere le noeud, pas une capture d'ecran.
+     */
+    charts?: {
+        title?: string;
+        el: Element;
+    }[];
+    /** URL a copier pour le format « Permalink ». */
+    permalink?: string;
+    /**
+     * Logo a poser sur la page de garde PDF, en data URL PNG. Le paquet ne
+     * porte pas l'image : chaque app a la sienne dans ses assets, et un
+     * `import` depuis `node_modules` ne la trouverait pas.
+     */
+    logoDataUrl?: string;
+    /** Plafond de lignes par onglet, pour ne pas geler l'onglet du navigateur. */
+    limit?: number;
+}
+/** Extension de fichier par format. */
+export declare const RM_EXPORT_EXTENSIONS: Record<string, string>;
+/**
+ * Catalogue par defaut. Une app peut en retirer, en ajouter, ou en desactiver
+ * un ; l'ordre est celui d'affichage.
+ */
+export declare const RM_EXPORT_FORMATS: RmExportFormat[];
+/** Sections par defaut, dans l'ordre d'affichage. */
+export declare const RM_EXPORT_SECTIONS: RmExportSection[];
+/** Options par defaut de l'etape « Personnaliser ». */
+export declare const RM_EXPORT_OPTIONS: RmExportOption[];
+/** Mises en page par defaut. */
+export declare const RM_EXPORT_LAYOUTS: RmExportLayout[];
+/**
+ * Taille estimee, en ko. Une estimation, pas une mesure : elle sert a dire
+ * « quelques centaines de ko » contre « plusieurs Mo » avant de lancer.
+ */
+export declare function rmExportSizeKb(input: {
+    format: string;
+    rows: number;
+    columns: number;
+    totalColumns: number;
+    sections: number;
+    includesTable: boolean;
+    zip?: boolean;
+}): number;
+/** « ~ 340 ko » · « ~ 1,8 Mo ». */
+export declare function rmExportSize(kb: number): string;
+/** Duree estimee, du meme ordre de precision que la taille. */
+export declare function rmExportDuration(kb: number, rows: number): string;
+/**
+ * Nom de fichier sans extension : minuscules, sans accent, tirets, date du
+ * jour. Un nom stable d'une app a l'autre rend les exports triables dans un
+ * dossier de telechargements.
+ */
+export declare function rmExportFileName(...parts: (string | undefined | null)[]): string;

package/dist/runtime/utils/export.js

@@ -0,0 +1,98 @@
+export const RM_EXPORT_EXTENSIONS = {
+  pdf: "pdf",
+  xlsx: "xlsx",
+  csv: "csv",
+  png: "png",
+  svg: "svg",
+  link: "url"
+};
+export const RM_EXPORT_FORMATS = [
+  {
+    key: "pdf",
+    label: "PDF",
+    icon: "FilePdf",
+    color: "var(--color-danger)",
+    desc: "Rapport mis en page, pr\xEAt \xE0 partager. KPI, graphiques, table, en-t\xEAte OIP Healthcare.",
+    tabular: true,
+    visual: true,
+    paged: true
+  },
+  {
+    key: "xlsx",
+    label: "Excel",
+    icon: "FileXls",
+    color: "var(--color-success)",
+    desc: "Donn\xE9es brutes avec page de garde. Pour analyse en local ou consolidation.",
+    tabular: true,
+    paged: true
+  },
+  {
+    key: "csv",
+    label: "CSV",
+    icon: "FileCsv",
+    color: "var(--text-secondary)",
+    desc: "Donn\xE9es tabulaires. Pour scripts Python ou R, BI, int\xE9gration API.",
+    tabular: true
+  },
+  {
+    key: "png",
+    label: "PNG",
+    icon: "Image",
+    color: "var(--color-info)",
+    desc: "Image des graphiques visibles. Pour slides, captures, presse.",
+    visual: true
+  },
+  {
+    key: "svg",
+    label: "SVG",
+    icon: "VectorThree",
+    color: "var(--color-warning)",
+    desc: "Vectoriel \xE9ditable. Pour Figma ou Illustrator, impression.",
+    visual: true
+  },
+  {
+    key: "link",
+    label: "Permalink",
+    icon: "Link",
+    color: "var(--color-secondary)",
+    desc: "Lien vers cette vue, filtres compris. Lecture seule."
+  }
+];
+export const RM_EXPORT_SECTIONS = [
+  { key: "kpi", label: "Chiffres cl\xE9s", kind: "meta", on: true },
+  { key: "charts", label: "Graphiques", kind: "visual", on: true },
+  { key: "table", label: "Tableau", kind: "table", on: true },
+  { key: "filters", label: "Filtres actifs", kind: "meta", on: true },
+  { key: "sources", label: "Sources et mises \xE0 jour", kind: "meta", on: true }
+];
+export const RM_EXPORT_OPTIONS = [
+  { key: "logo", label: "Logo Tekkare et en-t\xEAte OIP Healthcare", on: true },
+  { key: "sources", label: "Liste des sources cit\xE9es", on: true }
+];
+export const RM_EXPORT_LAYOUTS = [
+  { key: "a4-portrait", label: "A4 portrait" },
+  { key: "a4-landscape", label: "A4 paysage" },
+  { key: "raw", label: "Donn\xE9es brutes" }
+];
+const BASE_KB = { pdf: 280, xlsx: 60, csv: 4, png: 420, svg: 90, link: 0 };
+const BYTES_PER_ROW = { pdf: 3200, xlsx: 1200, csv: 220, png: 0, svg: 0, link: 0 };
+export function rmExportSizeKb(input) {
+  const base = BASE_KB[input.format] ?? 0;
+  const perRow = BYTES_PER_ROW[input.format] ?? 0;
+  const colFactor = input.includesTable ? Math.max(0.3, input.columns / Math.max(1, input.totalColumns)) : 0;
+  const tableKb = input.rows * perRow * colFactor / 1024;
+  const kb = base + tableKb + input.sections * 18;
+  return input.zip ? kb * 0.55 : kb;
+}
+export function rmExportSize(kb) {
+  if (kb < 1024) return `~ ${Math.round(kb)} ko`;
+  return `~ ${(kb / 1024).toFixed(1).replace(".", ",")} Mo`;
+}
+export function rmExportDuration(kb, rows) {
+  return `~ ${Math.max(2, Math.round(kb / 200 + rows / 500))} s`;
+}
+export function rmExportFileName(...parts) {
+  const slug = parts.filter(Boolean).join("-").normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  return `${slug || "export"}-${today}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekkare/romulus",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "Romulus Design System - Nuxt module by Tekkare",
   "license": "MIT",
   "type": "module",
@@ -12,6 +12,10 @@
       "types": "./dist/types.d.ts",
       "import": "./dist/module.mjs",
       "require": "./dist/module.cjs"
+    },
+    "./utils/*": {
+      "types": "./dist/runtime/utils/*.d.ts",
+      "import": "./dist/runtime/utils/*.js"
     }
   },
   "main": "./dist/module.cjs",
@@ -28,7 +32,10 @@
   "dependencies": {
     "@nuxt/kit": "^3.16.0",
     "@phosphor-icons/vue": "^2.2.1",
-    "echarts": "^5.6.0"
+    "echarts": "^5.6.0",
+    "jspdf": "^4.2.0",
+    "jspdf-autotable": "^5.0.7",
+    "write-excel-file": "^1.4.30"
   },
   "devDependencies": {
     "@nuxt/module-builder": "^0.8.4",