dees-document/readme.hints.md

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:

@property({ type: Object })
accessor letterData: TInvoice;

SmartFs Usage

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