nattoppet 4.1.0 → 4.1.1

package/GUIDE.md

@@ -194,7 +194,8 @@ A mixin inlines another file into the current token stream.
 - If the path has an extension, it is used as-is.
 - If the path has no extension and a file with that exact name exists, it is used.
 - Otherwise, `.ymd` is appended (e.g. `[mixin] common` resolves to `common.ymd`).
-- **All mixin paths are resolved relative to the nattoppet installation directory** (where `compiler.ts` lives). Paths starting with `./` are **not** treated specially; they also resolve relative to the compiler root.
+- Bare paths such as `common` resolve relative to the nattoppet installation directory.
+- Explicit relative paths beginning with `./` or `../` resolve relative to the input document. Relative paths inside a mixin resolve relative to that mixin.
 
 ### Non-`.ymd` mixins
 
@@ -213,7 +214,7 @@ A mixin can contain a `[#slot]` marker. When the mixin is expanded, the caller's
 [#slot]
 
 [#] -- page.ymd --
-[mixin] layout.ymd
+[mixin] ./layout.ymd
 
 [title]: My Page
 <h1>Hello</h1>
@@ -223,7 +224,7 @@ A mixin can contain a `[#slot]` marker. When the mixin is expanded, the caller's
 
 ### `common.ymd`
 
-`common.ymd` ships with nattoppet in the project root. Since mixin paths resolve relative to the compiler root, `[mixin] common` finds it automatically. All built-in themes include it, which is why macros like `[require]`, `[img]`, and `[code]` are available in themed documents.
+`common.ymd` ships with nattoppet in the project root. Since bare mixin paths resolve relative to the compiler root, `[mixin] common` finds it automatically. All built-in themes include it, which is why macros like `[require]`, `[img]`, and `[code]` are available in themed documents.
 
 **Trap**: If you write a bare `.ymd` without a theme and want `[require]`, you must add `[mixin] common.ymd` yourself. `[require]` is not a compiler built-in; it is a function macro defined in `common.ymd`.
 
@@ -633,7 +634,7 @@ The delimiter passed to `capture_until` is consumed from `remaining` but is **no
 | `definition X not found` | You invoked `[X]` but never defined `[X]:` or `[X]=`. | Define the macro, or check for typos. |
 | `definition X not found` inside a self-referential ref | Reference macros cannot reference themselves. | Use a function macro if you need recursion, or restructure. |
 | Multiple `[#slot]` error | A mixin contains more than one slot. | Remove extra slots, or split into multiple mixins. |
-| `mixin not found: X` | The mixin path could not be resolved. | Check the path; remember all mixin paths resolve relative to the compiler root, not the input file. |
+| `mixin not found: X` | The mixin path could not be resolved. | Use a bare name for a built-in mixin, or begin a project-local path with `./` or `../`. |
 | Math does not render, or renders inline when it should be display | Missing `>>...<<` block delimiters around multi-line `[$$]`. | Use `[$$]>>...<<`. |
 | CJK text has unwanted spaces | Hard line breaks between CJK characters are preserved as spaces by HTML. | Wrap the text in `[cn]>>...<<`. |
 | Paragraphs wrap raw HTML | Indented HTML is treated as prose. | Remove the leading two spaces from HTML lines. |

package/dist/nattoppet-dev.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import { createRequire as createNattoppetRequire } from 'node:module'; const require = createNattoppetRequire(import.meta.url);
 
 // nattoppet-dev.ts
 import * as fs from "node:fs";

package/dist/nattoppet-init.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import { createRequire as createNattoppetRequire } from 'node:module'; const require = createNattoppetRequire(import.meta.url);
 
 // nattoppet-init.ts
 import * as fs from "node:fs";

package/dist/nattoppet-native.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import { createRequire as createNattoppetRequire } from 'node:module'; const require = createNattoppetRequire(import.meta.url);
 
 // nattoppet-native.ts
 import * as fs from "node:fs";