@spaceinvoices/react-ui 0.4.5 → 0.4.6

package/cli/dist/index.js

@@ -870,7 +870,7 @@ async function list(options = {}) {
 
 // cli/src/index.ts
 var program = new Command();
-program.name("spaceinvoices-ui").description("CLI for adding Space Invoices React UI components to your project").version("0.4.5");
+program.name("spaceinvoices-ui").description("CLI for adding Space Invoices React UI components to your project").version("0.4.6");
 program.option("--local <path>", "Use local registry from specified path (for development)");
 program.command("init").description("Initialize Space Invoices UI in your project").option("-y, --yes", "Skip prompts and use defaults").option("-f, --force", "Overwrite existing configuration").option("--cwd <path>", "Working directory (defaults to current directory)").action(async (options) => {
   const globalOpts = program.opts();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spaceinvoices/react-ui",
   "type": "module",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "private": false,
   "license": "MIT",
   "description": "Space Invoices UI components - copy-paste distribution with CLI support",

package/src/components/advance-invoices/advance-invoices.hooks.ts

@@ -81,8 +81,8 @@ export function setLastUsedFursCombo(entityId: string, combo: FursCombo): void {
 const FINA_ADV_LAST_USED_KEY = "hr:fina:adv:last-used";
 
 export type FinaCombo = {
-  premise_id: string;
-  device_id: string;
+  business_premise_name: string;
+  electronic_device_name: string;
 };
 
 export function getLastUsedFinaCombo(entityId: string): FinaCombo | null {

package/src/components/advance-invoices/create/create-advance-invoice-form.tsx

@@ -21,7 +21,9 @@ import { useEntities } from "@/ui/providers/entities-context";
 import { useFormFooterRegistration } from "@/ui/providers/form-footer-context";
 import {
   DocumentDetailsSection,
+  DocumentFooterField,
   DocumentNoteField,
+  DocumentSignatureField,
   DocumentTaxClauseField,
 } from "../../documents/create/document-details-section";
 import { DocumentItemsSection, type PriceModesMap } from "../../documents/create/document-items-section";
@@ -107,6 +109,7 @@ export default function CreateAdvanceInvoiceForm({
   // Get default note from entity settings (use invoice defaults)
   // Note: Advance invoices don't have payment terms - they are documents requesting payment
   const defaultNote = (activeEntity?.settings as any)?.default_invoice_note || "";
+  const defaultFooter = (activeEntity?.settings as any)?.document_footer || "";
 
   // ============================================================================
   // FURS Settings & Premises
@@ -143,8 +146,8 @@ export default function CreateAdvanceInvoiceForm({
   const hasFinaPremises = activeFinaPremises.length > 0;
 
   // FINA premise/device selection state (no skip - all FINA invoices must be fiscalized)
-  const [selectedFinaPremiseId, setSelectedFinaPremiseId] = useState<string | undefined>();
-  const [selectedFinaDeviceId, setSelectedFinaDeviceId] = useState<string | undefined>();
+  const [selectedFinaBusinessPremiseName, setSelectedFinaBusinessPremiseName] = useState<string | undefined>();
+  const [selectedFinaElectronicDeviceName, setSelectedFinaElectronicDeviceName] = useState<string | undefined>();
 
   // UI-only state (not part of API schema)
   const [markAsPaid, setMarkAsPaid] = useState(true);
@@ -239,22 +242,24 @@ export default function CreateAdvanceInvoiceForm({
 
   // Get active FINA devices for selected premise
   const activeFinaDevices = useMemo(() => {
-    if (!selectedFinaPremiseId) return [];
-    const premise = activeFinaPremises.find((p: any) => p.premise_id === selectedFinaPremiseId);
+    if (!selectedFinaBusinessPremiseName) return [];
+    const premise = activeFinaPremises.find((p: any) => p.business_premise_name === selectedFinaBusinessPremiseName);
     return premise?.Devices?.filter((d: any) => d.is_active) || [];
-  }, [activeFinaPremises, selectedFinaPremiseId]);
+  }, [activeFinaPremises, selectedFinaBusinessPremiseName]);
 
   // Initialize FINA selection from localStorage or first active combo
   useEffect(() => {
-    if (!isFinaEnabled || !hasFinaPremises || selectedFinaPremiseId) return;
+    if (!isFinaEnabled || !hasFinaPremises || selectedFinaBusinessPremiseName) return;
 
     const lastUsed = getLastUsedFinaCombo(entityId);
     if (lastUsed) {
-      const premise = activeFinaPremises.find((p: any) => p.premise_id === lastUsed.premise_id);
-      const device = premise?.Devices?.find((d: any) => d.device_id === lastUsed.device_id && d.is_active);
+      const premise = activeFinaPremises.find((p: any) => p.business_premise_name === lastUsed.business_premise_name);
+      const device = premise?.Devices?.find(
+        (d: any) => d.electronic_device_name === lastUsed.electronic_device_name && d.is_active,
+      );
       if (premise && device) {
-        setSelectedFinaPremiseId(lastUsed.premise_id);
-        setSelectedFinaDeviceId(lastUsed.device_id);
+        setSelectedFinaBusinessPremiseName(lastUsed.business_premise_name);
+        setSelectedFinaElectronicDeviceName(lastUsed.electronic_device_name);
         return;
       }
     }
@@ -262,25 +267,25 @@ export default function CreateAdvanceInvoiceForm({
     const firstPremise = activeFinaPremises[0];
     const firstDevice = firstPremise?.Devices?.find((d: any) => d.is_active);
     if (firstPremise && firstDevice) {
-      setSelectedFinaPremiseId(firstPremise.premise_id);
-      setSelectedFinaDeviceId(firstDevice.device_id);
+      setSelectedFinaBusinessPremiseName(firstPremise.business_premise_name);
+      setSelectedFinaElectronicDeviceName(firstDevice.electronic_device_name);
     }
-  }, [isFinaEnabled, hasFinaPremises, activeFinaPremises, entityId, selectedFinaPremiseId]);
+  }, [isFinaEnabled, hasFinaPremises, activeFinaPremises, entityId, selectedFinaBusinessPremiseName]);
 
   // When FINA premise changes, select first active device
   useEffect(() => {
-    if (!selectedFinaPremiseId) return;
-    const premise = activeFinaPremises.find((p: any) => p.premise_id === selectedFinaPremiseId);
+    if (!selectedFinaBusinessPremiseName) return;
+    const premise = activeFinaPremises.find((p: any) => p.business_premise_name === selectedFinaBusinessPremiseName);
     const firstDevice = premise?.Devices?.find((d: any) => d.is_active);
-    if (firstDevice && selectedFinaDeviceId !== firstDevice.device_id) {
+    if (firstDevice && selectedFinaElectronicDeviceName !== firstDevice.electronic_device_name) {
       const currentDeviceInPremise = premise?.Devices?.find(
-        (d: any) => d.device_id === selectedFinaDeviceId && d.is_active,
+        (d: any) => d.electronic_device_name === selectedFinaElectronicDeviceName && d.is_active,
       );
       if (!currentDeviceInPremise) {
-        setSelectedFinaDeviceId(firstDevice.device_id);
+        setSelectedFinaElectronicDeviceName(firstDevice.electronic_device_name);
       }
     }
-  }, [selectedFinaPremiseId, activeFinaPremises, selectedFinaDeviceId]);
+  }, [selectedFinaBusinessPremiseName, activeFinaPremises, selectedFinaElectronicDeviceName]);
 
   const form = useForm<CreateAdvanceInvoiceFormValues>({
     // Cast resolver to accept extended form type (includes UI-only fields)
@@ -315,8 +320,10 @@ export default function CreateAdvanceInvoiceForm({
             },
           ],
       currency_code: initialValues?.currency_code || activeEntity?.currency_code || "EUR",
+      reference: (initialValues as any)?.reference ?? "",
       note: initialValues?.note ?? defaultNote,
       tax_clause: "",
+      footer: (initialValues as any)?.footer ?? defaultFooter,
     },
   });
 
@@ -339,8 +346,9 @@ export default function CreateAdvanceInvoiceForm({
 
   // FINA selection ready and active checks
   const isFinaSelectionReady =
-    !isFinaEnabled || !hasFinaPremises || (!!selectedFinaPremiseId && !!selectedFinaDeviceId);
-  const isFinaActive = isFinaEnabled && hasFinaPremises && selectedFinaPremiseId && selectedFinaDeviceId;
+    !isFinaEnabled || !hasFinaPremises || (!!selectedFinaBusinessPremiseName && !!selectedFinaElectronicDeviceName);
+  const isFinaActive =
+    isFinaEnabled && hasFinaPremises && selectedFinaBusinessPremiseName && selectedFinaElectronicDeviceName;
 
   // ============================================================================
   // Next Advance Invoice Number Preview
@@ -531,10 +539,10 @@ export default function CreateAdvanceInvoiceForm({
           electronic_device_name: selectedDeviceName,
         });
       }
-      if (isFinaActive && selectedFinaPremiseId && selectedFinaDeviceId) {
+      if (isFinaActive && selectedFinaBusinessPremiseName && selectedFinaElectronicDeviceName) {
         setLastUsedFinaCombo(entityId, {
-          premise_id: selectedFinaPremiseId,
-          device_id: selectedFinaDeviceId,
+          business_premise_name: selectedFinaBusinessPremiseName,
+          electronic_device_name: selectedFinaElectronicDeviceName,
         });
       }
       onSuccess?.(data);
@@ -580,8 +588,16 @@ export default function CreateAdvanceInvoiceForm({
 
       // Build FINA options (skip for drafts; FINA can't be skipped)
       const finaOptions =
-        !isDraft && isFinaEnabled && !isFinaNonDomestic && selectedFinaPremiseId && selectedFinaDeviceId
-          ? { premise_id: selectedFinaPremiseId, device_id: selectedFinaDeviceId, payment_type: paymentTypes[0] }
+        !isDraft &&
+        isFinaEnabled &&
+        !isFinaNonDomestic &&
+        selectedFinaBusinessPremiseName &&
+        selectedFinaElectronicDeviceName
+          ? {
+              business_premise_name: selectedFinaBusinessPremiseName,
+              electronic_device_name: selectedFinaElectronicDeviceName,
+              payment_type: paymentTypes[0],
+            }
           : undefined;
 
       const payload = prepareAdvanceInvoiceSubmission(values, {
@@ -612,8 +628,8 @@ export default function CreateAdvanceInvoiceForm({
       paymentTypes,
       selectedDeviceName,
       selectedPremiseName,
-      selectedFinaPremiseId,
-      selectedFinaDeviceId,
+      selectedFinaBusinessPremiseName,
+      selectedFinaElectronicDeviceName,
       showCustomerForm,
       skipFiscalization,
     ],
@@ -645,12 +661,20 @@ export default function CreateAdvanceInvoiceForm({
     },
   });
 
-  // Set default note from entity settings (advance invoices don't have payment terms)
+  // Set default note, footer, and signature from entity settings (advance invoices don't have payment terms)
   useEffect(() => {
     const entityDefaultNote = (activeEntity?.settings as any)?.default_invoice_note;
     if (entityDefaultNote && !form.getValues("note")) {
       form.setValue("note", entityDefaultNote);
     }
+    const entityDefaultFooter = (activeEntity?.settings as any)?.document_footer;
+    if (entityDefaultFooter && !form.getValues("footer")) {
+      form.setValue("footer", entityDefaultFooter);
+    }
+    const entityDefaultSignature = (activeEntity?.settings as any)?.default_document_signature;
+    if (entityDefaultSignature && !form.getValues("signature")) {
+      form.setValue("signature", entityDefaultSignature);
+    }
   }, [activeEntity, form]);
 
   // Auto-add tax field for tax subject entities
@@ -684,7 +708,9 @@ export default function CreateAdvanceInvoiceForm({
         customer: formValues.customer,
         items: transformedItems,
         currency_code: formValues.currency_code,
+        reference: formValues.reference,
         note: formValues.note,
+        signature: formValues.signature,
       };
       onChange(payload);
     }
@@ -797,12 +823,18 @@ export default function CreateAdvanceInvoiceForm({
             finaInline={
               isFinaEnabled && hasFinaPremises && !isFinaNonDomestic
                 ? {
-                    premises: activeFinaPremises.map((p: any) => ({ id: p.id, premise_id: p.premise_id })),
-                    devices: activeFinaDevices.map((d: any) => ({ id: d.id, device_id: d.device_id })),
-                    selectedPremise: selectedFinaPremiseId,
-                    selectedDevice: selectedFinaDeviceId,
-                    onPremiseChange: setSelectedFinaPremiseId,
-                    onDeviceChange: setSelectedFinaDeviceId,
+                    premises: activeFinaPremises.map((p: any) => ({
+                      id: p.id,
+                      business_premise_name: p.business_premise_name,
+                    })),
+                    devices: activeFinaDevices.map((d: any) => ({
+                      id: d.id,
+                      electronic_device_name: d.electronic_device_name,
+                    })),
+                    selectedPremise: selectedFinaBusinessPremiseName,
+                    selectedDevice: selectedFinaElectronicDeviceName,
+                    onPremiseChange: setSelectedFinaBusinessPremiseName,
+                    onDeviceChange: setSelectedFinaElectronicDeviceName,
                   }
                 : undefined
             }
@@ -864,6 +896,30 @@ export default function CreateAdvanceInvoiceForm({
           isTransactionTypeFetching={isViesFetching}
           isFinaNonDomestic={isFinaNonDomestic}
         />
+
+        <DocumentSignatureField
+          control={form.control}
+          t={t}
+          entity={activeEntity}
+          document={{
+            number: formValues.number,
+            date: formValues.date,
+            currency_code: formValues.currency_code,
+            customer: formValues.customer as any,
+          }}
+        />
+
+        <DocumentFooterField
+          control={form.control}
+          t={t}
+          entity={activeEntity}
+          document={{
+            number: formValues.number,
+            date: formValues.date,
+            currency_code: formValues.currency_code,
+            customer: formValues.customer as any,
+          }}
+        />
       </form>
     </Form>
   );

package/src/components/advance-invoices/create/locales/de.ts

@@ -30,6 +30,9 @@ export default {
   Device: "Gerät",
   "FINA fiscalized invoices always use the current date":
     "FINA-fiskalisierte Dokumente verwenden immer das aktuelle Datum",
+  // Signature field
+  Signature: "Unterschrift",
+  "Add signature text...": "Unterschriftstext hinzufügen...",
   // Separator items
   "Add separator": "Trennzeile hinzufügen",
   "Section header": "Abschnittsüberschrift",
@@ -45,4 +48,6 @@ export default {
     "Diese Rechnung wird nicht fiskalisiert (nicht-inländische Transaktion)",
   "Tax Clause": "Steuerklausel",
   "Add tax clause...": "Steuerklausel hinzufügen...",
+  Footer: "Fußzeile",
+  "Add document footer...": "Dokumentfußzeile hinzufügen...",
 } as const;

package/src/components/advance-invoices/create/locales/es.ts

@@ -30,6 +30,9 @@ export default {
   Device: "Dispositivo",
   "FINA fiscalized invoices always use the current date":
     "Los documentos fiscalizados con FINA siempre usan la fecha actual",
+  // Signature field
+  Signature: "Firma",
+  "Add signature text...": "Añadir texto de firma...",
   // Separator items
   "Add separator": "Añadir separador",
   "Section header": "Encabezado de sección",
@@ -45,4 +48,6 @@ export default {
     "Esta factura no será fiscalizada (transacción no nacional)",
   "Tax Clause": "Cláusula fiscal",
   "Add tax clause...": "Agregar cláusula fiscal...",
+  Footer: "Pie de página",
+  "Add document footer...": "Añadir pie de página del documento...",
 } as const;

package/src/components/advance-invoices/create/locales/fr.ts

@@ -29,6 +29,9 @@ export default {
   Device: "Appareil",
   "FINA fiscalized invoices always use the current date":
     "Les documents fiscalisés FINA utilisent toujours la date actuelle",
+  // Signature field
+  Signature: "Signature",
+  "Add signature text...": "Ajouter un texte de signature...",
   // Separator items
   "Add separator": "Ajouter un séparateur",
   "Section header": "En-tête de section",
@@ -44,4 +47,6 @@ export default {
     "Cette facture ne sera pas fiscalisée (transaction non nationale)",
   "Tax Clause": "Clause fiscale",
   "Add tax clause...": "Ajouter une clause fiscale...",
+  Footer: "Pied de page",
+  "Add document footer...": "Ajouter un pied de page...",
 } as const;

package/src/components/advance-invoices/create/locales/hr.ts

@@ -27,6 +27,9 @@ export default {
   Premise: "Prostor",
   Device: "Uredaj",
   "FINA fiscalized invoices always use the current date": "FINA fiskalizirani dokumenti uvijek koriste trenutni datum",
+  // Signature field
+  Signature: "Potpis",
+  "Add signature text...": "Dodaj tekst potpisa...",
   // Separator items
   "Add separator": "Dodaj separator",
   "Section header": "Naslov odjeljka",
@@ -42,4 +45,6 @@ export default {
     "Ovaj račun neće biti fiskaliziran (nedomaća transakcija)",
   "Tax Clause": "Porezna klauzula",
   "Add tax clause...": "Dodajte poreznu klauzulu...",
+  Footer: "Podnožje",
+  "Add document footer...": "Dodajte podnožje dokumenta...",
 } as const;

package/src/components/advance-invoices/create/locales/it.ts

@@ -30,6 +30,9 @@ export default {
   Device: "Dispositivo",
   "FINA fiscalized invoices always use the current date":
     "I documenti fiscalizzati FINA utilizzano sempre la data corrente",
+  // Signature field
+  Signature: "Firma",
+  "Add signature text...": "Aggiungi testo della firma...",
   // Separator items
   "Add separator": "Aggiungi separatore",
   "Section header": "Intestazione sezione",
@@ -45,4 +48,6 @@ export default {
     "Questa fattura non sarà fiscalizzata (transazione non nazionale)",
   "Tax Clause": "Clausola fiscale",
   "Add tax clause...": "Aggiungi clausola fiscale...",
+  Footer: "Piè di pagina",
+  "Add document footer...": "Aggiungi piè di pagina del documento...",
 } as const;

package/src/components/advance-invoices/create/locales/nl.ts

@@ -29,6 +29,9 @@ export default {
   Device: "Apparaat",
   "FINA fiscalized invoices always use the current date":
     "FINA-gefiscaliseerde documenten gebruiken altijd de huidige datum",
+  // Signature field
+  Signature: "Handtekening",
+  "Add signature text...": "Handtekeningtekst toevoegen...",
   // Separator items
   "Add separator": "Scheidingslijn toevoegen",
   "Section header": "Sectiekop",
@@ -44,4 +47,6 @@ export default {
     "Deze factuur wordt niet gefiscaliseerd (niet-binnenlandse transactie)",
   "Tax Clause": "Belastingclausule",
   "Add tax clause...": "Belastingclausule toevoegen...",
+  Footer: "Voettekst",
+  "Add document footer...": "Documentvoettekst toevoegen...",
 } as const;

package/src/components/advance-invoices/create/locales/pl.ts

@@ -28,6 +28,9 @@ export default {
   Premise: "Lokal",
   Device: "Urządzenie",
   "FINA fiscalized invoices always use the current date": "Dokumenty fiskalizowane FINA zawsze używają bieżącej daty",
+  // Signature field
+  Signature: "Podpis",
+  "Add signature text...": "Dodaj tekst podpisu...",
   // Separator items
   "Add separator": "Dodaj separator",
   "Section header": "Nagłówek sekcji",
@@ -43,4 +46,6 @@ export default {
     "Ta faktura nie będzie fiskalizowana (transakcja niekrajowa)",
   "Tax Clause": "Klauzula podatkowa",
   "Add tax clause...": "Dodaj klauzulę podatkową...",
+  Footer: "Stopka",
+  "Add document footer...": "Dodaj stopkę dokumentu...",
 } as const;

package/src/components/advance-invoices/create/locales/pt.ts

@@ -29,6 +29,9 @@ export default {
   Premise: "Estabelecimento",
   Device: "Dispositivo",
   "FINA fiscalized invoices always use the current date": "Os documentos fiscalizados FINA usam sempre a data atual",
+  // Signature field
+  Signature: "Assinatura",
+  "Add signature text...": "Adicionar texto de assinatura...",
   // Separator items
   "Add separator": "Adicionar separador",
   "Section header": "Cabeçalho da secção",
@@ -44,4 +47,6 @@ export default {
     "Esta fatura não será fiscalizada (transação não nacional)",
   "Tax Clause": "Cláusula fiscal",
   "Add tax clause...": "Adicionar cláusula fiscal...",
+  Footer: "Rodapé",
+  "Add document footer...": "Adicionar rodapé do documento...",
 } as const;

package/src/components/advance-invoices/create/locales/sl.ts

@@ -25,6 +25,9 @@ export default {
   Premise: "Poslovni prostor",
   Device: "Naprava",
   "FINA fiscalized invoices always use the current date": "FINA fiskalizirani dokumenti vedno uporabijo trenutni datum",
+  // Signature field
+  Signature: "Podpis",
+  "Add signature text...": "Dodaj besedilo podpisa...",
   // Separator items
   "Add separator": "Dodaj ločilnik",
   "Section header": "Naslov razdelka",
@@ -40,4 +43,6 @@ export default {
     "Ta račun ne bo fiskaliziran (nedomača transakcija)",
   "Tax Clause": "Davčna klavzula",
   "Add tax clause...": "Dodajte davčno klavzulo...",
+  Footer: "Noga dokumenta",
+  "Add document footer...": "Dodajte nogo dokumenta...",
 } as const;

package/src/components/advance-invoices/create/prepare-advance-invoice-submission.ts

@@ -9,8 +9,8 @@ type FursData = {
 };
 
 type FinaData = {
-  premise_id?: string;
-  device_id?: string;
+  business_premise_name?: string;
+  electronic_device_name?: string;
   payment_type?: string;
 };
 
@@ -71,10 +71,10 @@ export function prepareAdvanceInvoiceSubmission(
   }
 
   // Add FINA data if provided (FINA can't be skipped - all invoices must be fiscalized)
-  if (options.fina?.premise_id && options.fina.device_id) {
+  if (options.fina?.business_premise_name && options.fina.electronic_device_name) {
     (payload as any).fina = {
-      premise_id: options.fina.premise_id,
-      device_id: options.fina.device_id,
+      business_premise_name: options.fina.business_premise_name,
+      electronic_device_name: options.fina.electronic_device_name,
       ...(options.fina.payment_type && { payment_type: options.fina.payment_type }),
     };
   }