feat: migrate to new tsclass schema

2025-07-28 09:42:43 +00:00
26 changed files with 4915 additions and 4793 deletions
--- a/changelog.md
+++ b/changelog.md
@@ -1,30 +1,5 @@
 # Changelog

-## 2025-12-11 - 2.0.2 - fix(page)
-Use theme variables for page styling, make pagecontainer background theme-aware, and use accent background for footer separator
-
- Extract documentSettings.theme to a local variable in dedocument-page and use safe optional checks when emitting CSS custom properties
- Use theme pageBackground / coverPageBackground values consistently for page background-image fallback logic
- Make pagecontainer background follow the --text-bg-color CSS variable instead of a hard #ffffff color
- Switch footer separator color variable to --color-accent-bg so the footer stripe uses the theme accent background
-
-## 2025-12-10 - 2.0.1 - fix(core)
-Migrate file I/O to @push.rocks/smartfs, adopt TC39 decorators v3 accessor in web components, and update docs/tests
-
- Added dependency @push.rocks/smartfs and replaced usages of @push.rocks/smartfile.fs with the SmartFs class-based API
- Updated test helpers and test code to use SmartFs (SmartFsProviderNode) and new file read/write methods
- Replaced legacy property declarations with TC39 decorators v3 accessor keyword across web components (ts_web/elements/*)
- Replaced synchronous smartfile directory operations with async SmartFs directory.exists/create flow for .nogit
- Updated README and added readme.hints.md with SmartFs usage examples, decorator guidance, and other developer hints
-
-## 2025-12-10 - 2.0.0 - BREAKING CHANGE(build)
-Upgrade dependencies and dev tooling; adjust TypeScript config
-
- Bumped runtime dependencies: @design.estate/*, @push.rocks/*, @git.zone/tsrun (to ^2.0.0), @tsclass/tsclass, puppeteer, @types/node, qrcode types, and others.
- Updated devDependencies: @git.zone/tsbuild, tsbundle, tstest, tswatch to newer releases.
- Removed experimentalDecorators and useDefineForClassFields from tsconfig.json — this may change decorator handling and affect compilation.
- These dependency and config changes may introduce breaking behavior; recommend a major version bump.
-
 ## 2025-01-01 - 1.6.11 - fix(license)
 Update copyright notice in license to reflect new ownership

--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@design.estate/dees-document",
-  "version": "2.0.2",
+  "version": "1.6.11",
  "private": false,
  "description": "A sophisticated framework for dynamically generating and rendering business documents like invoices with modern web technologies, featuring PDF creation, templating, and automation.",
  "main": "dist_ts_web/index.js",
@@ -21,29 +21,29 @@
  "author": "Lossless GmbH",
  "license": "MIT",
  "dependencies": {
-    "@design.estate/dees-catalog": "^3.3.0",
-    "@design.estate/dees-domtools": "^2.3.6",
-    "@design.estate/dees-element": "^2.1.3",
-    "@design.estate/dees-wcctools": "^1.2.1",
-    "@git.zone/tsrun": "^2.0.0",
-    "@push.rocks/smartfile": "^13.1.0",
-    "@push.rocks/smartfs": "^1.2.0",
-    "@push.rocks/smartjson": "^6.0.0",
-    "@push.rocks/smartpath": "^6.0.0",
-    "@push.rocks/smartpdf": "^4.1.1",
+    "@design.estate/dees-catalog": "^1.4.1",
+    "@design.estate/dees-domtools": "^2.3.2",
+    "@design.estate/dees-element": "^2.0.39",
+    "@design.estate/dees-wcctools": "^1.0.90",
+    "@git.zone/tsrun": "^1.3.3",
+    "@push.rocks/smartfile": "^11.2.0",
+    "@push.rocks/smartjson": "^5.0.20",
+    "@push.rocks/smartpath": "^5.0.18",
+    "@push.rocks/smartpdf": "^3.2.2",
    "@push.rocks/smarttime": "^4.1.1",
-    "@tsclass/tsclass": "^9.3.0",
-    "@types/node": "^25.0.0",
-    "@types/qrcode": "^1.5.6",
-    "puppeteer": "^24.32.1",
+    "@tsclass/tsclass": "^8.0.3",
+    "@types/node": "^22.13.13",
+    "@types/qrcode": "^1.5.5",
+    "puppeteer": "^24.4.0",
    "qrcode": "^1.5.4"
  },
  "devDependencies": {
-    "@git.zone/tsbuild": "^3.1.2",
-    "@git.zone/tsbundle": "^2.6.3",
-    "@git.zone/tstest": "^3.1.3",
-    "@git.zone/tswatch": "^2.3.7",
-    "@push.rocks/projectinfo": "^5.0.2"
+    "@git.zone/tsbuild": "^2.3.2",
+    "@git.zone/tsbundle": "^2.2.5",
+    "@git.zone/tstest": "^1.0.96",
+    "@git.zone/tswatch": "^2.1.0",
+    "@push.rocks/projectinfo": "^5.0.2",
+    "@push.rocks/tapbundle": "^5.6.0"
  },
  "files": [
    "ts/**/*",
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
--- a/readme.hints.md
+++ b/readme.hints.md
@@ -1,40 +1 @@
-# Development Hints
-
-## Dependencies (v2.0.0)
-
- Uses `@push.rocks/smartfs` (v1.2.0) for filesystem operations - SmartFs is class-based with fluent API
- Uses `@push.rocks/smartfile` (v13.1.0) - note: v13 removed the `.fs` namespace, use smartfs instead
- Uses `@git.zone/tstest/tapbundle` for tests (NOT @push.rocks/tapbundle)
- Test files must end with `export default tap.start()`
-
-## TC39 Decorators v3
-
-All decorated properties in web components use the `accessor` keyword:
-```typescript
-@property({ type: Object })
-accessor letterData: TInvoice;
-```
-
-## SmartFs Usage
-
-```typescript
-import { SmartFs, SmartFsProviderNode } from '@push.rocks/smartfs';
-const smartfs = new SmartFs(new SmartFsProviderNode());
-
-// Reading files
-await smartfs.file('/path/to/file').encoding('utf8').read();
-
-// Writing files
-await smartfs.file('/path/to/file').write(buffer);
-
-// Directory operations
-await smartfs.directory('/path').exists();
-await smartfs.directory('/path').create();
-```
-
-## Project Structure
-
- `ts/` - Node.js server-side code (PdfService)
- `ts_web/` - Browser web components (Lit-based)
- `ts_shared/` - Shared code (translations, interfaces)
- `test/` - Test files
+ 
--- a/readme.md
+++ b/readme.md
@@ -1,276 +1,199 @@
 # @design.estate/dees-document

-A powerful TypeScript framework for dynamically generating professional business documents like invoices with web components and PDF export capabilities. 🧾
+A comprehensive tool for dynamically generating and rendering business documents like invoices using modern web technologies.

-## Issue Reporting and Security
+## Install

-For reporting bugs, issues, or security vulnerabilities, please visit [community.foss.global/](https://community.foss.global/). This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a [code.foss.global/](https://code.foss.global/) account to submit Pull Requests directly.
-
-## Installation
+To incorporate `@design.estate/dees-document` into your project, execute the following command in your terminal:

 ```shell
-pnpm install @design.estate/dees-document
+npm install @design.estate/dees-document --save
 ```

-## Features
-
- 📄 **PDF Generation** - Server-side PDF creation from structured data using Puppeteer
- 🎨 **Web Components** - Lit-based custom elements for document rendering
- 🌍 **Multi-language Support** - Built-in translation system (EN, DE, ES)
- 📱 **Automatic Pagination** - Smart content overflow handling across pages
- 💳 **QR Payment Codes** - EPC QR codes for SEPA payments
- 🖨️ **Print Mode** - Optimized rendering for both screen and print
- 📐 **A4 Format** - Precise DIN A4 document dimensions
- ✨ **Theming** - Customizable colors, backgrounds, and branding
+This command will install the package and add it to your project's dependencies, thus making all the necessary modules available within your `node_modules` directory.

 ## Usage

-### Server-Side PDF Generation
+The `@design.estate/dees-document` package serves as a robust framework to facilitate the generation of business documents, such as invoices, contracts, and reports. Leveraging modern web technologies, this package integrates seamlessly with TypeScript and ES modules, offering a type-safe environment conducive to efficient, dynamic document creation.
+
+Below, we provide a detailed guide for utilizing this package, from initializing your environment to generating complete PDF documents.
+
+### Setting Up the Environment
+
+Before diving into document creation, ensure your environment is properly configured. Make sure to import necessary dependencies and setup configurations:

 ```typescript
-import { PdfService } from '@design.estate/dees-document';
-import type { TInvoice } from '@tsclass/tsclass/finance';
+import { PdfService, IPdfServiceConstructorOptions } from '@design.estate/dees-document';

-// Initialize the PDF service
-const pdfService = new PdfService({});
-await pdfService.start();
+async function setupPdfService() {
+  const options: IPdfServiceConstructorOptions = {
+    // Configure your options here
+  };

-// Create invoice data
-const invoice: TInvoice = {
-  type: 'invoice',
-  invoiceType: 'debitnote',
-  id: 'INV-2024-001',
-  invoiceId: 'INV-2024-001',
-  date: Date.now(),
-  currency: 'EUR',
-  dueInDays: 30,
-  reverseCharge: false,
+  const pdfService = await PdfService.createAndStart(options);
+  console.log('PDF Service started successfully.');
+  return pdfService;
+}
+```
+
+In this setup snippet, you set up the `PdfService` which is the core component for PDF generation. The configuration options should be adjusted to fit your needs, especially considering options such as file paths, languages, and template directories.
+
+### Creating a Document Template
+
+To create documents, particularly invoices, you'll first need to define a template. This template describes the structure of your document:
+
+```typescript
+import { ILetter } from '@design.estate/dees-document';
+
+const invoiceTemplate: ILetter = {
  from: {
-    name: 'Your Company GmbH',
-    type: 'company',
-    status: 'active',
+    name: 'Your Company Name',
    address: {
-      streetName: 'Business Street',
+      streetName: 'Your Street',
      houseNumber: '123',
-      city: 'Berlin',
-      country: 'Germany',
-      postalCode: '10115',
-    },
-    sepaConnection: {
-      bic: 'DEUTDEFF',
-      iban: 'DE89370400440532013000',
-    },
-    registrationDetails: {
-      vatId: 'DE123456789',
-      registrationName: 'Amtsgericht Berlin',
-      registrationId: 'HRB 12345',
+      city: 'Your City',
+      country: 'Your Country',
+      postalCode: '12345',
    },
+    email: 'your-email@example.com',
+    phone: '123-456-7890',
  },
  to: {
-    name: 'Customer Inc.',
-    type: 'company',
-    status: 'active',
+    name: 'Recipient Company Name',
    address: {
-      streetName: 'Client Avenue',
+      streetName: 'Recipient Street',
      houseNumber: '456',
-      city: 'Munich',
-      country: 'Germany',
-      postalCode: '80331',
+      city: 'Recipient City',
+      country: 'Recipient Country',
+      postalCode: '67890',
    },
-    registrationDetails: {
-      vatId: 'DE987654321',
+    email: 'recipient-email@example.com',
+    phone: '098-765-4321',
+  },
+  content: {
+    invoiceData: {
+      items: [
+        {
+          name: 'Service or Product Name',
+          unitQuantity: 2,
+          unitNetPrice: 100.0,
+          unitType: 'service',
+          vatPercentage: 19,
+          currency: 'EUR',
+        },
+      ],
    },
  },
-  items: [
-    {
-      name: 'Web Development Services',
-      unitQuantity: 40,
-      unitNetPrice: 95,
-      unitType: 'hours',
-      vatPercentage: 19,
-      position: 1,
-    },
-    {
-      name: 'Hosting (Annual)',
-      unitQuantity: 1,
-      unitNetPrice: 299,
-      unitType: 'item',
-      vatPercentage: 19,
-      position: 2,
-    },
-  ],
-  subject: 'Invoice INV-2024-001',
+  subject: 'Invoice for Services Rendered',
+  date: new Date().getTime(),
  versionInfo: {
    type: 'final',
    version: '1.0.0',
  },
 };
-
-// Generate PDF
-const pdfResult = await pdfService.createPdfFromLetterObject({
-  letterData: invoice,
-  documentSettings: {
-    languageCode: 'EN',
-    enableDefaultHeader: true,
-    enableDefaultFooter: true,
-    enableFoldMarks: true,
-    dateStyle: 'long',
-  },
-});
-
-// Save to file
-import { SmartFs, SmartFsProviderNode } from '@push.rocks/smartfs';
-const fs = new SmartFs(new SmartFsProviderNode());
-await fs.file('./invoice.pdf').write(Buffer.from(pdfResult.buffer));
-
-// Don't forget to stop the service when done
-await pdfService.stop();
 ```

-### Document Settings
+The `invoiceTemplate` object utilizes the `ILetter` interface which specifies the structure for invoice data, including sender and recipient details, itemization, and pricing.

-Customize document appearance with `IDocumentSettings`:
+### Generating the Document
+
+Once a template is established, the next step is generating a PDF:

 ```typescript
-const documentSettings = {
-  // Language for translations
-  languageCode: 'DE', // 'EN' | 'DE' | 'ES'
+async function generateInvoice(pdfService: PdfService, invoiceData: ILetter) {
+  const pdfBuffer = await pdfService.createPdfFromLetterObject(invoiceData);
+  console.log('Invoice PDF generated successfully.');

-  // Layout options
-  enableDefaultHeader: true,
-  enableDefaultFooter: true,
-  enableFoldMarks: true,
-  enableTopDraftText: true,
-  enableInvoiceContractRefSection: true,
-
-  // Display options
-  vatGroupPositions: true,
-  dateStyle: 'long', // 'short' | 'medium' | 'long' | 'full'
-
-  // Theming
-  theme: {
-    colorPrimaryForeground: '#ffffff',
-    colorPrimaryBackground: '#e4002b',
-    colorAccentForeground: '#333333',
-    colorAccentBackground: '#f5f5f5',
-    pageBackground: 'url(your-watermark.png)',
-    coverPageBackground: 'url(your-cover.png)',
-  },
-};
+  // Here you could save the PDF to your filesystem, send it via email, etc.
+}
 ```

-### Web Component Usage
+In this function, the `createPdfFromLetterObject` method converts your invoice data into a `Buffer` containing the PDF. This `Buffer` can subsequently be saved as a file or sent over HTTP.

-For browser-based document viewing:
+### Comprehensive Example
+
+Below is an example integrating all previous steps into a single coherent script:

 ```typescript
-import '@design.estate/dees-document/web';
+async function main() {
+  const pdfService = await setupPdfService();
+  const invoiceData: ILetter = {
+    // Populate your invoice object
+  };
+  await generateInvoice(pdfService, invoiceData);
+}

-// In your HTML/Lit template
-html`
-  <dedocument-viewer
-    .letterData=${invoiceData}
-    .documentSettings=${documentSettings}
-  ></dedocument-viewer>
-`;
-
-// Or render the document directly
-html`
-  <dedocument-dedocument
-    .letterData=${invoiceData}
-    .documentSettings=${documentSettings}
-  ></dedocument-dedocument>
-`;
+main().then(() => console.log('Invoice generation process completed.'));
 ```

-### Translation System
+This script encompasses initializing services and generating a PDF in a streamlined, efficient workflow.

-The package includes a translation system for multi-language document generation:
+### Advanced Features
+
+`@design.estate/dees-document` provides several advanced functionalities, enabling rich document creation:
+
+1. **Custom Templates & Styling**
+
+   - Customize the styling through CSS or using inline styles in TypeScript.
+   - Templates can be adjusted to present different document types (e.g., contracts, reports).
+
+2. **Modular Components and Reuse**
+
+   - Utilize modular components to create reusable parts across different documents, enhancing maintainability and reducing redundancy.
+
+3. **Interactive Documents**
+
+   - Integrate interactivities like forms, buttons, and interactive charts within your documents.
+
+4. **Localization Support**
+
+   - Documents can be localized to support multiple languages, enhancing accessibility and usability.
+
+5. **Responsive and Adaptive Designs**
+
+   - Create documents that adjust layout dynamically depending on print or digital medium, maintaining consistency across platforms.
+
+6. **Security Features**
+
+   - Apply digital signatures and encrypt sensitive documents to ensure secure and authentic document distribution.
+
+7. **Complex Business Logic**
+   - Implement complex logic for feature-rich documents such as inventory systems, automatic tax calculations, or real-time pricing adjustments.
+
+### Utilize Translation for Localization
+
+The package offers a translation mechanism to adapt your documents for international clients:

 ```typescript
 import { translate } from '@design.estate/dees-document/shared';

-// Translate document labels
-translate('DE', 'invoice@@totalGross'); // "Gesamtbetrag (Brutto)"
-translate('EN', 'invoice@@totalGross'); // "Total (Gross)"
-translate('ES', 'invoice@@totalGross'); // "Total (Bruto)"
+const languageCode: 'DE' | 'EN' | 'ES' = 'EN'; // Set required language code
+console.log(translate(languageCode, 'invoice', 'Invoice')); // Translated output
 ```

-## Module Exports
+Different language settings can be applied, enabling the seamless presentation of document contents tailored to regional and linguistic preferences.

-The package provides multiple entry points:
+### Conclusion

-```typescript
-// Node.js server-side (PDF generation)
-import { PdfService } from '@design.estate/dees-document';
-import { PdfService } from '@design.estate/dees-document/node';
+The `@design.estate/dees-document` package is a versatile and powerful solution for businesses seeking to automate and streamline their document generation processes using modern web technologies. By integrating seamlessly with TypeScript, it offers robust capabilities for creating complex, customizable, and interactive documents that can meet a variety of business needs.

-// Browser web components
-import '@design.estate/dees-document/web';
-
-// Shared utilities and types
-import { translate, IDocumentSettings } from '@design.estate/dees-document/shared';
-
-// TypeScript interfaces
-import type { IDocumentSettings } from '@design.estate/dees-document/interfaces';
-```
-
-## Document Components
-
-The framework includes these web components:
-
-| Component | Description |
-|-----------|-------------|
-| `<dedocument-dedocument>` | Main document container with pagination |
-| `<dedocument-viewer>` | Document viewer with controls |
-| `<dedocument-page>` | Single A4 page with scaling support |
-| `<dedocument-pageheader>` | Company logo and branding header |
-| `<dedocument-letterheader>` | Sender/recipient addresses |
-| `<dedocument-pagecontent>` | Main content area |
-| `<dedocument-pagefooter>` | Company info and page numbers |
-| `<dedocument-contentinvoice>` | Invoice-specific content layout |
-| `<dedocument-paymentcode>` | EPC QR code for SEPA payments |
-
-## Draft vs Final Documents
-
-Control document version display:
-
-```typescript
-const invoice = {
-  // ... other fields
-  versionInfo: {
-    type: 'draft', // Shows watermark "DRAFT" across pages
-    version: '0.1.0',
-  },
-};
-
-// For final documents
-const invoice = {
-  // ... other fields
-  versionInfo: {
-    type: 'final', // Clean document without watermark
-    version: '1.0.0',
-  },
-};
-```
+From custom templates to localization and advanced security features, this module provides the flexibility and power to create polished and professional documents efficiently. Whether you're generating invoices, contracts, or detailed reports, `@design.estate/dees-document` has the tools to support your enterprise workflows with ease and precision.

 ## License and Legal Information

-This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [LICENSE](./LICENSE) file.
+This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository.

 **Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.

 ### Trademarks

-This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.
-
-Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.

 ### Company Information

-Task Venture Capital GmbH
-Registered at District Court Bremen HRB 35230 HB, Germany
+Task Venture Capital GmbH  
+Registered at District court Bremen HRB 35230 HB, Germany

-For any legal inquiries or further information, please contact us via email at hello@task.vc.
+For any legal inquiries or if you require further information, please contact us via email at hello@task.vc.

 By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.
--- a/test/plugins.ts
+++ b/test/plugins.ts
@@ -1,7 +1,5 @@
 import * as tsclass from '@tsclass/tsclass';
-import { SmartFs, SmartFsProviderNode } from '@push.rocks/smartfs';
+import * as smartfile from '@push.rocks/smartfile';
 import * as path from 'path';

-export const smartfs = new SmartFs(new SmartFsProviderNode());
-
-export { tsclass, path };
+export { tsclass, smartfile, path };
--- a/test/test.ts
+++ b/test/test.ts
@@ -1,7 +1,7 @@
 import * as plugins from "./plugins.js";
 import * as paths from "./paths.js";
 import * as interfaces from "../ts_shared/interfaces/index.js";
-import { expect, tap } from "@git.zone/tstest/tapbundle";
+import { expect, tap } from "@push.rocks/tapbundle";
 import * as deesDocumentServer from "../ts/index.js";

 let testPdfServiceInstance: deesDocumentServer.PdfService;
@@ -99,8 +99,10 @@ tap.test("should create an invoice", async () => {
    const pdfResult = await testPdfServiceInstance.createPdfFromLetterObject(
      optionsArg
    );
-    await plugins.smartfs.file(plugins.path.join(paths.nogitDir, `test-${counter++}.pdf`))
-      .write(Buffer.from(pdfResult.buffer));
+    await plugins.smartfile.memory.toFs(
+      Buffer.from(pdfResult.buffer),
+      plugins.path.join(paths.nogitDir, `test-${counter++}.pdf`)
+    );
  };
  await saveResult({
    letterData: testLetterData,
@@ -224,4 +226,4 @@ tap.test("should stop the service", async () => {
  await testPdfServiceInstance.stop();
 });

-export default tap.start();
+tap.start();
--- a/ts/00_commitinfo_data.ts
+++ b/ts/00_commitinfo_data.ts
@@ -3,6 +3,6 @@
 */
 export const commitinfo = {
  name: '@design.estate/dees-document',
-  version: '2.0.2',
+  version: '1.6.11',
  description: 'A sophisticated framework for dynamically generating and rendering business documents like invoices with modern web technologies, featuring PDF creation, templating, and automation.'
 }
--- a/ts/helpers.ts
+++ b/ts/helpers.ts
@@ -2,5 +2,5 @@ import * as plugins from './plugins.js';
 import * as paths from './paths.js';

 export const getBundleAsString = async () => {
-  return plugins.smartfs.file(paths.bundleFile).encoding('utf8').read();
+  return plugins.smartfile.fs.toStringSync(paths.bundleFile);
 };
--- a/ts/paths.ts
+++ b/ts/paths.ts
@@ -6,9 +6,7 @@ export const packageDir = plugins.path.join(
 );

 export const nogitDir = plugins.path.join(packageDir, '.nogit/');
-if (!(await plugins.smartfs.directory(nogitDir).exists())) {
-  await plugins.smartfs.directory(nogitDir).create();
-}
+plugins.smartfile.fs.ensureDirSync(nogitDir);

 export const bundleDir = plugins.path.join(packageDir, './dist_bundle');
 export const bundleFile = plugins.path.join(bundleDir, './bundle.js');
--- a/ts/plugins.ts
+++ b/ts/plugins.ts
@@ -10,13 +10,10 @@ export { shared };

 // @push.rocks/scope
 import * as smartfile from '@push.rocks/smartfile';
-import { SmartFs, SmartFsProviderNode } from '@push.rocks/smartfs';
 import * as smartjson from '@push.rocks/smartjson';
 import * as smartpath from '@push.rocks/smartpath';
 import * as smartpdf from '@push.rocks/smartpdf';

-export const smartfs = new SmartFs(new SmartFsProviderNode());
-
 export { smartfile, smartpath, smartjson, smartpdf };

 // @tsclass scope
--- a/ts_shared/demoletter.ts
+++ b/ts_shared/demoletter.ts
@@ -50,10 +50,7 @@ const toContact: plugins.tsclass.business.TContact = {
 };

 export const demoLetter: plugins.tsclass.finance.TInvoice = {
-  type: "accounting-doc",
-  accountingDocType: "invoice",
-  accountingDocId: "LL-INV-48765",
-  accountingDocStatus: "draft",
+  type: "invoice",
  id: "LL-INV-48765",
  versionInfo: {
    version: "1.0.0",
@@ -62,6 +59,7 @@ export const demoLetter: plugins.tsclass.finance.TInvoice = {
  language: "de",
  date: Date.now(),
  incidenceId: "LL-INV-48765",
+  invoiceId: "LL-INV-48765",
  subject: "LL-INV-48765",
  reverseCharge: true,
  dueInDays: 30,
@@ -76,6 +74,7 @@ export const demoLetter: plugins.tsclass.finance.TInvoice = {
  printResult: null,
  currency: "EUR",
  notes: [],
+  invoiceType: "debitnote",
  items: [
    {
      name: "Item with 19% VAT",
--- a/ts_shared/translation.ts
+++ b/ts_shared/translation.ts
@@ -148,10 +148,82 @@ export const DE_translations: Dictionary = {
  vat: "Umsatzsteuer",
 };

+// Define Spanish translations
+// export const ES_translations: TTranslationImplementation = {
+//   address: "Dirección",
+//   bankConnection: "Conexión bancaria",
+//   contactInfo: "Información de contacto",
+//   description: "Descripción",
+//   invoice: "Factura",
+//   itemPos: "Pos.",
+//   quantity: "Cantidad",
+//   registrationInfo: "Información de registro",
+//   reverseVatNote:
+//     "El IVA se aplica por inversión del sujeto pasivo y debe ser pagado por el cliente.",
+//   totalNetPrice: "Precio total neto",
+//   unitNetPrice: "Precio unitario neto",
+//   unitType: "Tipo de unidad",
+//   yourCustomerId: "Su número de cliente:",
+//   yourVatId: "Su ID de IVA:",
+//   continuesOnPage: "Continúa en la página",
+//   finalPageStatement: "Esta es la última página de este documento.",
+//   page: "Página",
+//   vatShort: "IVA",
+// };
+
+// Define French translations
+// export const FR_translations: TTranslationImplementation = {
+//   address: "Adresse",
+//   bankConnection: "Coordonnées bancaires",
+//   contactInfo: "Informations de contact",
+//   description: "Description",
+//   invoice: "Facture",
+//   itemPos: "Position",
+//   quantity: "Quantité",
+//   registrationInfo: "Informations d'enregistrement",
+//   reverseVatNote:
+//     "La TVA s'applique selon le mécanisme d'autoliquidation et est à payer par le client.",
+//   totalNetPrice: "Prix net total",
+//   unitNetPrice: "Prix unitaire net",
+//   unitType: "Type d'unité",
+//   yourCustomerId: "Votre numéro de client :",
+//   yourVatId: "Votre numéro de TVA :",
+//   continuesOnPage: "Continue sur la page",
+//   finalPageStatement: "Ceci est la dernière page de ce document.",
+//   page: "Page",
+//   vatShort: "TVA",
+// };
+
+// Define Italian translations
+// export const IT_translations: TTranslationImplementation = {
+//   address: "Indirizzo",
+//   bankConnection: "Coordinate bancarie",
+//   contactInfo: "Informazioni di contatto",
+//   description: "Descrizione",
+//   invoice: "Fattura",
+//   itemPos: "Pos.",
+//   quantity: "Quantità",
+//   registrationInfo: "Informazioni di registrazione",
+//   reverseVatNote:
+//     "L'IVA è applicata con inversione contabile ed è a carico del cliente.",
+//   totalNetPrice: "Prezzo netto totale",
+//   unitNetPrice: "Prezzo netto unitario",
+//   unitType: "Tipo di unità",
+//   yourCustomerId: "Il tuo numero cliente:",
+//   yourVatId: "Il tuo numero di partita IVA:",
+//   continuesOnPage: "Continua alla pagina",
+//   finalPageStatement: "Questa è l'ultima pagina di questo documento.",
+//   page: "Pagina",
+//   vatShort: "IVA",
+// };
+
 // Language Code Map
 export const languageCodeMap: Record<string, Dictionary> = {
  EN: EN_translations,
  DE: DE_translations,
+  // ES: ES_translations,
+  // FR: FR_translations,
+  // IT: IT_translations,
 };

 // Language Code Type
--- a/ts_web/00_commitinfo_data.ts
+++ b/ts_web/00_commitinfo_data.ts
@@ -3,6 +3,6 @@
 */
 export const commitinfo = {
  name: '@design.estate/dees-document',
-  version: '2.0.2',
+  version: '1.6.11',
  description: 'A sophisticated framework for dynamically generating and rendering business documents like invoices with modern web technologies, featuring PDF creation, templating, and automation.'
 }
--- a/ts_web/elements/contentinvoice.ts
+++ b/ts_web/elements/contentinvoice.ts
@@ -41,13 +41,13 @@ export class DeContentInvoice extends DeesElement {
    type: Object,
    reflect: true,
  })
-  accessor letterData: plugins.tsclass.finance.TInvoice;
+  public letterData: plugins.tsclass.finance.TInvoice;

  @property({
    type: Object,
    reflect: true,
  })
-  accessor documentSettings: plugins.shared.interfaces.IDocumentSettings;
+  public documentSettings: plugins.shared.interfaces.IDocumentSettings;

  constructor() {
    super();
--- a/ts_web/elements/document.ts
+++ b/ts_web/elements/document.ts
@@ -25,6 +25,8 @@ import { DePage } from "./page.js";
 import { DeContentInvoice } from "./contentinvoice.js";

 import { demoFunc } from "./document.demo.js";
+import { dedocumentSharedStyle } from "../style.js";
+import type { TInvoice } from "@tsclass/tsclass/dist_ts/finance/invoice.js";

 declare global {
  interface HTMLElementTagNameMap {
@@ -40,25 +42,25 @@ export class DeDocument extends DeesElement {
    type: String,
    reflect: true,
  })
-  accessor format: "a4" = "a4";
+  public format: "a4" = "a4";

  @property({
    type: Number,
    reflect: true,
  })
-  accessor viewWidth: number = null;
+  public viewWidth: number = null;

  @property({
    type: Number,
    reflect: true,
  })
-  accessor viewHeight: number = null;
+  public viewHeight: number = null;

  @property({
    type: Boolean,
    reflect: true,
  })
-  accessor printMode = false;
+  printMode = false;

  @property({
    type: Object,
@@ -71,7 +73,7 @@ export class DeDocument extends DeesElement {
      }
    },
  })
-  accessor letterData: plugins.tsclass.business.TLetter;
+  public letterData: plugins.tsclass.business.TLetter;

  @property({
    type: Object,
@@ -84,7 +86,7 @@ export class DeDocument extends DeesElement {
      }
    },
  })
-  accessor documentSettings: plugins.shared.interfaces.IDocumentSettings =
+  public documentSettings: plugins.shared.interfaces.IDocumentSettings =
    defaultDocumentSettings;

  constructor() {
@@ -94,6 +96,7 @@ export class DeDocument extends DeesElement {

  public static styles = [
    domtools.elementBasic.staticStyles,
+    dedocumentSharedStyle,
    css`
      :host {
        display: block;
@@ -156,8 +159,7 @@ export class DeDocument extends DeesElement {
    // lets append the content
    const content: DeContentInvoice = new DeContentInvoice();
    cleanUpStoreCurrentRender.push(content);
-    content.letterData = this
-      .letterData as unknown as plugins.tsclass.finance.TInvoice;
+    content.letterData = this.letterData as unknown as TInvoice;
    content.documentSettings = this.documentSettings;
    document.body.appendChild(content);

--- a/ts_web/elements/letterheader.ts
+++ b/ts_web/elements/letterheader.ts
@@ -31,25 +31,25 @@ export class DeLetterHeader extends DeesElement {
    type: Object,
    reflect: true,
  })
-  accessor letterData: plugins.tsclass.finance.TInvoice;
+  public letterData: plugins.tsclass.finance.TInvoice;

  @property({
    type: Number,
    reflect: true,
  })
-  accessor pageNumber: number = 1;
+  public pageNumber: number = 1;

  @property({
    type: Number,
    reflect: true,
  })
-  accessor pageTotalNumber: number = 1;
+  public pageTotalNumber: number = 1;

  @property({
    type: Object,
    reflect: true,
  })
-  accessor documentSettings: plugins.shared.interfaces.IDocumentSettings;
+  public documentSettings: plugins.shared.interfaces.IDocumentSettings;

  constructor() {
    super();
@@ -101,7 +101,7 @@ export class DeLetterHeader extends DeesElement {
  ];

  private renderDeliveryDate(from: Date, to: Date): TemplateResult {
-    if (this.letterData.accountingDocType !== "invoice") return null;
+    if (this.letterData.type !== "invoice") return null;
    const dateFormat = new Intl.DateTimeFormat(
      this.documentSettings.languageCode,
      { dateStyle: this.documentSettings.dateStyle }
@@ -174,7 +174,7 @@ export class DeLetterHeader extends DeesElement {
        ${this.letterData.to.registrationDetails.vatId || "not provided"}

        <!-- TODO: Make use of components -->
-        ${this.letterData.accountingDocType === "invoice"
+        ${this.letterData.type === "invoice"
          ? html` <div class="label">
                ${plugins.shared.translation.translate(
                  this.documentSettings.languageCode,
--- a/ts_web/elements/page.ts
+++ b/ts_web/elements/page.ts
@@ -12,6 +12,7 @@ import {
 import * as plugins from "../plugins.js";

 import { defaultDocumentSettings } from "./document.js";
+import { dedocumentSharedStyle } from "../style.js";

 declare global {
  interface HTMLElementTagNameMap {
@@ -27,44 +28,44 @@ export class DePage extends DeesElement {
  @property({
    type: Number,
  })
-  accessor viewWidth: number = null;
+  viewWidth: number = null;

  @property({
    type: Number,
  })
-  accessor viewHeight: number = null;
+  viewHeight: number = null;

  @property({
    type: String,
  })
-  accessor format: "a4" = "a4";
+  public format: "a4" = "a4";

  @property({
    type: Number,
  })
-  accessor pageNumber: number = 1;
+  public pageNumber: number = 1;

  @property({
    type: Number,
  })
-  accessor pageTotalNumber: number = 1;
+  public pageTotalNumber: number = 1;

  @property({
    type: Object,
  })
-  accessor letterData: tsclass.business.TLetter = null;
+  public letterData: tsclass.business.TLetter = null;

  @property({
    type: Boolean,
    reflect: true,
  })
-  accessor printMode = false;
+  printMode = false;

  @property({
    type: Object,
    reflect: true,
  })
-  accessor documentSettings: plugins.shared.interfaces.IDocumentSettings =
+  public documentSettings: plugins.shared.interfaces.IDocumentSettings =
    defaultDocumentSettings;

  constructor() {
@@ -74,6 +75,7 @@ export class DePage extends DeesElement {

  public static styles = [
    domtools.elementBasic.staticStyles,
+    dedocumentSharedStyle,
    css`
      :host {
        display: block;
@@ -132,14 +134,17 @@ export class DePage extends DeesElement {
  ];

  public render(): TemplateResult {
-    const theme = this.documentSettings.theme;
    return html`
      <style>
        :host {
-          ${theme?.colorPrimaryForeground ? `--theme-color-primary-fg: ${theme.colorPrimaryForeground};` : ''}
-          ${theme?.colorPrimaryBackground ? `--theme-color-primary-bg: ${theme.colorPrimaryBackground};` : ''}
-          ${theme?.colorAccentForeground ? `--theme-color-accent-fg: ${theme.colorAccentForeground};` : ''}
-          ${theme?.colorAccentBackground ? `--theme-color-accent-bg: ${theme.colorAccentBackground};` : ''}
+          --theme-color-primary-fg: ${this.documentSettings.theme
+            ?.colorPrimaryForeground};
+          --theme-color-primary-bg: ${this.documentSettings.theme
+            ?.colorPrimaryBackground};
+          --theme-color-accent-fg: ${this.documentSettings.theme
+            ?.colorAccentForeground};
+          --theme-color-accent-bg: ${this.documentSettings.theme
+            ?.colorAccentBackground};
        }

        .page {
@@ -148,17 +153,21 @@ export class DePage extends DeesElement {
        }

        .page:not(.page--first) {
-          background-image: ${theme?.pageBackground ?? "none"};
+          background-image: ${this.documentSettings.theme?.pageBackground ??
+          "none"};
        }

        .page.page--first {
-          background-image: ${theme?.coverPageBackground ?? theme?.pageBackground ?? "none"};
+          background-image: ${this.documentSettings.theme
+            ?.coverPageBackground ??
+          this.documentSettings.theme?.pageBackground ??
+          "none"};
        }
      </style>
      <div id="scaleWrapper">
        <dedocument-pagecontainer .printMode=${this.printMode}>
          <div
-            class="page ${this.pageNumber === 1
+            class="page page__background ${this.pageNumber === 1
              ? "page--first"
              : ""}"
          ></div>
--- a/ts_web/elements/pagecontainer.ts
+++ b/ts_web/elements/pagecontainer.ts
@@ -27,12 +27,12 @@ export class DePageContainer extends DeesElement {
  @property({
    type: String,
  })
-  accessor format: "a4" = "a4";
+  public format: "a4" = "a4";

  @property({
    type: Boolean,
  })
-  accessor printMode = false;
+  public printMode = false;

  constructor() {
    super();
@@ -50,7 +50,6 @@ export class DePageContainer extends DeesElement {
        position: relative;
        border-radius: 3px;
        overflow: hidden;
-        background: var(--text-bg-color, #ffffff);
      }
    `,
  ];
--- a/ts_web/elements/pagecontent.ts
+++ b/ts_web/elements/pagecontent.ts
@@ -28,23 +28,23 @@ export class DePageContent extends DeesElement {
  @property({
    type: Number,
  })
-  accessor letterData: plugins.tsclass.business.TLetter;
+  public letterData: plugins.tsclass.business.TLetter;

  @property({
    type: Number,
  })
-  accessor pageNumber: number = 1;
+  public pageNumber: number = 1;

  @property({
    type: Number,
  })
-  accessor pageTotalNumber: number = 1;
+  public pageTotalNumber: number = 1;

  @property({
    type: Object,
    reflect: true,
  })
-  accessor documentSettings: plugins.shared.interfaces.IDocumentSettings;
+  public documentSettings: plugins.shared.interfaces.IDocumentSettings;

  constructor() {
    super();
--- a/ts_web/elements/pagefooter.ts
+++ b/ts_web/elements/pagefooter.ts
@@ -27,23 +27,23 @@ export class DePageFooter extends DeesElement {
  @property({
    type: Object,
  })
-  accessor letterData: plugins.tsclass.business.TLetter;
+  letterData: plugins.tsclass.business.TLetter;

  @property({
    type: Object,
    reflect: true,
  })
-  accessor documentSettings: plugins.shared.interfaces.IDocumentSettings;
+  documentSettings: plugins.shared.interfaces.IDocumentSettings;

  @property({
    type: Number,
  })
-  accessor pageNumber: number = 1;
+  public pageNumber: number = 1;

  @property({
    type: Number,
  })
-  accessor pageTotalNumber: number = 1;
+  public pageTotalNumber: number = 1;

  constructor() {
    super();
--- a/ts_web/elements/pageheader.ts
+++ b/ts_web/elements/pageheader.ts
@@ -28,23 +28,23 @@ export class DePageHeader extends DeesElement {
  @property({
    type: Object,
  })
-  accessor letterData: plugins.tsclass.business.TLetter = null;
+  public letterData: plugins.tsclass.business.TLetter = null;

  @property({
    type: Object,
    reflect: true,
  })
-  accessor documentSettings: plugins.shared.interfaces.IDocumentSettings;
+  documentSettings: plugins.shared.interfaces.IDocumentSettings;

  @property({
    type: Number,
  })
-  accessor pageNumber: number = 1;
+  public pageNumber: number = 1;

  @property({
    type: Number,
  })
-  accessor pageTotalNumber: number = 1;
+  public pageTotalNumber: number = 1;

  constructor() {
    super();
--- a/ts_web/elements/paymentcode.ts
+++ b/ts_web/elements/paymentcode.ts
@@ -33,25 +33,25 @@ export class DedocumentPaymentCode extends DeesElement {
  ];

  @query("canvas")
-  accessor canvasEl!: HTMLCanvasElement;
+  private canvasEl!: HTMLCanvasElement;

  @property()
-  accessor bic: string;
+  public bic: string;

  @property()
-  accessor name: string;
+  public name: string;

  @property()
-  accessor iban: string;
+  public iban: string;

  @property()
-  accessor currency: string;
+  public currency: string;

  @property({ type: Number })
-  accessor totalGross: number;
+  public totalGross: number;

  @property()
-  accessor reference: string;
+  public reference: string;

  private updateQRCode(): void {
    if (!this.canvasEl) return;
--- a/ts_web/elements/viewer.ts
+++ b/ts_web/elements/viewer.ts
@@ -26,13 +26,13 @@ export class DeDocumentViewer extends DeesElement {
    type: Object,
    reflect: true,
  })
-  accessor letterData: plugins.tsclass.business.TLetter = null;
+  public letterData: plugins.tsclass.business.TLetter = null;

  @property({
    type: Object,
    reflect: true,
  })
-  accessor documentSettings: plugins.shared.interfaces.IDocumentSettings;
+  public documentSettings: plugins.shared.interfaces.IDocumentSettings;

  public static styles = [
    cssManager.defaultStyles,
--- a/ts_web/style.ts
+++ b/ts_web/style.ts
@@ -21,7 +21,7 @@ export const dedocumentSharedStyle = css`
    --text-bg-color: var(--color-primary-bg);
    --label-fg: var(--color-dark);
    --label-bg: var(--color-grey);
-    --footer-separator-bg-color: var(--color-accent-bg);
+    --footer-separator-bg-color: var(--color-accent);
    --footer-separator-fg-color: var(--color-light);

    /* Functional variables */
@@ -32,6 +32,7 @@ export const dedocumentSharedStyle = css`
    --text-font-size: var(--theme-text-font-size, 12px);

    color: var(--text-fg-color);
+    background: var(--text-bg-color);
    font-family: var(--text-font-family);
    font-size: var(--text-font-size);
  }
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -1,5 +1,7 @@
 {
  "compilerOptions": {
+    "experimentalDecorators": true,
+    "useDefineForClassFields": false,
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",