feat: LiquidJS template rendering integration (#40) #45

2026-05-31T06:08:24Z

xiaoju commented

2026-05-31 06:08:24 +00:00

What

Phase 4: LiquidJS template rendering integration — custom render tag for recursive node rendering with resolution decay.

Changes

LiquidJS engine integration with custom render tag
Template discovery via @ucas/template/text/<schema-hash> variables
Decay priority chain: template explicit > CLI --decay > engine default
Fallback to YAML rendering when no template registered

Fixes #40

小橘 🍊（NEKO Team）

## What Phase 4: LiquidJS template rendering integration — custom `render` tag for recursive node rendering with resolution decay. ## Changes - LiquidJS engine integration with custom `render` tag - Template discovery via `@ucas/template/text/<schema-hash>` variables - Decay priority chain: template explicit > CLI --decay > engine default - Fallback to YAML rendering when no template registered Fixes #40 --- 小橘 🍊（NEKO Team）

xiaoju added 3 commits 2026-05-31 06:08:24 +00:00

feat: implement LiquidJS template rendering integration 72f85c9077

Integrates LiquidJS as the template engine for CAS node rendering with
custom {% render %} tag supporting recursive rendering with resolution
decay. Templates are discovered via variables under
@ucas/template/text/<type-hash>. When ucas render <hash> is invoked,
the system queries for a registered template; if found, uses LiquidJS;
otherwise falls back to Phase 3's default YAML renderer.

Key features:
- Custom {% render %} tag with recursive CAS node rendering
- Decay priority chain: template decay > CLI --decay > default 0.5
- Context variables: resolution, epsilon, hash, payload, type, timestamp
- Graceful fallback: No template → YAML rendering (Phase 3)
- Zero breaking changes: All Phase 3 tests still pass
- Template discovery via @ucas/template/text/<type-hash> variables

Implementation:
- New file: packages/json-cas/src/liquid-render.ts — LiquidJS integration
- Modified: packages/json-cas/src/render.ts — Template lookup + YAML fallback
- New file: packages/json-cas/src/liquid-render.test.ts — 32 comprehensive tests
- Dependency: liquidjs npm package
- CLI: No changes needed (transparent integration)

All tests pass (336 tests), build succeeds, lint checks pass.

Closes #40

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

fix: resolve TypeScript strict mode and dynamic import issues e0af351991

Fixes reviewer feedback:
1. Fixed TypeScript strict mode error where ctx.engine was possibly null
   - Refactored to pass store/varStore/globalDecay directly to createLiquidEngine
   - Eliminated RenderContext type that caused circular dependency
   - Engine is now properly typed as Liquid (non-nullable)

2. Removed dynamic imports from production code
   - Changed render.ts to use static import of renderWithTemplate
   - Changed hasTemplate to use static import of putSchema
   - Complies with CLAUDE.md convention against dynamic imports

All tests pass (336 tests), build succeeds with no TypeScript errors,
lint checks pass with only 1 minor warning about unused parameter
(which is actually used in recursive calls).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat: Add CLI integration for LiquidJS template rendering 07e08e3b38

Integrates LiquidJS template rendering into the CLI render command.
When a template is registered for a node's schema type via the variable
system (@ucas/template/text/<schema-hash>), the CLI will use the template
for rendering. Otherwise, it falls back to YAML output.

Changes:
- Modified cmdRender in index.ts to use renderAsync with variable store
- Added Suite 6: CLI Integration with Templates (5 comprehensive tests)
- Fixed template file format: templates must be JSON-encoded strings
- Removed unused render import from index.ts
- Renamed unused globalDecay parameter in liquid-render.ts

Test coverage increased from 336 to 341 tests, all passing.

Fixes #40

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

xiaoju merged commit 0a761f5289 into main

2026-05-31 06:08:31 +00:00

xiaoju referenced this pull request

2026-05-31 06:55:13 +00:00

Phase 4: LiquidJS 模板渲染集成 #40

xiaoju referenced this pull request

2026-05-31 06:57:04 +00:00

chore: Phase 4 post-merge cleanup — duplicate types, unused params, test fixes #46

xiaoju referenced this pull request

2026-05-31 07:19:41 +00:00

chore: Phase 4 cleanup — dedupe types, remove unused params, fix tests #47

xiaoju referenced this pull request