2.0 KiB
2.0 KiB
Project Hints - @api.global/typedserver
Recent Changes (March 2026)
Dependency Updates
@git.zone/tsbuildupgraded to v4.3.0 (major: auto path rewriting, folder clearing)@git.zone/tsbundleupgraded to v2.9.1 (uses npmextra.json config)@git.zone/tstestupgraded to v3.5.0@push.rocks/smartsitemapupgraded to v4.0.1 (major: builder pattern API)@push.rocks/taskbufferupgraded to v8.0.0 (backward compatible for existing usage)@push.rocks/smartjsonupgraded to v6.0.0 (backward compatible)@tsclass/tsclassupgraded to v9.5.0@types/nodeupgraded to v25.5.0- All other dependencies updated to latest patch/minor versions
Code Migration Notes
tsbuild v4 Migration
- Cross-folder imports: Use
../ts_interfaces/index.jsinstead of../dist_ts_interfaces/index.js - tsbuild v4 automatically rewrites import paths from
ts_*todist_ts_*in output - CLI flags
--weband--allowimplicitanyremoved (defaults already handle these) - Build script simplified to
tsbuild tsfolders && tsbundle
tsbundle npmextra.json Config
- Bundle configuration moved from CLI args to
npmextra.jsonunder"@git.zone/tsbundle"key - Three bundles configured: web_inject, web_serviceworker, swdash
smartsitemap v4 Migration
- Complete API rewrite using builder pattern
- Old:
new SmartSitemap().createSitemapFromUrlInfoArray(urls) - New:
SmartSitemap.create().addUrls(urls).toXml() - Old:
new SmartSitemap().createSitemapNewsFromArticleArray(articles) - New:
SmartSitemap.fromArticles(articles, { publicationName: '...' }).toXml() IUrlInforenamed toISitemapUrlwith different properties:url→loctimestamp→lastmod(accepts Date | string | number)frequency→changefreq
Architecture
plugins.fsInstanceis a pre-configured SmartFs instance with SmartFsProviderNode- All file operations should be async using smartfs
- Cross-folder imports reference source
ts_*folders, tsbuild handles path rewriting