changelog.md for @design.estate/dees-document

2025-12-11 - 2.2.3 - fix(contentinvoice)

Use shared translation.TranslationKey type in DeContentInvoice.translateKey and remove local import

• Replaced local TranslationKey import with plugins.shared.translation.TranslationKey to ensure type consistency
• Updated DeContentInvoice.translateKey parameter type to reference the shared translation type
• Removed an unused type import from ts_web/elements/contentinvoice.ts

2025-12-11 - 2.2.0 - feat(viewer)

Add pagination metadata and thumbnail offset rendering for viewer thumbnails

• Expose per-page pagination metadata (IPagePaginationInfo) from DeDocument during rendering (pageNumber, startOffset, contentLength).
• DeDocument now collects pagination info while paginating and dispatches a 'pagination-complete' CustomEvent with pageCount and paginationInfo (bubbled & composed).
• DeContentInvoice: add renderStartOffset and renderContentLength properties and applyOffsetTrimming to support rendering trimmed content (used for thumbnails).
• DeDocumentViewer: listen for 'pagination-complete', store paginationInfo, and render thumbnail previews by mounting DeContentInvoice instances with precomputed offsets to produce accurate thumbnails.
• Viewer: wire thumbnail generation to use per-page offsets so thumbnails show exactly the content slice for each page.
• Demo data: extended demo invoice items in ts_shared/demoletter.ts to better exercise pagination and thumbnail rendering.
• Remove registry override from .npmrc (previously pointed to registry.npmjs.org).

2025-12-11 - 2.1.1 - fix(viewer)

Improve sidebar resizing UX and update deps

• Add smooth width transition for the thumbnail sidebar to improve resize visuals
• Disable viewport CSS transitions while user is actively resizing the sidebar to avoid janky animations
• Mark viewport as resizing in classes so layout updates skip transitions during drag
• Make sidebar resize mousemove listener passive to improve scrolling/interaction performance
• Bump @design.estate/dees-wcctools to ^2.0.0 and @git.zone/tswatch to ^2.3.11

2025-12-11 - 2.1.0 - feat(viewer)

Add smooth zoom and scroll animations to viewer

• Introduce smooth zoom animation: new private animateZoomTo(targetZoom, duration) method and zoomAnimationId to track/cancel running animations
• Animate transitions for numeric zoom presets and zoom step changes (handleZoomStep now uses animateZoomTo)
• Cancel ongoing zoom animation when user manipulates the zoom slider
• Make fit-to-width and fit-to-page calculations optionally animate (calculateFitWidth/ calculateFitPage accept animate flag)
• Add animated scrolling helper animateScrollTo for smooth page scrolling when requested (used when smooth=true)

2025-12-11 - 2.0.6 - fix(DeDocumentViewer)

Account for toolbar and padding when calculating Fit Page zoom in viewer

• calculateFitPage now subtracts explicit top (toolbar + padding), bottom, and side paddings from viewport dimensions before computing scale.
• This produces a more accurate zoom level for the Fit Page preset by considering toolbar height and page margins.

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

• Updated copyright from Lossless GmbH to Task Venture Capital GmbH.

2024-12-08 - 1.6.10 - fix(core)

Improve stability and performance of document generation

2024-12-08 - 1.6.9 - fix(contentinvoice.ts)

Improve invoice item layout and fix alignment issues.

• Fixed missing border on last invoice item.
• Added highlighted style for invoice lines.
• Corrected alignment and display of invoice item details.
• Included VAT percentage display adjustments.

2024-12-07 - 1.6.8 - fix(rendering and logging)

Removed debug logging from document rendering process.

• Removed console logs from content invoice, document rendering, page scaling, and overflow checking.

2024-12-07 - 1.6.7 - fix(document rendering)

Fixed overflow issues in document and page elements

• Ensured content overflow handling in document.ts
• Adjusted page element overflow settings in page.ts

2024-12-07 - 1.6.6 - fix(page-render)

Fix layout scaling adjustment for page component

• Ensure font-family is no longer explicitly set to inherit in DePage component.
• Adjust scaling logic to properly set width and overflow based on calculated scale.

2024-12-05 - 1.6.5 - fix(contentinvoice)

Fix VAT group item number formatting and remove custom font style in invoice sums.

• Removed custom font-family style from the invoice sums.
• Corrected VAT group item numbers display by properly formatting and removing trailing comma.

2024-12-05 - 1.6.4 - fix(styling)

Consolidated shared styles for consistent font applied across various components.

• Added a shared style file for consistent font family across components
• Applied shared style to contentinvoice, letterheader, pagecontent, pagefooter, and pageheader components

2024-12-05 - 1.6.3 - fix(ui)

Corrects font family in contentinvoice element.

• Updated the font-family for line items in contentinvoice.ts

