@pitlane/content 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,22 +1,43 @@
 # @pitlane/content
 
+## 0.2.0
+
+### Minor Changes
+
+- 87ec1f6: Give headings the ids GitHub gives them. `headings()` now lowercases a heading, removes every character outside letters, marks, digits, and connector punctuation, and turns each space into a hyphen without collapsing or trimming any of them — the algorithm GitHub uses, and the one Astro's `rehype-heading-ids` uses through the same `github-slugger` package. `## Databases & Data Loading` was `databases-data-loading` and is now `databases--data-loading`; `## Jenni’s Quesadillas` was `jenni-s-quesadillas` and is now `jennis-quesadillas`.
+
+    A heading containing punctuation or symbols can therefore get a different `id` than it did before — `## Hello World!` keeps `hello-world`, but `## Databases & Data Loading` does not — so an anchor written by hand against the old ids needs checking once. In exchange, a table of contents carried over from GitHub or Astro keeps landing without being rewritten. A heading that slugs to nothing at all, such as `## 🎉`, still falls back to `heading` rather than to the empty `id` GitHub produces, and a later `## Heading` in the same document then takes `heading-1`.
+
+### Patch Changes
+
+- f8b0db5: Keep content prebuilds from deleting the running app's optimized browser dependencies. This fixes `504 (Outdated Optimize Dep)` errors that could leave MDX updates and client-side navigation broken until the dev server restarted.
+- 98e8a77: Vite no longer warns that it cannot analyze a dynamic import in `@pitlane/content` when an app using `contentLayer()` starts its dev server. The runtime import of a document's resolved dependencies is now marked `/* @vite-ignore */`, since its target is only known at request time.
+
+## 0.1.1
+
+Published 2026-09-21. [npm](https://www.npmjs.com/package/@pitlane/content/v/0.1.1) · [GitHub release](https://github.com/pitlane-tools/pitlane/releases/tag/%40pitlane/content%400.1.1) · [Source](https://github.com/pitlane-tools/pitlane/commit/b725843491ad0c36c61c83d44466134f76dbd615).
+
+Documentation only. No code changed.
+
+- The npm description is one line now: "Schema-validated content collections for Remix." The old one led with `createContent()` and ran well past what a registry listing shows.
+- The README quick start guards the entry it reads. `getEntry()` answers `undefined` when no entry has the requested id, and the sample called `render()` on the result regardless, so a route copied out of it threw on the first unknown slug.
+- The install section states the supported Node range and what each optional peer is for: `remix` for `render()`, `satteri` for compiling Markdown and MDX bodies, `vite` 8 or newer for `contentLayer()`. A collection of JSON or YAML files alone needs no Sätteri setup.
+- Link the content guide, the no-build guide, and the custom-loaders section separately. Replace the unpublished `/guides/content-loaders` URL with `/guides/content#custom-loaders`.
+
 ## 0.1.0
 
+Published 2026-09-21. [npm](https://www.npmjs.com/package/@pitlane/content/v/0.1.0) · [GitHub release](https://github.com/pitlane-tools/pitlane/releases/tag/%40pitlane/content%400.1.0) · [Source](https://github.com/pitlane-tools/pitlane/commit/31aae9c3c941238fbb94769e578e320179dc8284).
+
 Initial release.
 
-- `createContent` returns typed collection handles synchronously without loading
-  entries. Reads and rendering remain asynchronous; declaration errors throw
-  synchronously.
-- `getCollection`, `getCollection(filter)`, and `getEntry` over entries sorted
-  by id; `c.reference(collection)` for typed pointers between collections.
-- `render()` resolves an entry's Markdown or MDX to a Remix component and its
-  heading list, parsing nothing until it is called.
-- Two loader interfaces: `ContentLoader` resolves a whole collection in one
-  execution and can be prebuilt, `LiveLoader` answers one query at a time and
-  runs on every read. `loaders.glob` and `loaders.file` implement the first.
-- `contentLayer()` from `@pitlane/content/vite` loads `ContentLoader` collections
-  after evaluating their declarations and inlines them into the bundle. It waits
-  for loading and validation before emitting, and watches the loaders' sources
-  in dev.
-- `headings()` from `@pitlane/content/satteri` produces the heading list on both
-  rendering paths.
+- `createContent` returns typed collection handles synchronously without loading entries. Reads and rendering remain asynchronous; declaration errors throw synchronously.
+- An entry's data is validated against its collection's schema as it loads, before any query returns it. Any Standard Schema validator does that work, `remix/data-schema` and Zod included, and the entry type is inferred from the schema rather than generated: `CollectionEntry<typeof content.blog>` names one. A failure reports the entry, the collection, the file it came from, and every issue.
+- `getCollection`, `getCollection(filter)`, and `getEntry` over entries sorted by id; `c.reference(collection)` for typed pointers between collections.
+- `render()` resolves an entry's Markdown or MDX to a Remix component and its heading list, parsing nothing until it is called.
+- Without a bundler, `render()` also resolves an MDX document's own imports relative to the document. A namespace import and `import.meta` are refused by name, since neither survives the function body an MDX document compiles to here.
+- Two loader interfaces: `ContentLoader` resolves a whole collection in one execution and can be prebuilt, `LiveLoader` answers one query at a time and runs on every read. `loaders.glob` and `loaders.file` implement the first. `glob` reads Markdown, MDX, JSON, and YAML, one entry per file; `file` reads a single JSON or YAML file holding many entries, and takes a `parser` for any other format.
+- `contentLayer()` from `@pitlane/content/vite` loads `ContentLoader` collections after evaluating their declarations and inlines them into the bundle. It waits for loading and validation before emitting, and watches the loaders' sources in dev.
+- `headings()` from `@pitlane/content/satteri` produces the heading list on both rendering paths. `rawStyles()` sits beside it and hands a `<style>` element's CSS to Remix as markup, which is what keeps an Expressive Code theme from reaching the page escaped into rules that match nothing. `render()` applies both; a Vite build passes them to `vite-plugin-satteri`.
+- `hotContent()` from `@pitlane/content/hot` reloads the browser when a file behind a collection changes, for an application that runs from source with no build. It does nothing unless `remix/node-hmr` is supervising the process, so it can stay in production code. A file created after startup still needs a restart.
+- Every peer dependency is optional, `remix` included. Reading and validating data imports neither it nor `satteri`; `render()` loads Remix only when something asks for a component, and names the entry that needed it if Remix is not installed. Node `^20.19.0 || >=22.12.0`.
+- The prebuild channel, the manifest emitter, and the MDX import reader ship as `@pitlane/content/internal/prebuild`, `/internal/codegen`, and `/internal/mdx`, so a plugin for a bundler other than Vite can reuse them.

package/README.md

@@ -1,15 +1,15 @@
 # @pitlane/content
 
-Schema-validated, cross-referenced content collections for [Remix 3](https://remix.run).
+Schema-validated, cross-referenced content collections for [Remix](https://remix.run).
 
-Reads Markdown, MDX, JSON, and YAML into collections a controller queries like a
-database. Frontmatter is validated against a schema, one entry can reference
-another, and the types come from the schema rather than from generated code.
+Reads Markdown, MDX, JSON, and YAML into collections a controller queries like a database. Frontmatter is validated against a schema, one entry can reference another, and the types come from the schema rather than from generated code.
 
 ```sh
 npm install @pitlane/content
 ```
 
+Requires Node `^20.19.0 || >=22.12.0`. All three peer dependencies are optional: `remix` for `render()`, `satteri` for compiling Markdown and MDX bodies, and `vite` 8 or newer for `contentLayer()`. With a Vite build, `satteri` and `vite-plugin-satteri` are dev dependencies; without a build, `satteri` is a runtime dependency. A collection of only JSON or YAML files needs no Sätteri setup at all.
+
 ```ts
 import { createContent } from "@pitlane/content";
 import * as loaders from "@pitlane/content/loaders";
@@ -35,18 +35,17 @@ export let content = createContent(c => ({
 ```ts
 let posts = await content.blog.getCollection();
 let post = await content.blog.getEntry(params.slug);
-let { Content, headings } = await post.render();
-let author = await content.authors.getEntry(post.data.author);
+if (post) {
+    let { Content, headings } = await post.render();
+    let author = await content.authors.getEntry(post.data.author);
+}
 ```
 
-`createContent()` returns synchronously without loading entries. Import the
-returned object wherever you need it; reads and rendering stay asynchronous.
+`getEntry()` returns `undefined` when no entry has the requested ID.
+
+`createContent()` returns synchronously without loading entries. Import the returned object wherever you need it; reads and rendering stay asynchronous.
 
-The loaders are ordinary runtime code, which covers Node, Bun, Deno, and
-container hosts. For a host with no filesystem, add `contentLayer()` from
-`@pitlane/content/vite` and the build resolves the collections ahead of time,
-inlining entry data and compiling Markdown bodies into the bundle. The
-collection declarations do not change.
+The loaders are ordinary runtime code, which covers Node, Bun, Deno, and container hosts. For a host with no filesystem, add `contentLayer()` from `@pitlane/content/vite` and the build resolves the collections ahead of time, inlining entry data and compiling Markdown bodies into the bundle. The collection declarations do not change.
 
 ## Entry points
 
@@ -59,17 +58,13 @@ collection declarations do not change.
 
 ## Without Remix
 
-Every peer dependency is optional. The data path, meaning the loaders, schema
-validation, and both query methods, has no static dependency on `remix` and
-works with any [Standard Schema](https://standardschema.dev) validator. Only
-`render()` needs Remix, because it resolves to a Remix component, and it says
-so if you call it without one.
+The loaders, schema validation, and query methods work with any [Standard Schema](https://standardschema.dev) validator without importing Remix. Rendering returns a Remix component, so it requires Remix. Rendering Markdown or MDX also needs `satteri` unless `contentLayer()` compiled the collection during the build.
 
 ## Documentation
 
-- [Content](https://pitlane.tools/guides/content), whose toggle also serves
-  [an application that runs without a build](https://pitlane.tools/guides/content-no-build)
-- [Creating a content loader](https://pitlane.tools/guides/content-loaders)
+- [Content](https://pitlane.tools/guides/content), for an application with a Vite build
+- [Content (No Build)](https://pitlane.tools/guides/content-no-build), for an application that runs without one
+- [Custom loaders](https://pitlane.tools/guides/content#custom-loaders)
 - [API reference](https://pitlane.tools/package/content/)
 
 ## License

package/dist/index.mjs

@@ -280,7 +280,7 @@ function view(collection, entry) {
 		data: entry.data,
 		...entry.filePath === void 0 ? {} : { filePath: entry.filePath },
 		render: async () => {
-			return await (await import("./render-U9dXN6f0.mjs").catch((cause) => {
+			return await (await import("./render-Bg0i1C_C.mjs").catch((cause) => {
 				throw missingRenderer(`${collection}/${entry.id}`, cause) ?? cause;
 			})).renderedEntry(collection, entry);
 		}

package/dist/{render-U9dXN6f0.mjs → render-Bg0i1C_C.mjs}

@@ -222,7 +222,14 @@ async function nodeResolution() {
 async function importFrom(specifier, from, where, node, attributes) {
 	let resolved = specifier.startsWith(".") ? new URL(specifier, from).href : resolveBare(specifier, from, where, node);
 	try {
-		return await (attributes ? import(resolved, { with: attributes }) : import(resolved));
+		return await (attributes ? import(
+			/* @vite-ignore */
+			resolved,
+			{ with: attributes }
+) : import(
+			/* @vite-ignore */
+			resolved
+));
 	} catch (error) {
 		let cause = error instanceof Error ? error.message : String(error);
 		throw new Error(`"${where}" imports "${specifier}", which could not be loaded: ${cause}`, { cause: error });

package/dist/satteri.mjs

@@ -1,19 +1,40 @@
 //#region src/satteri.ts
 /**
-* The base slug for a heading with no letters or digits at all (`## ---`). An
-* empty `id` is invalid HTML and makes the anchor a bare `#`, which lands
-* nowhere; a fixed word plus the usual collision suffix keeps such headings
-* addressable and distinct.
+* The base slug for a heading that slugs to nothing at all, such as `## ***` or
+* `## 🎉`. GitHub answers the empty string there; an empty `id` is invalid HTML
+* and makes the anchor a bare `#`, which lands nowhere, so a fixed word plus
+* the usual collision suffix keeps such headings addressable and distinct. This
+* is the one case where these slugs are deliberately not GitHub's.
 */
 const FALLBACK_SLUG = "heading";
 /**
-* The slug for `text`, kept distinct from every slug `taken` already holds by
+* Every character GitHub's slugger removes: anything that is not alphabetic, a
+* combining mark, a decimal digit, connector punctuation, a space, or a hyphen.
+* Marks are kept because dropping them would shatter Devanagari, Hebrew, and
+* Arabic words into bare consonants; letters of every script are kept so a
+* Japanese or Cyrillic heading slugs to its own text rather than to nothing.
+*
+* `github-slugger` ships this set as a table generated from Unicode 13, while a
+* regular expression matches against whatever Unicode version the engine
+* carries. A character assigned after Unicode 13 therefore survives here and
+* would be stripped there; nothing assigned in Unicode 13 or earlier differs.
+*/
+const STRIPPED = /[^\p{Alphabetic}\p{M}\p{Nd}\p{Pc} -]/gu;
+/**
+* The slug for `text`, built the way GitHub builds a heading's `id`: lowercase
+* it, remove every stripped character, then turn each remaining space into a
+* hyphen. Nothing is collapsed and nothing is trimmed, so `Databases & Data
+* Loading` slugs to `databases--data-loading` and `## ---` to `---`. Astro slugs
+* with the same algorithm, so a table of contents written by hand against
+* either of them keeps landing after a move to Pitlane.
+*
+* The result is then kept distinct from every slug `taken` already holds by
 * suffixing `-1`, `-2`, … The map remembers the last suffix tried for a base so
 * a document of a hundred identical headings stays linear, and the loop covers
 * the case where the suffixed candidate is itself a real heading's slug.
 */
 function uniqueSlug(text, taken) {
-	let base = text.toLowerCase().replace(/[^\p{L}\p{N}\p{M}]+/gu, "-").replace(/^-+|-+$/g, "");
+	let base = text.toLowerCase().replace(STRIPPED, "").replaceAll(" ", "-");
 	if (!base) base = FALLBACK_SLUG;
 	let suffix = taken.get(base) ?? 0;
 	let slug = base;

package/dist/vite.mjs

@@ -225,6 +225,7 @@ async function inPrebuildServer(root, entry, resolution, onWatched) {
 		root,
 		configFile: false,
 		logLevel: "silent",
+		optimizeDeps: { noDiscovery: true },
 		resolve: resolution,
 		server: {
 			middlewareMode: true,

package/package.json

@@ -1,104 +1,102 @@
 {
-    "name": "@pitlane/content",
-    "version": "0.1.0",
-    "description": "createContent() — schema-validated, cross-referenced Markdown, MDX, and data collections for Remix 3, queryable at runtime and prebuildable into the bundle.",
-    "keywords": [
-        "content",
-        "content-collections",
-        "markdown",
-        "mdx",
-        "pitlane",
-        "remix",
-        "satteri"
-    ],
-    "homepage": "https://pitlane.tools/package/content/",
-    "bugs": {
-        "url": "https://github.com/pitlane-tools/pitlane/issues"
+  "name": "@pitlane/content",
+  "version": "0.2.0",
+  "description": "Schema-validated content collections for Remix.",
+  "keywords": [
+    "content",
+    "content-collections",
+    "markdown",
+    "mdx",
+    "pitlane",
+    "remix",
+    "satteri"
+  ],
+  "homepage": "https://pitlane.tools/package/content/",
+  "bugs": {
+    "url": "https://github.com/pitlane-tools/pitlane/issues"
+  },
+  "license": "MIT",
+  "author": "Mark Malstrom <mark@malstrom.me>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pitlane-tools/pitlane.git",
+    "directory": "packages/content"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
     },
-    "license": "MIT",
-    "author": "Mark Malstrom <mark@malstrom.me>",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/pitlane-tools/pitlane.git",
-        "directory": "packages/content"
+    "./loaders": {
+      "types": "./dist/loaders.d.mts",
+      "import": "./dist/loaders.mjs"
     },
-    "files": [
-        "dist",
-        "CHANGELOG.md"
-    ],
-    "type": "module",
-    "types": "./dist/index.d.mts",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.mts",
-            "import": "./dist/index.mjs"
-        },
-        "./loaders": {
-            "types": "./dist/loaders.d.mts",
-            "import": "./dist/loaders.mjs"
-        },
-        "./satteri": {
-            "types": "./dist/satteri.d.mts",
-            "import": "./dist/satteri.mjs"
-        },
-        "./vite": {
-            "types": "./dist/vite.d.mts",
-            "import": "./dist/vite.mjs"
-        },
-        "./hot": {
-            "types": "./dist/hot.d.mts",
-            "import": "./dist/hot.mjs"
-        },
-        "./internal/manifest": {
-            "types": "./dist/manifest.d.mts",
-            "import": "./dist/manifest.mjs"
-        },
-        "./internal/prebuild": {
-            "types": "./dist/prebuild.d.mts",
-            "import": "./dist/prebuild.mjs"
-        },
-        "./internal/codegen": {
-            "types": "./dist/codegen.d.mts",
-            "import": "./dist/codegen.mjs"
-        },
-        "./internal/mdx": {
-            "types": "./dist/mdx.d.mts",
-            "import": "./dist/mdx.mjs"
-        }
+    "./satteri": {
+      "types": "./dist/satteri.d.mts",
+      "import": "./dist/satteri.mjs"
     },
-    "scripts": {
-        "prepublishOnly": "vp run build"
+    "./vite": {
+      "types": "./dist/vite.d.mts",
+      "import": "./dist/vite.mjs"
     },
-    "dependencies": {
-        "es-module-lexer": "^2.3.1",
-        "yaml": "^2.8.1"
+    "./hot": {
+      "types": "./dist/hot.d.mts",
+      "import": "./dist/hot.mjs"
     },
-    "devDependencies": {
-        "@types/node": "^25.5.0",
-        "remix": "3.0.0-rc.2",
-        "satteri": "^0.10.5",
-        "typescript": "^7.0.2",
-        "vite": "^8.1.5",
-        "vite-plugin-satteri": "^0.3.5",
-        "vite-plus": "^0.2.6"
+    "./internal/manifest": {
+      "types": "./dist/manifest.d.mts",
+      "import": "./dist/manifest.mjs"
     },
-    "peerDependencies": {
-        "remix": "^3.0.0-rc.1",
-        "satteri": "^0.10.5",
-        "vite": ">=8.0.0"
+    "./internal/prebuild": {
+      "types": "./dist/prebuild.d.mts",
+      "import": "./dist/prebuild.mjs"
     },
-    "peerDependenciesMeta": {
-        "remix": {
-            "optional": true
-        },
-        "satteri": {
-            "optional": true
-        },
-        "vite": {
-            "optional": true
-        }
+    "./internal/codegen": {
+      "types": "./dist/codegen.d.mts",
+      "import": "./dist/codegen.mjs"
     },
-    "engines": {
-        "node": "^20.19.0 || >=22.12.0"
+    "./internal/mdx": {
+      "types": "./dist/mdx.d.mts",
+      "import": "./dist/mdx.mjs"
     }
-}
+  },
+  "dependencies": {
+    "es-module-lexer": "^2.3.1",
+    "yaml": "^2.8.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "remix": "3.0.0-rc.2",
+    "satteri": "^0.10.5",
+    "typescript": "^7.0.2",
+    "vite": "^8.1.5",
+    "vite-plugin-satteri": "^0.3.5",
+    "vite-plus": "^0.2.6"
+  },
+  "peerDependencies": {
+    "remix": "^3.0.0-rc.1",
+    "satteri": "^0.10.5",
+    "vite": ">=8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "remix": {
+      "optional": true
+    },
+    "satteri": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "scripts": {}
+}