@fictjs/compiler 0.5.2 → 0.7.0

package/README.md

@@ -26,6 +26,12 @@ createFictPlugin({
   },
   // Keep single-use derived values as memos (strict memo mode)
   // inlineDerivedMemos: false,
+  // Metadata write mode:
+  // - true: write adjacent sidecar files
+  // - false: never write files
+  // - auto (default): write to cache dir only when needed
+  // emitModuleMetadata: 'auto',
+  // moduleMetadataCacheDir: '.fict-cache/metadata',
   // Allow $state/$effect inside reactive-scope callbacks (e.g., renderHook(() => ...))
   reactiveScopes: ['renderHook'],
 })
@@ -34,6 +40,12 @@ createFictPlugin({
 - `dev` (default: `NODE_ENV !== 'production' && NODE_ENV !== 'test'`): enables compiler warnings/diagnostics. Set to `false` to silence warnings.
 - `onWarn`: custom warning handler (only called when `dev` is enabled).
 - `inlineDerivedMemos` (default: `true`): allow the compiler to inline single-use derived values. Set to `false` for a “strict memo” mode where user-named derived values keep explicit memo accessors (unless `"use no memo"` disables memoization).
+- `emitModuleMetadata`:
+  - `true`: always write adjacent `.fict.meta.json` sidecar files next to source files.
+  - `false`: never write metadata files.
+  - `'auto'` (default): writes metadata to cache directory (not source tree) only when no external metadata store/resolver is provided.
+- `moduleMetadataCacheDir` (default: `<cwd>/.fict-cache/metadata`): cache directory used by `emitModuleMetadata: 'auto'`.
+- `moduleMetadata` / `resolveModuleMetadata`: external metadata integration hooks. When provided, `'auto'` does not write metadata files.
 - `reactiveScopes`: function names whose **first callback argument** is treated as a component-like reactive scope.
   - Only **direct calls** are recognized (e.g., `renderHook(() => ...)` or `utils.renderHook(() => ...)`).
   - **Aliases/indirect calls** are not recognized (e.g., `const rh = renderHook; rh(() => ...)`).