2024-12-05 - 1.6.2 - fix(translation)

Corrected missing translation keys for VAT short form across multiple languages.

• Fixed missing 'vatShort' translation for English, German, Spanish, French, and Italian in translation.ts file.

2024-12-05 - 1.6.1 - fix(core)

Ensure consistent project structure and code organization without additional changes.

2024-12-05 - 1.6.0 - feat(documentSettings + translations + vat in itemLines)

Updated dependencies in package.json

• Updated @types/node to version ^22.10.1
• Updated qrcode package to version ^1.5.4

2024-12-02 - 1.5.3 - fix(elements)

Update viewer attributes and fix font integration

• Updated viewer.ts to add missing property decorators for letterData and documentSettings.
• Fixed font loading by correcting URLs in index.html.
• Set demoDocumentSettings default header and footer to false.

2024-12-02 - 1.5.2 - fix(workflow)

Corrected Docker image references and package scope in YAML workflows for compatibility.

• Updated Docker image reference from GitLab to code.foss.global for npmci UI workflows.
• Fixed npm package scope for @shipzone/npmci in YAML workflows.
• Minor formatting corrections for better code readability.

2024-12-02 - 1.5.1 - fix(package)

Fix duplicate node export in package.json

• Resolved a duplication issue with the './node' export in package.json exports field.

2024-12-02 - 1.5.0 - feat(core)

Refactor project structure for better modularity and code organization

• Moved shared components to a dedicated 'dist_ts_shared' directory for better separation of concerns.
• Updated import statements across the codebase to align with the new file structure.
• Introduced translations directly under 'ts_shared' for language-specific string management.

2024-12-02 - 1.4.0 - feat(translation)

Add French and Italian translations for document interface

• Expanded translation support by adding French and Italian language translations
• Fixed duplicated text in German final page statement
• Improved Spanish translation of reverse VAT note and final page statement

2024-12-02 - 1.3.2 - fix(core)

Minor updates and optimizations in the output PDF formatting process.

• Improved handling of page content overflow in PDF generation.
• Refined default document settings for consistent rendering.

2024-12-02 - 1.3.1 - fix(documentation)

Updated project description and enhanced documentation in package.json and README

• The package description in package.json was updated to include more features.
• Added more details about setting up and using the PdfService.
• Included comprehensive examples for initializing and generating PDFs.
• Expanded sections covering advanced features, modular components, interactive documents, and localization support.

2024-12-02 - 1.3.0 - feat(translation)

Add multi-language support for document translations.

• Implemented translation interface for document labels.
• Added Spanish translations alongside existing English and German.
• Updated content invoice, page header, and page footer elements to utilize language-specific translations.

2024-12-01 - 1.2.0 - feat(core)

Enhance document generation capabilities with improved modular structure and extended translation support.

• Enhanced document generation framework with a more modular structure.
• Integrated support for translations using JSON-based language maps.
• Optimized PDF generation process for dynamic document content.
• Added properties in 'IDocumentSettings' for language code management.
• Updated README documentation with more comprehensive examples and guidance.

2024-11-30 - 1.1.0 - feat(core)

Enhanced document generation features and added translation capabilities

• Updated document rendering with advanced modular architecture.
• Introduced translation mechanism for document content.
• Improved PDF generation with dynamic settings support.
• Enhanced test cases for PDF generation with complex document structures.

2024-11-27 - 1.0.103 - fix(DeDocument)

Fix rendering of documents by properly moving new pages back to the document container

• Resolved an issue in the DeDocument component where new pages were wrongly managed, causing errors in the rendering of documents.
• Added a documentBuildContainer for temporary storage during page setup, ensuring correct page ordering.

2024-11-27 - 1.0.102 - fix(contentinvoice)

Fixed currency display issues in invoice content rendering.

• Corrected the usage of currency property to consistently pull from letterData content for invoice items.
• Ensured currency is correctly displayed in the invoice PDF generation.

2024-11-27 - 1.0.101 - fix(shared)

Fixed the demo letter item details by replacing currency with position to correctly define the item position.

• Replaced incorrect 'currency' field with 'position' in demoletter.ts for item details.
• Ensured item positions are correctly assigned in demoletter.ts.

2024-11-27 - 1.0.100 - fix(core)

Fix issues with PDF service, invoice item positioning, and update package dependencies.

• Updated package dependencies to latest versions for improved stability and performance.
• Fixed invoice item positioning in demo data.
• Ensured PDF service handles rendering updates more efficiently.

2024-04-20 to 2023-10-16 - 1.0.99 to 1.0.90 - Core Fixes and Documentation Update

Routine updates and fixes with a focus on core improvements and documentation enhancements.

• Regular core updates to enhance stability and performance
• Updated project documentation for better clarity and user guidance