contentbase 0.0.2 → 0.0.4

package/README.md

@@ -5,8 +5,7 @@
 Contentbase treats a folder of Markdown and MDX files as a typed, queryable database. Define models with Zod schemas, extract structured data from headings and lists, traverse parent/child relationships across documents, validate everything, and query it all with a fluent API.
 
 ```ts
-import { Collection, defineModel, section, hasMany, z } from "contentbase";
-import { toString } from "mdast-util-to-string";
+import { Collection, defineModel, section, hasMany, z, toString } from "contentbase";
 
 const Story = defineModel("Story", {
   meta: z.object({
@@ -79,14 +78,18 @@ content/
 
 A model is a config object that describes one type of document. It declares:
 
+- **description** -- human-readable summary (auto-generated from schema if omitted)
 - **meta** -- a Zod schema for frontmatter
 - **sections** -- named extractions from heading-based sections
 - **relationships** -- `hasMany` / `belongsTo` links between models
 - **computed** -- derived values calculated from instance data
+- **defaults** -- static default values for frontmatter fields
+- **pattern** -- Express-style path patterns for inferring meta from file paths
 
 ```ts
 const Epic = defineModel("Epic", {
   prefix: "epics",
+  description: "A project epic that groups related user stories.",
   meta: z.object({
     priority: z.enum(["low", "medium", "high"]).optional(),
     status: z.enum(["created", "in-progress", "complete"]).default("created"),
@@ -103,14 +106,71 @@ const Epic = defineModel("Epic", {
 });
 ```
 
+If `description` is omitted, one is generated on first access from the model's schema: *"An Epic has metadata (priority, status), relationship (stories → Story), and computed property (isComplete)."*
+
 The `prefix` determines which files match this model. Files whose path starts with `"epics"` are Epics. If omitted, the prefix is auto-pluralized from the name (`"Epic"` -> `"epics"`).
 
+#### Explicit Model Assignment with `_model`
+
+Documents at the root of a collection (not in a subfolder) can't be matched by prefix. You can explicitly assign a model by adding `_model` to the frontmatter:
+
+```yaml
+---
+_model: Epic
+title: Platform Migration
+status: created
+---
+```
+
+The `_model` key takes priority over prefix matching, so this works even if the file lives outside the model's prefix folder.
+
+#### The Base Model
+
+Every collection automatically registers a built-in `Base` model as a catch-all. Documents that don't match any other model (by `_model` or prefix) are assigned to Base. You can query these unmatched documents:
+
+```ts
+import { Base } from "contentbase";
+
+const misc = await collection.query(Base).fetchAll();
+```
+
+If you want to customize the Base model (e.g. add a meta schema), register your own before calling `load()`:
+
+```ts
+const MyBase = defineModel("Base", {
+  meta: z.object({ tags: z.array(z.string()).optional() }),
+});
+collection.register(MyBase);
+await collection.load(); // won't auto-register the built-in Base
+```
+
+#### Path Patterns
+
+Models can declare Express-style path patterns to automatically infer meta values from the document's file path:
+
+```ts
+const Story = defineModel("Story", {
+  prefix: "stories",
+  pattern: "stories/:epic/:slug",
+  meta: z.object({
+    epic: z.string(),
+    slug: z.string(),
+  }),
+});
+```
+
+A file at `stories/authentication/user-can-register.mdx` will automatically have `{ epic: "authentication", slug: "user-can-register" }` inferred into its meta. Explicit frontmatter values always take precedence over pattern-inferred values. You can also supply an array of patterns -- the first match wins.
+
 ### Collections
 
 A `Collection` loads a directory tree and gives you access to documents and typed model instances.
 
 ```ts
-const collection = new Collection({ rootPath: "./content" });
+const collection = new Collection({
+  rootPath: "./content",
+  extensions: ["mdx", "md"],   // default
+  autoDiscover: true,          // auto-load models.ts if no models registered
+});
 await collection.load();
 
 // Register models for prefix-based matching
@@ -141,8 +201,7 @@ Given this Markdown:
 Define a section to extract the list items:
 
 ```ts
-import { section } from "contentbase";
-import { toString } from "mdast-util-to-string";
+import { section, toString } from "contentbase";
 
 const Story = defineModel("Story", {
   sections: {
@@ -150,12 +209,13 @@ const Story = defineModel("Story", {
       extract: (query) =>
         query.selectAll("listItem").map((node) => toString(node)),
       schema: z.array(z.string()),
+      alternatives: ["Requirements"],  // fallback heading names
     }),
   },
 });
 ```
 
-The `extract` function receives an `AstQuery` scoped to the content under that heading. The `schema` is optional and used during validation.
+The `extract` function receives an `AstQuery` scoped to the content under that heading. The `schema` is optional and used during validation. The `alternatives` array provides fallback heading names -- if "Acceptance Criteria" isn't found, it tries "Requirements" next.
 
 Section data is **lazily computed and cached** -- the extract function only runs the first time you access the property.
 
@@ -272,6 +332,9 @@ const results = await collection
   .query(Story)
   .whereIn("meta.status", ["created", "in-progress"])
   .whereExists("meta.epic")
+  .sort("meta.status", "asc")
+  .limit(10)
+  .offset(0)
   .fetchAll();
 
 // Convenience accessors
@@ -283,6 +346,60 @@ Available operators: `eq`, `neq`, `in`, `notIn`, `gt`, `lt`, `gte`, `lte`, `cont
 
 Queries filter by model type **before** creating instances, so you only pay the parsing cost for matching documents.
 
+### JSON Query DSL
+
+For querying over the wire (REST API, MCP server) without executing arbitrary code, Contentbase provides a MongoDB-style JSON query DSL:
+
+```json
+{
+  "model": "Epic",
+  "where": {
+    "meta.status": "created",
+    "meta.priority": { "$gt": 3 }
+  },
+  "sort": { "meta.priority": "desc" },
+  "select": ["id", "title", "meta.status"],
+  "limit": 10,
+  "offset": 0
+}
+```
+
+**Where value shortcuts:**
+
+| Value type | Interpretation | Example |
+|------------|---------------|---------|
+| Literal (string, number, boolean, null) | Implicit `$eq` | `"meta.status": "active"` |
+| Array | Implicit `$in` | `"meta.tags": ["a", "b"]` |
+| Operator object | Explicit operator | `"meta.priority": { "$gt": 5 }` |
+| Multiple operators | AND on same field | `"meta.priority": { "$gte": 3, "$lte": 8 }` |
+
+**Available operators:** `$eq`, `$neq`, `$in`, `$notIn`, `$gt`, `$lt`, `$gte`, `$lte`, `$contains`, `$startsWith`, `$endsWith`, `$regex`, `$exists`
+
+**Options:**
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `model` | string | *(required)* | Model name or prefix |
+| `where` | object | -- | MongoDB-style filter conditions |
+| `sort` | object or array | -- | `{ "field": "asc"\|"desc" }` or `[{ "path": "...", "direction": "asc" }]` |
+| `select` | string[] | -- | Fields to include in output |
+| `limit` | number | -- | Maximum results to return |
+| `offset` | number | -- | Number of results to skip |
+| `method` | string | `"fetchAll"` | `"fetchAll"`, `"first"`, `"last"`, or `"count"` |
+
+Use via `POST /api/query` with a JSON body, or through the MCP `query` tool. The DSL parser is also available programmatically:
+
+```ts
+import { executeQueryDSL, queryDSLSchema } from "contentbase";
+
+const result = await executeQueryDSL(collection, {
+  model: "Epic",
+  where: { "meta.status": "created" },
+  sort: { title: "asc" },
+  limit: 5,
+});
+```
+
 ---
 
 ## Validation
@@ -489,6 +606,32 @@ collection.tableOfContents({ basePath: "./content" });
 // links become: ./content/epics/authentication.mdx
 ```
 
+### File Tree
+
+Render an ASCII file tree of all documents in the collection:
+
+```ts
+const tree = collection.renderFileTree();
+```
+
+```
+epics/
+├── authentication.mdx
+└── searching-and-browsing.mdx
+stories/
+└── authentication/
+    └── a-user-should-be-able-to-register.mdx
+```
+
+### Model Summary
+
+Generate comprehensive documentation of all registered models, including schema fields, sections, relationships, and defaults:
+
+```ts
+const summary = await collection.generateModelSummary();
+// Returns markdown documenting each model's schema, sections, relationships
+```
+
 ---
 
 ## Computed Properties
@@ -537,16 +680,141 @@ collection.use(timestampPlugin, { format: "iso" });
 
 ## CLI
 
-Contentbase ships with a CLI for common operations:
+Contentbase ships with a CLI available as both `cnotes` and `contentbase`. See [CLI.md](./CLI.md) for the full reference with examples for every command.
+
+```bash
+bun add contentbase
+
+# Then use it via bunx, or in package.json scripts
+bunx cnotes inspect
+```
+
+### Commands
+
+```bash
+cnotes init [name]                             # scaffold a new project
+cnotes create <Model> --title "..."            # scaffold a new document (uses templates if available)
+cnotes inspect                                 # show models, sections, relationships, doc counts
+cnotes validate [target]                       # validate documents ('all', a model name, or a path ID)
+cnotes export                                  # export collection as JSON
+cnotes extract <glob> --sections "A, B"        # extract specific sections from matching documents
+cnotes summary                                 # generate MODELS.md and TABLE-OF-CONTENTS.md
+cnotes teach                                   # output combined documentation for LLM context
+cnotes action <name>                           # run a named action
+cnotes text-search <pattern>                   # search file contents with pattern matching
+cnotes serve                                   # start HTTP server with REST API and doc serving
+cnotes mcp                                     # start MCP server for AI agent integration
+cnotes console                                 # interactive REPL with collection in scope
+cnotes help                                    # list available commands
+```
+
+All commands accept `--contentFolder` to specify which folder contains your content. Defaults to `./docs`. You can also set it in `package.json`:
+
+```json
+{
+  "contentbase": {
+    "contentFolder": "content"
+  }
+}
+```
+
+### serve
+
+Start an HTTP server that exposes a full REST API for the collection. Documents are available as JSON, rendered HTML, or raw markdown.
+
+```bash
+# Start on default port 8000
+cnotes serve
+
+# Custom port, specific content folder
+cnotes serve --port 9000 --contentFolder ./sdlc
+
+# Read-only mode: disables all write endpoints (POST/PUT/PATCH/DELETE)
+cnotes serve --read-only
+```
+
+**Built-in endpoints:**
+
+| Path | Description |
+|------|-------------|
+| `GET /api/inspect` | Collection overview |
+| `GET /api/models` | All model definitions |
+| `GET /api/documents` | List documents (filter with `?model=`) |
+| `GET/POST/PUT/PATCH/DELETE /api/documents/:pathId` | Document CRUD |
+| `GET /api/query?model=&where=&select=` | Query model instances (flat condition format) |
+| `POST /api/query` | Query with JSON DSL body (MongoDB-style) |
+| `GET /api/search?pattern=` | Full-text regex search across documents |
+| `GET /api/text-search?pattern=` | File-level text search (`expanded=true` for line detail) |
+| `GET /api/validate?pathId=` | Validate against schema |
+| `GET/POST /api/actions` | List or execute actions |
+| `GET /docs/:path.json\|.md\|.html` | Content-negotiated doc serving |
+| `GET /openapi.json` | Auto-generated OpenAPI 3.1 spec |
+
+When `--read-only` is passed, all mutating endpoints return `403 Forbidden`. This includes `POST /api/documents`, `PUT/PATCH/DELETE /api/documents/:pathId`, and `POST /api/actions`. Read endpoints are unaffected.
+
+You can also add your own endpoints by placing files in an `endpoints/` directory. See [CLI.md](./CLI.md#user-defined-endpoints) for details.
+
+### mcp
+
+Start a Model Context Protocol server for AI agent integration. Exposes tools, resources, and prompts for the collection.
 
 ```bash
-contentbase inspect           # show collection info
-contentbase validate          # validate all documents
-contentbase export            # export collection as JSON
-contentbase create Story      # scaffold a new document
-contentbase action publish    # run a named action
+cnotes mcp                                     # stdio transport (for Claude Desktop, etc.)
+cnotes mcp --transport http --port 3003        # HTTP transport
 ```
 
+### extract
+
+The `extract` command outputs document titles, leading content, and only the requested sections -- combined into a single document suitable for creating new content:
+
+```bash
+# Extract Acceptance Criteria from all stories
+cnotes extract "stories/**/*" --sections "Acceptance Criteria"
+
+# Combine epics into a single document with a title
+cnotes extract "epics/*" -s "Stories" --title "All Stories"
+
+# Multiple sections, include frontmatter, raw heading depths
+cnotes extract "epics/*" -s "Stories, Notes" --frontmatter --no-normalize-headings
+```
+
+Glob patterns are matched against document path IDs using [picomatch](https://github.com/micromatch/picomatch). Sections that don't exist in a document are silently skipped.
+
+By default, heading depths are normalized so each document's content nests properly in the combined output. When `--title` is provided, it becomes the h1 and document titles shift to h2. Use `--no-normalize-headings` to preserve original heading depths.
+
+### create
+
+The `create` command scaffolds new documents with smart defaults:
+
+```bash
+cnotes create Story --title "User can logout"
+cnotes create Epic --title "Payments" --meta.priority high
+```
+
+If a template exists at `templates/<model>.md` (or `.mdx`) in your content directory, it's used as the base. Meta values are merged with this priority: Zod defaults < model defaults < template frontmatter < CLI `--meta.*` flags.
+
+### Model Discovery
+
+The CLI uses a 3-tier system to find your models:
+
+**Tier 1 — `index.ts`** (recommended): If your content directory has an `index.ts` that exports a `Collection` with models registered, the CLI uses it directly. This is what `contentbase init` scaffolds.
+
+```ts
+// docs/index.ts
+import { Collection, defineModel, z } from "contentbase";
+
+const Post = defineModel("Post", {
+  meta: z.object({ draft: z.boolean().default(false) }),
+});
+
+export const collection = new Collection({ rootPath: import.meta.dir });
+collection.register(Post);
+```
+
+**Tier 2 — `models.ts`**: If no `index.ts` exists but a `models.ts` is found, the CLI imports it, detects model definitions from exports, and auto-registers them on a new Collection.
+
+**Tier 3 — Auto-discovery**: If neither file exists, the CLI scans top-level subdirectories for markdown files and generates bare models from folder names (`epics/` → `Epic`). These models have no schema validation — useful for quick inspection, but you'll want a `models.ts` or `index.ts` for real use.
+
 ---
 
 ## API Reference
@@ -557,18 +825,26 @@ contentbase action publish    # run a named action
 | --- | --- |
 | `Collection` | Loads and manages a directory of documents |
 | `Document` | A single Markdown/MDX file with AST operations |
-| `defineModel()` | Create a typed model definition |
+| `defineModel()` | Create a typed model definition (accepts optional `description`, auto-generated if omitted) |
+| `generateDescription()` | Generate a human-readable model description from its schema |
 | `section()` | Declare a section extraction |
 | `hasMany()` | Declare a one-to-many relationship |
 | `belongsTo()` | Declare a many-to-one relationship |
 | `parse()` | Parse a file path or markdown string into a queryable `ParsedDocument` |
 | `extractSections()` | Combine sections from multiple documents into one |
 | `CollectionQuery` | Fluent query builder for model instances |
+| `queryDSLSchema` | Zod schema for validating JSON query DSL input |
+| `parseWhereClause()` | Parse MongoDB-style where object into internal conditions |
+| `executeQueryDSL()` | Execute a JSON query DSL against a collection |
 | `AstQuery` | MDAST query wrapper (select, visit, find) |
 | `NodeShortcuts` | Convenience getters for common AST nodes |
 | `createModelInstance()` | Low-level factory for model instances |
 | `validateDocument()` | Standalone validation function |
+| `matchPattern()` | Express-style path pattern matching (`:param` syntax) |
+| `matchPatterns()` | Try multiple patterns against a path, first match wins |
+| `introspectMetaSchema()` | Extract field info (name, type, required, default) from a Zod schema |
 | `z` | Re-exported from Zod (no extra dependency needed) |
+| `toString` | Re-exported from `mdast-util-to-string` |
 
 ---
 

package/bun.lock

@@ -4,14 +4,16 @@
     "": {
       "name": "contentbase",
       "dependencies": {
-        "citty": "^0.1.6",
         "gray-matter": "^4.0.3",
         "js-yaml": "^4.1.0",
         "mdast-util-mdxjs-esm": "^2.0.1",
         "mdast-util-to-markdown": "^2.1.2",
         "mdast-util-to-string": "^4.0.0",
+        "picomatch": "^4.0.3",
+        "rehype-stringify": "^10.0.1",
         "remark-gfm": "^4.0.0",
         "remark-parse": "^11.0.0",
+        "remark-rehype": "^11.1.2",
         "remark-stringify": "^11.0.0",
         "unified": "^11.0.5",
         "unist-util-find-after": "^5.0.0",
@@ -25,10 +27,17 @@
       "devDependencies": {
         "@types/js-yaml": "^4.0.9",
         "@types/mdast": "^4.0.4",
+        "@types/picomatch": "^4.0.2",
         "bun-types": "^1.1.0",
         "typescript": "^5.4.0",
         "vitest": "^1.6.0",
       },
+      "peerDependencies": {
+        "@soederpop/luca": ">=0.0.1",
+      },
+      "optionalPeers": [
+        "@soederpop/luca",
+      ],
     },
   },
   "packages": {
@@ -150,8 +159,12 @@
 
     "@types/node": ["@types/node@25.2.2", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-BkmoP5/FhRYek5izySdkOneRyXYN35I860MFAGupTdebyE66uZaR+bXLHq8k4DirE5DwQi3NuhvRU1jqTVwUrQ=="],
 
+    "@types/picomatch": ["@types/picomatch@4.0.2", "", {}, "sha512-qHHxQ+P9PysNEGbALT8f8YOSHW0KJu6l2xU8DYY0fu/EmGxXdVnuTLvFUvBgPJMSqXq29SYHveejeAha+4AYgA=="],
+
     "@types/unist": ["@types/unist@3.0.3", "", {}, "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q=="],
 
+    "@ungap/structured-clone": ["@ungap/structured-clone@1.3.0", "", {}, "sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g=="],
+
     "@vitest/expect": ["@vitest/expect@1.6.1", "", { "dependencies": { "@vitest/spy": "1.6.1", "@vitest/utils": "1.6.1", "chai": "^4.3.10" } }, "sha512-jXL+9+ZNIJKruofqXuuTClf44eSpcHlgj3CiuNihUF3Ioujtmc0zIa3UJOW5RjDK1YLBJZnWBlPuqhYycLioog=="],
 
     "@vitest/runner": ["@vitest/runner@1.6.1", "", { "dependencies": { "@vitest/utils": "1.6.1", "p-limit": "^5.0.0", "pathe": "^1.1.1" } }, "sha512-3nSnYXkVkf3mXFfE7vVyPmi3Sazhb/2cfZGGs0JRzFsPFvAMBEcrweV1V1GsrstdXeKCTXlJbvnQwGWgEIHmOA=="],
@@ -186,14 +199,16 @@
 
     "character-entities": ["character-entities@2.0.2", "", {}, "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ=="],
 
+    "character-entities-html4": ["character-entities-html4@2.1.0", "", {}, "sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA=="],
+
+    "character-entities-legacy": ["character-entities-legacy@3.0.0", "", {}, "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ=="],
+
     "check-error": ["check-error@1.0.3", "", { "dependencies": { "get-func-name": "^2.0.2" } }, "sha512-iKEoDYaRmd1mxM90a2OEfWhjsjPpYPuQ+lMYsoxB126+t8fw7ySEO48nmDg5COTjxDI65/Y2OWpeEHk3ZOe8zg=="],
 
-    "citty": ["citty@0.1.6", "", { "dependencies": { "consola": "^3.2.3" } }, "sha512-tskPPKEs8D2KPafUypv2gxwJP8h/OaJmC82QQGGDQcHvXX43xF2VDACcJVmZ0EuSxkpO9Kc4MlrA3q0+FG58AQ=="],
+    "comma-separated-tokens": ["comma-separated-tokens@2.0.3", "", {}, "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg=="],
 
     "confbox": ["confbox@0.1.8", "", {}, "sha512-RMtmw0iFkeR4YV+fUOSucriAQNb9g8zFR52MWCtl+cCZOFRNL6zeB395vPzFhEjjn4fMxXudmELnl/KF/WrK6w=="],
 
-    "consola": ["consola@3.4.2", "", {}, "sha512-5IKcdX0nnYavi6G7TtOhwkYzyjfJlatbjMjuLSfE2kYT5pMDOilZ4OvMhi637CcDICTmz3wARPoyhqyX1Y+XvA=="],
-
     "cross-spawn": ["cross-spawn@7.0.6", "", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA=="],
 
     "css-selector-parser": ["css-selector-parser@3.3.0", "", {}, "sha512-Y2asgMGFqJKF4fq4xHDSlFYIkeVfRsm69lQC1q9kbEsH5XtnINTMrweLkjYMeaUgiXBy/uvKeO/a1JHTNnmB2g=="],
@@ -232,6 +247,12 @@
 
     "gray-matter": ["gray-matter@4.0.3", "", { "dependencies": { "js-yaml": "^3.13.1", "kind-of": "^6.0.2", "section-matter": "^1.0.0", "strip-bom-string": "^1.0.0" } }, "sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q=="],
 
+    "hast-util-to-html": ["hast-util-to-html@9.0.5", "", { "dependencies": { "@types/hast": "^3.0.0", "@types/unist": "^3.0.0", "ccount": "^2.0.0", "comma-separated-tokens": "^2.0.0", "hast-util-whitespace": "^3.0.0", "html-void-elements": "^3.0.0", "mdast-util-to-hast": "^13.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0", "stringify-entities": "^4.0.0", "zwitch": "^2.0.4" } }, "sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw=="],
+
+    "hast-util-whitespace": ["hast-util-whitespace@3.0.0", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw=="],
+
+    "html-void-elements": ["html-void-elements@3.0.0", "", {}, "sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg=="],
+
     "human-signals": ["human-signals@5.0.0", "", {}, "sha512-AXcZb6vzzrFAUE61HnN4mpLqd/cSIwNQjtNWR0euPm6y0iqx3G4gOXaIDdtdDwZmhwe82LA6+zinmW4UBWVePQ=="],
 
     "is-extendable": ["is-extendable@0.1.1", "", {}, "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw=="],
@@ -278,6 +299,8 @@
 
     "mdast-util-phrasing": ["mdast-util-phrasing@4.1.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "unist-util-is": "^6.0.0" } }, "sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w=="],
 
+    "mdast-util-to-hast": ["mdast-util-to-hast@13.2.1", "", { "dependencies": { "@types/hast": "^3.0.0", "@types/mdast": "^4.0.0", "@ungap/structured-clone": "^1.0.0", "devlop": "^1.0.0", "micromark-util-sanitize-uri": "^2.0.0", "trim-lines": "^3.0.0", "unist-util-position": "^5.0.0", "unist-util-visit": "^5.0.0", "vfile": "^6.0.0" } }, "sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA=="],
+
     "mdast-util-to-markdown": ["mdast-util-to-markdown@2.1.2", "", { "dependencies": { "@types/mdast": "^4.0.0", "@types/unist": "^3.0.0", "longest-streak": "^3.0.0", "mdast-util-phrasing": "^4.0.0", "mdast-util-to-string": "^4.0.0", "micromark-util-classify-character": "^2.0.0", "micromark-util-decode-string": "^2.0.0", "unist-util-visit": "^5.0.0", "zwitch": "^2.0.0" } }, "sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA=="],
 
     "mdast-util-to-string": ["mdast-util-to-string@4.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0" } }, "sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg=="],
@@ -364,18 +387,26 @@
 
     "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
 
+    "picomatch": ["picomatch@4.0.3", "", {}, "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q=="],
+
     "pkg-types": ["pkg-types@1.3.1", "", { "dependencies": { "confbox": "^0.1.8", "mlly": "^1.7.4", "pathe": "^2.0.1" } }, "sha512-/Jm5M4RvtBFVkKWRu2BLUTNP8/M2a+UwuAX+ae4770q1qVGtfjG+WTCupoZixokjmHiry8uI+dlY8KXYV5HVVQ=="],
 
     "postcss": ["postcss@8.5.6", "", { "dependencies": { "nanoid": "^3.3.11", "picocolors": "^1.1.1", "source-map-js": "^1.2.1" } }, "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg=="],
 
     "pretty-format": ["pretty-format@29.7.0", "", { "dependencies": { "@jest/schemas": "^29.6.3", "ansi-styles": "^5.0.0", "react-is": "^18.0.0" } }, "sha512-Pdlw/oPxN+aXdmM9R00JVC9WVFoCLTKJvDVLgmJ+qAffBMxsV85l/Lu7sNx4zSzPyoL2euImuEwHhOXdEgNFZQ=="],
 
+    "property-information": ["property-information@7.1.0", "", {}, "sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ=="],
+
     "react-is": ["react-is@18.3.1", "", {}, "sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg=="],
 
+    "rehype-stringify": ["rehype-stringify@10.0.1", "", { "dependencies": { "@types/hast": "^3.0.0", "hast-util-to-html": "^9.0.0", "unified": "^11.0.0" } }, "sha512-k9ecfXHmIPuFVI61B9DeLPN0qFHfawM6RsuX48hoqlaKSF61RskNjSm1lI8PhBEM0MRdLxVVm4WmTqJQccH9mA=="],
+
     "remark-gfm": ["remark-gfm@4.0.1", "", { "dependencies": { "@types/mdast": "^4.0.0", "mdast-util-gfm": "^3.0.0", "micromark-extension-gfm": "^3.0.0", "remark-parse": "^11.0.0", "remark-stringify": "^11.0.0", "unified": "^11.0.0" } }, "sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg=="],
 
     "remark-parse": ["remark-parse@11.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "mdast-util-from-markdown": "^2.0.0", "micromark-util-types": "^2.0.0", "unified": "^11.0.0" } }, "sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA=="],
 
+    "remark-rehype": ["remark-rehype@11.1.2", "", { "dependencies": { "@types/hast": "^3.0.0", "@types/mdast": "^4.0.0", "mdast-util-to-hast": "^13.0.0", "unified": "^11.0.0", "vfile": "^6.0.0" } }, "sha512-Dh7l57ianaEoIpzbp0PC9UKAdCSVklD8E5Rpw7ETfbTl3FqcOOgq5q2LVDhgGCkaBv7p24JXikPdvhhmHvKMsw=="],
+
     "remark-stringify": ["remark-stringify@11.0.0", "", { "dependencies": { "@types/mdast": "^4.0.0", "mdast-util-to-markdown": "^2.0.0", "unified": "^11.0.0" } }, "sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw=="],
 
     "rollup": ["rollup@4.57.1", "", { "dependencies": { "@types/estree": "1.0.8" }, "optionalDependencies": { "@rollup/rollup-android-arm-eabi": "4.57.1", "@rollup/rollup-android-arm64": "4.57.1", "@rollup/rollup-darwin-arm64": "4.57.1", "@rollup/rollup-darwin-x64": "4.57.1", "@rollup/rollup-freebsd-arm64": "4.57.1", "@rollup/rollup-freebsd-x64": "4.57.1", "@rollup/rollup-linux-arm-gnueabihf": "4.57.1", "@rollup/rollup-linux-arm-musleabihf": "4.57.1", "@rollup/rollup-linux-arm64-gnu": "4.57.1", "@rollup/rollup-linux-arm64-musl": "4.57.1", "@rollup/rollup-linux-loong64-gnu": "4.57.1", "@rollup/rollup-linux-loong64-musl": "4.57.1", "@rollup/rollup-linux-ppc64-gnu": "4.57.1", "@rollup/rollup-linux-ppc64-musl": "4.57.1", "@rollup/rollup-linux-riscv64-gnu": "4.57.1", "@rollup/rollup-linux-riscv64-musl": "4.57.1", "@rollup/rollup-linux-s390x-gnu": "4.57.1", "@rollup/rollup-linux-x64-gnu": "4.57.1", "@rollup/rollup-linux-x64-musl": "4.57.1", "@rollup/rollup-openbsd-x64": "4.57.1", "@rollup/rollup-openharmony-arm64": "4.57.1", "@rollup/rollup-win32-arm64-msvc": "4.57.1", "@rollup/rollup-win32-ia32-msvc": "4.57.1", "@rollup/rollup-win32-x64-gnu": "4.57.1", "@rollup/rollup-win32-x64-msvc": "4.57.1", "fsevents": "~2.3.2" }, "bin": { "rollup": "dist/bin/rollup" } }, "sha512-oQL6lgK3e2QZeQ7gcgIkS2YZPg5slw37hYufJ3edKlfQSGGm8ICoxswK15ntSzF/a8+h7ekRy7k7oWc3BQ7y8A=="],
@@ -392,12 +423,16 @@
 
     "source-map-js": ["source-map-js@1.2.1", "", {}, "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA=="],
 
+    "space-separated-tokens": ["space-separated-tokens@2.0.2", "", {}, "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q=="],
+
     "sprintf-js": ["sprintf-js@1.0.3", "", {}, "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g=="],
 
     "stackback": ["stackback@0.0.2", "", {}, "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw=="],
 
     "std-env": ["std-env@3.10.0", "", {}, "sha512-5GS12FdOZNliM5mAOxFRg7Ir0pWz8MdpYm6AY6VPkGpbA7ZzmbzNcBJQ0GPvvyWgcY7QAhCgf9Uy89I03faLkg=="],
 
+    "stringify-entities": ["stringify-entities@4.0.4", "", { "dependencies": { "character-entities-html4": "^2.0.0", "character-entities-legacy": "^3.0.0" } }, "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg=="],
+
     "strip-bom-string": ["strip-bom-string@1.0.0", "", {}, "sha512-uCC2VHvQRYu+lMh4My/sFNmF2klFymLX1wHJeXnbEJERpV/ZsVuonzerjfrGpIGF7LBVa1O7i9kjiWvJiFck8g=="],
 
     "strip-final-newline": ["strip-final-newline@3.0.0", "", {}, "sha512-dOESqjYr96iWYylGObzd39EuNTa5VJxyvVAEm5Jnh7KGo75V43Hk1odPQkNDyXNmUR6k+gEiDVXnjB8HJ3crXw=="],
@@ -410,6 +445,8 @@
 
     "tinyspy": ["tinyspy@2.2.1", "", {}, "sha512-KYad6Vy5VDWV4GH3fjpseMQ/XU2BhIYP7Vzd0LG44qRWm/Yt2WCOTicFdvmgo6gWaqooMQCawTtILVQJupKu7A=="],
 
+    "trim-lines": ["trim-lines@3.0.1", "", {}, "sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg=="],
+
     "trough": ["trough@2.2.0", "", {}, "sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw=="],
 
     "type-detect": ["type-detect@4.1.0", "", {}, "sha512-Acylog8/luQ8L7il+geoSxhEkazvkslg7PSNKOX59mbB9cOveP5aq9h74Y7YU8yDpJwetzQQrfIwtf4Wp4LKcw=="],
@@ -432,6 +469,8 @@
 
     "unist-util-is": ["unist-util-is@6.0.1", "", { "dependencies": { "@types/unist": "^3.0.0" } }, "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g=="],
 
+    "unist-util-position": ["unist-util-position@5.0.0", "", { "dependencies": { "@types/unist": "^3.0.0" } }, "sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA=="],
+
     "unist-util-select": ["unist-util-select@5.1.0", "", { "dependencies": { "@types/unist": "^3.0.0", "css-selector-parser": "^3.0.0", "devlop": "^1.1.0", "nth-check": "^2.0.0", "zwitch": "^2.0.0" } }, "sha512-4A5mfokSHG/rNQ4g7gSbdEs+H586xyd24sdJqF1IWamqrLHvYb+DH48fzxowyOhOfK7YSqX+XlCojAyuuyyT2A=="],
 
     "unist-util-stringify-position": ["unist-util-stringify-position@4.0.0", "", { "dependencies": { "@types/unist": "^3.0.0" } }, "sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ=="],