@jaamd/astro 0.0.0-stage → 1.0.0-rc.1

package/docs/04-styling/01-variables.md

@@ -0,0 +1,87 @@
+---
+description: The --jaamd-* CSS custom properties that drive every JAAMD style.
+---
+
+# Variables
+
+All styles are driven by CSS custom properties prefixed with `--jaamd-`. The
+default set, `@jaamd/astro/default.css`, is injected automatically.
+
+## Colours
+
+Four seeds set most of the palette:
+
+```css
+:root {
+    --jaamd-bg: #ffffff;
+    --jaamd-color-fg: #3a3a3a;
+    --jaamd-color-fg-bright: #1a1a1a;
+    --jaamd-color-primary: #3b5bdb;
+}
+```
+
+Surfaces, borders and the table-of-contents card are derived from them with
+`color-mix()`, supported in Chrome and Edge 111+, Safari 16.2+ and Firefox
+113+. Override any variable on `:root` in your own stylesheet; for example:
+
+```css
+:root {
+    --jaamd-color-primary-light: #818cf8;
+    --jaamd-font-mono: ui-monospace, monospace;
+}
+```
+
+Defaults live in `@layer jaamd.defaults`, so an unlayered `:root` block always
+wins regardless of import order.
+
+See [`variables.css`](https://github.com/jaamd/jaamd/blob/main/packages/core/src/styles/variables.css)
+for all 60 variables and their default values.
+
+## Font sizes
+
+`--jaamd-font-size` is the one knob for the whole document. Every other size is
+derived from it, so moving it moves the entire scale in proportion:
+
+```css
+:root {
+    --jaamd-font-size: 1rem; /* headings, code, tables… all follow */
+}
+```
+
+To break a single element out of that scale, set its own token. Each is read
+with the derived value as its fallback, so **an unset token changes nothing**;
+they are opt-in, one at a time:
+
+```css
+:root {
+    --jaamd-font-size: 1rem; /* the baseline */
+    --jaamd-font-size-h1: 2.5rem; /* but h1 is fixed, not proportional */
+    --jaamd-font-size-code-block: 0.8rem; /* and code blocks are tighter */
+}
+```
+
+| Token                           | Applies to                         | Default when unset                       |
+| ------------------------------- | ---------------------------------- | ---------------------------------------- |
+| `--jaamd-font-size-h1` … `-h4`  | `h1`–`h4`                          | `2.22` / `1.67` / `1.33` / `1.11` × base |
+| `--jaamd-font-size-h5`, `-h6`   | `h5`, `h6`                         | base                                     |
+| `--jaamd-font-size-p`, `-li`    | paragraphs, list items             | base                                     |
+| `--jaamd-font-size-blockquote`  | `blockquote`, contents included    | base                                     |
+| `--jaamd-font-size-code`        | inline `` `code` ``                | `0.78` × base                            |
+| `--jaamd-font-size-code-block`  | fenced code blocks                 | `0.85` × base                            |
+| `--jaamd-font-size-table`       | `th` and `td` together             | `0.78` × base                            |
+| `--jaamd-font-size-summary`     | `<details>` summary                | `0.89` × base                            |
+| `--jaamd-font-size-alert-title` | alert titles                       | `0.83` × base                            |
+| `--jaamd-font-size-toc`         | `:::toc` block, contents included  | `0.94` × base                            |
+| `--jaamd-font-size-toc-title`   | `:::toc` title                     | `0.83` × base                            |
+| `--jaamd-font-size-footnotes`   | footnotes block, contents included | `0.85` × base                            |
+
+A block that owns a token governs what is inside it: paragraphs in a blockquote
+follow `-blockquote`, not `-p`. Alert bodies have no token of their own and
+follow `-p`; only their title is separate. The copy button, code-tab labels and
+heading-link icons stay tied to `--jaamd-font-size`: they are JAAMD's chrome,
+not your document's typography.
+
+## Dark mode
+
+The default set includes dark-mode overrides activated by the `dark` class on
+`<html>`. Toggle the class and all JAAMD elements adapt.

package/docs/04-styling/02-themes.md

@@ -0,0 +1,90 @@
+---
+description: Eight theme presets for JAAMD, and dual light and dark code themes.
+---
+
+# Themes
+
+A theme is a palette for the `--jaamd-*` variables, paired with a Shiki theme
+for the code blocks.
+
+## Theme presets
+
+Eight presets restyle the `--jaamd-*` palette to match popular editor colour
+schemes. A **dual** preset carries a light and a dark palette and follows
+`html.dark`; the others are one palette that applies in both modes.
+
+| Preset         | Import                                   | Kind | Recommended Shiki theme                        |
+| -------------- | ---------------------------------------- | ---- | ---------------------------------------------- |
+| Catppuccin     | `@jaamd/astro/themes/catppuccin.css`     | dual | `catppuccin-latte` / `catppuccin-mocha`        |
+| Dracula        | `@jaamd/astro/themes/dracula.css`        | dark | `dracula`                                      |
+| Gruvbox        | `@jaamd/astro/themes/gruvbox.css`        | dual | `gruvbox-light-medium` / `gruvbox-dark-medium` |
+| Nord           | `@jaamd/astro/themes/nord.css`           | dark | `nord`                                         |
+| One Dark       | `@jaamd/astro/themes/one-dark.css`       | dark | `one-dark-pro`                                 |
+| Rosé Pine      | `@jaamd/astro/themes/rose-pine.css`      | dual | `rose-pine-dawn` / `rose-pine`                 |
+| Rosé Pine Moon | `@jaamd/astro/themes/rose-pine-moon.css` | dual | `rose-pine-dawn` / `rose-pine-moon`            |
+| Tokyo Night    | `@jaamd/astro/themes/tokyo-night.css`    | dark | `tokyo-night`                                  |
+
+As a standalone theme, replacing the default light theme:
+
+```ts
+jaamd({ theme: 'dracula' })
+```
+
+```css
+@import '@jaamd/astro/default.css';
+@import '@jaamd/astro/themes/dracula.css';
+@import '@jaamd/astro/styles.css';
+```
+
+A single-palette preset can also be scoped to `html.dark` via the `/dark`
+variant, to use it as the dark half of your own light theme. Dual presets
+already cover both modes and have no `/dark`:
+
+```css
+@import '@jaamd/astro/themes/dracula/dark.css';
+```
+
+```ts
+import '@jaamd/astro/themes/dracula/dark.css'
+```
+
+> [!IMPORTANT]
+> A preset declares a palette, not the whole variable set: surfaces, borders and
+> the table-of-contents card are derived from it by `default.css`. Load the
+> defaults alongside it. Do **not** pair a preset with `defaultVariables: false`: those
+> derived tokens fall back to the light palette.
+
+Each theme declares itself, so a picker can be built from data:
+
+```ts
+import { themes } from '@jaamd/astro/themes'
+// [{ slug: "dracula", name: "Dracula", mode: "dark", shiki: "dracula" }, …]
+```
+
+Each preset is generated from a `palette.js` of fourteen colours, so every theme
+declares the same token set. The `.css` files are build output: to customise a
+preset, copy its directory and edit the palette. To add one, see
+[CONTRIBUTING.md](https://github.com/jaamd/jaamd/blob/main/CONTRIBUTING.md#themes).
+
+## Dual-theme Shiki
+
+Pass an object to `theme` to highlight code with two colour schemes, switched by
+the `dark` class:
+
+```ts
+jaamd({
+    theme: { light: 'github-light', dark: 'github-dark' },
+})
+```
+
+Add an inline script in `<head>` to prevent a flash of the wrong theme:
+
+```html
+<script is:inline>
+    ;(function () {
+        var t = localStorage.getItem('theme')
+        if (t === 'dark' || (!t && matchMedia('(prefers-color-scheme: dark)').matches))
+            document.documentElement.classList.add('dark')
+    })()
+</script>
+```

package/docs/04-styling/03-markup.md

@@ -0,0 +1,29 @@
+---
+description: The HTML and classes JAAMD emits, for styling them or writing a wrapper of your own.
+---
+
+# Markup and classes
+
+What JAAMD emits, for styling it or writing a custom wrapper. _Build_ markup is
+in the HTML from the markdown processor; _client_ markup is added at runtime by
+the [client script](../03-usage/02-client.md).
+
+The markup and its classes are the public contract: the stylesheets, the themes
+and the client script all rely on them. Every class starts with `jaamd-`,
+except the alerts, which keep the names GitHub gives them.
+
+| Feature           | Elements                                                                                                                     | Attributes and states                                                              | From                                                 |
+| ----------------- | ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------- |
+| Wrapper           | `.jaamd-content`                                                                                                             | —                                                                                  | `<MarkdownContent>` or your own                      |
+| Heading anchor    | `a.jaamd-heading-link`, last child of `h1`–`h6`                                                                              | `href="#<id>"`, `aria-label`                                                       | build; client where the build did not                |
+| Table wrapper     | `div.jaamd-table-wrapper` around `table`                                                                                     | —                                                                                  | build; client where the build did not                |
+| Alert             | `div.markdown-alert.markdown-alert-<type>`, type `note`, `tip`, `important`, `warning` or `caution`                          | `dir="auto"`                                                                       | build                                                |
+| Alert title       | `p.markdown-alert-title` with an `svg.octicon`                                                                               | —                                                                                  | build                                                |
+| Code tabs         | `div.jaamd-code-tabs#jaamd-tabs-<hash>` › `div.jaamd-code-tab-buttons[role=tablist]` › `button.jaamd-code-tab-btn[role=tab]` | `aria-selected`, roving `tabindex`, `data-tab-index`, `aria-controls`              | build; `data-tabs-init` on the group from the client |
+| Code tab panel    | `div.jaamd-code-tab-panel[role=tabpanel]` wrapping the `pre`                                                                 | `data-active` on the open one, `data-tab-index`, `aria-labelledby`                 | build                                                |
+| Table of contents | `nav.jaamd-toc` › optional `p.jaamd-toc-title`, then your list                                                               | `aria-label`; the current link gets `aria-current="location"`                      | build; current link from the client                  |
+| Copy button       | `button.jaamd-copy-btn`, last child of `pre`, with `svg.jaamd-copy-icon` and `svg.jaamd-copied-icon`                         | `data-copied="true"` after a copy, `"manual"` when the code was selected instead   | client                                               |
+| Announcements     | `div#jaamd-live.jaamd-live[role=status]` in `body`                                                                           | —                                                                                  | client                                               |
+| Lightbox trigger  | `button.jaamd-lightbox-trigger` around each `img`                                                                            | `commandfor="jaamd-lightbox"`, `command="show-modal"`                              | client                                               |
+| Lightbox          | `dialog#jaamd-lightbox.jaamd-lightbox` in `body`, with `img.jaamd-lightbox-img` and `button.jaamd-lightbox-close`            | `closedby="any"`, `[open]`                                                         | client                                               |
+| Spoiler           | `span.jaamd-spoiler` from `:spoiler[…]`, `div.jaamd-spoiler` from `:::spoiler`                                               | `data-revealed`, `role="button"`, `tabindex`, `aria-expanded`, `data-spoiler-init` | build; states from the client                        |

package/docs/05-advanced/01-manual-setup.md

@@ -0,0 +1,72 @@
+---
+description: Register the JAAMD plugins on the Markdown processor yourself, without the integration.
+---
+
+# Manual setup
+
+To bypass the integration, register the plugins yourself on the processor you
+use. `@jaamd/astro` exports them as presets, in the order they have to run and
+with Astro's own heading ids. On Sätteri, Astro's default:
+
+```ts
+// astro.config.mjs
+import { satteri } from '@astrojs/markdown-satteri'
+import { satteriPlugins } from '@jaamd/astro'
+
+export default defineConfig({
+    markdown: {
+        processor: satteri(satteriPlugins()),
+    },
+})
+```
+
+On unified:
+
+```ts
+// astro.config.mjs
+import { unified } from '@astrojs/markdown-remark'
+import { unifiedPlugins } from '@jaamd/astro'
+
+export default defineConfig({
+    markdown: {
+        processor: unified(unifiedPlugins()),
+    },
+})
+```
+
+Both take the integration's [`features` and `labels`](../01-getting-started/02-options.md#features).
+To add plugins of your own, spread the preset's lists: on Sätteri, keep
+`jaamd-directive-fallback`, the last mdast plugin, after yours, since it keeps
+directives no plugin claimed. The plugins one by one are in `@jaamd/core`, see
+[Other frameworks](./03-other-frameworks.md).
+
+Then load the styles and run the client script yourself, with the same
+`features` and `labels` if you set them:
+
+```astro
+---
+import '@jaamd/astro/default.css' // variable fallbacks; omit if you provide your own
+import '@jaamd/astro/styles.css'
+---
+
+<div class="jaamd-content">
+    <slot />
+</div>
+<script>
+    import { enhance } from '@jaamd/astro/client'
+    let dispose
+    function run() {
+        dispose?.()
+        dispose = enhance('.jaamd-content')
+    }
+    run()
+    document.addEventListener('astro:page-load', run)
+</script>
+```
+
+The CSS files can also be imported from plain `.css`:
+
+```css
+@import '@jaamd/astro/default.css';
+@import '@jaamd/astro/styles.css';
+```

package/docs/05-advanced/02-frontmatter.md

@@ -0,0 +1,20 @@
+---
+description: frontmatterFields(), the frontmatter schema JAAMD sites share.
+---
+
+# Frontmatter fields
+
+`frontmatterFields(z)` returns the fields JAAMD sites share, as a plain object
+to spread into a content collection schema: `title`, `description`, `draft`,
+`keywords`, `author`, `ogImage` and `lastUpdated`.
+
+```ts
+// src/content.config.ts
+import { frontmatterFields } from '@jaamd/astro/frontmatter'
+import { z } from 'astro/zod'
+
+const schema = z.object({
+    ...frontmatterFields(z),
+    order: z.number().int().optional(),
+})
+```

package/docs/05-advanced/03-other-frameworks.md

@@ -0,0 +1,111 @@
+---
+description: Use @jaamd/core, the compiled framework-free part of JAAMD, with any framework.
+---
+
+# Other frameworks
+
+`@jaamd/core` is the part of JAAMD with no framework around it: the markdown
+plugins, the client script, the stylesheets and the themes. `@jaamd/astro`
+registers all of it; install core directly to bring JAAMD to another framework.
+
+:::code-tabs
+
+```bash npm
+npm install @jaamd/core
+```
+
+```bash pnpm
+pnpm add @jaamd/core
+```
+
+```bash yarn
+yarn add @jaamd/core
+```
+
+```bash bun
+bun add @jaamd/core
+```
+
+:::
+
+The package ships compiled JavaScript with its types: it loads in Node and in any bundler.
+
+## Entry points
+
+| Import                                                                | What                                                           |
+| --------------------------------------------------------------------- | -------------------------------------------------------------- |
+| `@jaamd/core/unified`                                                 | remark and rehype plugins                                      |
+| `@jaamd/core/satteri`                                                 | Sätteri mdast and hast plugins                                 |
+| `@jaamd/core/client`                                                  | `enhance(root, options)` and `DEFAULT_SELECTOR`                |
+| `@jaamd/core/styles.css`                                              | The stylesheet                                                 |
+| `@jaamd/core/default.css`                                             | Fallback values of the CSS variables                           |
+| `@jaamd/core/shiki-dual.css`                                          | Light and dark code colours for a dual Shiki theme             |
+| `@jaamd/core/themes`                                                  | The list of themes: slug, name, mode and matching Shiki theme  |
+| `@jaamd/core/themes/<slug>.css`, `@jaamd/core/themes/<slug>/dark.css` | A theme, and its `html.dark` variant for single-palette themes |
+
+## Plugins
+
+`unifiedPlugins()` returns the remark and rehype plugins in the order they have
+to run:
+
+```ts
+import { unifiedPlugins } from '@jaamd/core/unified'
+import rehypeSlug from 'rehype-slug'
+import rehypeStringify from 'rehype-stringify'
+import remarkParse from 'remark-parse'
+import remarkRehype from 'remark-rehype'
+import { unified } from 'unified'
+
+const { remarkPlugins, rehypePlugins } = unifiedPlugins({ headingIds: rehypeSlug })
+
+const html = await unified()
+    .use(remarkParse)
+    .use(remarkPlugins)
+    .use(remarkRehype, { allowDangerousHtml: true })
+    .use(rehypePlugins)
+    .use(rehypeStringify, { allowDangerousHtml: true })
+    .process(source)
+```
+
+`satteriPlugins()` does the same for Sätteri, parser features included:
+
+```ts
+import { satteriPlugins } from '@jaamd/core/satteri'
+import { markdownToHtml } from 'satteri'
+
+const html = await markdownToHtml(source, satteriPlugins({ headingIds }))
+```
+
+Heading links are added to headings that have an `id`. Core assigns none:
+`headingIds` is the plugin that does, placed before the links. Both entry
+points also export each plugin on its own.
+
+### Options
+
+Both functions, and `enhance()` below, take the
+[`features`](../01-getting-started/02-options.md#features) and
+[`labels`](../01-getting-started/02-options.md#labels) options of the Astro
+integration: `features` turns a feature off, `labels` replaces the English
+strings JAAMD writes. Pass the same values to the build and to `enhance()`.
+
+## Client and styles
+
+Load `default.css` and `styles.css`, wrap the rendered HTML in an element with
+the `jaamd-content` class, and call `enhance()` once the HTML is in the page:
+
+```ts
+import { enhance } from '@jaamd/core/client'
+
+const dispose = enhance(element)
+```
+
+`enhance()` takes an element, or a selector for every wrapper on the page
+(`.jaamd-content` by default). It returns a cleanup that releases the listeners
+and observers it holds: call it before the markup is replaced. In React:
+
+```tsx
+useEffect(() => enhance(ref.current), [html])
+```
+
+The markup the plugins emit is listed in
+[Markup and classes](../04-styling/03-markup.md).

package/docs/06-upgrading.md

@@ -0,0 +1,156 @@
+---
+description: The changes that need action, by the JAAMD version you upgrade from.
+---
+
+# Upgrading
+
+Upgrade the integration, then read below the changes since the version you
+upgrade from:
+
+:::code-tabs
+
+```bash npm
+npm install @jaamd/astro@latest
+```
+
+```bash pnpm
+pnpm add @jaamd/astro@latest
+```
+
+```bash yarn
+yarn add @jaamd/astro@latest
+```
+
+```bash bun
+bun add @jaamd/astro@latest
+```
+
+:::
+
+## From 0.11
+
+### The package is now @jaamd/astro
+
+`@lancher-dev/jaamd` is now `@jaamd/astro`. Replace the dependency, then the
+package name in every import. `@lancher-dev/jaamd` is deprecated and receives
+no further releases.
+
+:::code-tabs
+
+```bash npm
+npm uninstall @lancher-dev/jaamd
+npm install @jaamd/astro
+```
+
+```bash pnpm
+pnpm remove @lancher-dev/jaamd
+pnpm add @jaamd/astro
+```
+
+```bash yarn
+yarn remove @lancher-dev/jaamd
+yarn add @jaamd/astro
+```
+
+```bash bun
+bun remove @lancher-dev/jaamd
+bun add @jaamd/astro
+```
+
+:::
+
+`@jaamd/jaamd` 0.12 was 0.11 under the new scope, and is deprecated too: from
+it, replace `@jaamd/jaamd` the same way and follow the rest of this section.
+
+### Stylesheets are imported with their extension
+
+| Before                 | After                                 |
+| ---------------------- | ------------------------------------- |
+| `…/default`            | `@jaamd/astro/default.css`            |
+| `…/styles`             | `@jaamd/astro/styles.css`             |
+| `…/shiki-dual`         | `@jaamd/astro/shiki-dual.css`         |
+| `…/themes/<slug>`      | `@jaamd/astro/themes/<slug>.css`      |
+| `…/themes/<slug>/dark` | `@jaamd/astro/themes/<slug>/dark.css` |
+
+### Classes
+
+Every class JAAMD emits now starts with `jaamd-`, and states are attributes.
+Update CSS of your own that selects on the old names:
+
+| Before                                           | After                                                              |
+| ------------------------------------------------ | ------------------------------------------------------------------ |
+| `.code-tabs`                                     | `.jaamd-code-tabs`                                                 |
+| `.code-tab-buttons`                              | `.jaamd-code-tab-buttons`                                          |
+| `.code-tab-btn`, `.code-tab-btn.active`          | `.jaamd-code-tab-btn`, `.jaamd-code-tab-btn[aria-selected='true']` |
+| `.code-tab-panel`, `.code-tab-panel.active`      | `.jaamd-code-tab-panel`, `.jaamd-code-tab-panel[data-active]`      |
+| `.spoiler`, `.spoiler.revealed`                  | `.jaamd-spoiler`, `.jaamd-spoiler[data-revealed]`                  |
+| `.jaamd-lightbox__img`, `.jaamd-lightbox__close` | `.jaamd-lightbox-img`, `.jaamd-lightbox-close`                     |
+
+The alert classes (`markdown-alert`, `markdown-alert-title`) are unchanged.
+
+### Spoilers
+
+`<span class="spoiler">` is no longer a spoiler. Write `:spoiler[text]`, or
+change the class to `jaamd-spoiler`.
+
+### Client script
+
+`initMarkdownEnhancements(selector)` is now `enhance(root, options)`, which
+returns a cleanup. See [Client script](./03-usage/02-client.md).
+
+### Options
+
+| Before                      | After                         |
+| --------------------------- | ----------------------------- |
+| `noDefault: true`           | `defaultVariables: false`     |
+| `plugins: { … }`            | `features: { … }`             |
+| `plugins: { directive: … }` | `features: { directives: … }` |
+
+`features` also turns off what runs only in the browser: `copyButtons`,
+`lightbox`, and the client part of the others. `labels` is new: see
+[Options](./01-getting-started/02-options.md#labels).
+
+The options type is exported as `JaamdOptions` only: the `Options` alias is
+gone.
+
+### Manual setup
+
+`@jaamd/astro` no longer exports the plugins one by one. Use its presets,
+`satteriPlugins()` and `unifiedPlugins()`, which also add Astro's heading ids:
+see [Manual setup](./05-advanced/01-manual-setup.md). The single plugins are in
+`@jaamd/core`.
+
+## From 0.10
+
+- `theme` no longer overrides `markdown.shikiConfig`. Unset, your Shiki
+  configuration stays; `"github-light"` replaces only Astro's own default.
+- `@astrojs/markdown-remark` is an optional peer dependency. Install it when you
+  use `unified()`, which you import from it anyway.
+- Code-tab ids are `jaamd-tabs-<hash>`, unique across every document on a page,
+  instead of `jaamd-tabs-<n>`.
+- Lightbox images are wrapped in `<button class="jaamd-lightbox-trigger">`, so
+  they open from the keyboard. `img.jaamd-lightbox-enabled` is gone. See
+  [Image lightbox](./03-usage/02-client.md#image-lightbox) for browser
+  support.
+- With a manual `unified()` setup, register Astro's `rehypeHeadingIds` before
+  `rehypeHeadingLinks`, which now reads the ids instead of computing them.
+  See [Manual setup](./05-advanced/01-manual-setup.md).
+- Blockquote, alert, `h2` and `hr` borders are drawn without a CSS reset.
+- Heading anchors are always visible below 600px, as intended.
+
+## From 0.9
+
+- jaamd no longer switches the markdown processor. With no configuration you
+  are on Sätteri.
+- Set `markdown.processor: unified()` to stay on unified.
+- `markdown.remarkPlugins` and `markdown.rehypePlugins` still work: Astro moves
+  to unified, jaamd adds its remark plugins.
+- Astro `^7.3.0` is required.
+- Heading anchors are plain links: a click navigates, nothing is copied.
+- Table wrappers and heading anchors are in the built HTML. Turn them off with
+  `plugins: { tables: false, headingLinks: false }`.
+- The lightbox is a `<dialog class="jaamd-lightbox">`. `.jaamd-lightbox__backdrop`,
+  `.jaamd-lightbox__content` and `.jaamd-lightbox--hidden` are gone: style
+  `::backdrop` and `[open]`.
+- `<details>` animates in CSS. `.jaamd-details-wrapper` and
+  `.jaamd-details-inner` are gone.

package/index.ts

@@ -0,0 +1,6 @@
+export { default } from './src/integration.ts'
+export type { JaamdOptions } from './src/integration.ts'
+export { satteriPlugins, unifiedPlugins } from './src/processors.ts'
+export type { PluginOptions } from './src/processors.ts'
+export type { ShikiTheme } from './src/shiki.ts'
+export type { Feature, Features, Labels } from '@jaamd/core/client'

package/package.json

@@ -1,6 +1,76 @@
 {
   "name": "@jaamd/astro",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0-rc.1",
+  "description": "Add markdown plugins, client-side enhancements and styles as a single Astro integration for Markdown content.",
+  "keywords": [
+    "astro",
+    "astro-component",
+    "astro-integration",
+    "markdown",
+    "remark",
+    "withastro"
+  ],
+  "homepage": "https://jaamd.org",
+  "bugs": {
+    "url": "https://github.com/jaamd/jaamd/issues"
+  },
+  "license": "MIT",
+  "author": "Kasui92 <info@lucapattocchio.dev>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jaamd/jaamd.git",
+    "directory": "packages/astro"
+  },
+  "files": [
+    "index.ts",
+    "src",
+    "dist",
+    "docs",
+    "README.md"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./index.ts",
+    "./components": "./src/components/MarkdownContent.astro",
+    "./client": "./src/client.ts",
+    "./frontmatter": "./src/frontmatter.ts",
+    "./themes": "./src/themes.ts",
+    "./default.css": "./dist/default.css",
+    "./styles.css": "./dist/styles.css",
+    "./shiki-dual.css": "./dist/shiki-dual.css",
+    "./themes/*/dark.css": "./dist/themes/*/dark.css",
+    "./themes/*.css": "./dist/themes/*/index.css"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@jaamd/core": "^1.0.0-rc.1"
+  },
+  "devDependencies": {
+    "@astrojs/markdown-remark": "^7.3.5",
+    "@astrojs/markdown-satteri": "^0.4.6",
+    "astro": "^7.4.4",
+    "satteri": "^0.10.5",
+    "typescript": "^6.0.0"
+  },
+  "peerDependencies": {
+    "@astrojs/markdown-remark": "^7.3.0",
+    "astro": "^7.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@astrojs/markdown-remark": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "check": "tsc --noEmit && tsc --noEmit -p tests",
+    "test": "node --test \"tests/*.test.ts\"",
+    "test:consumer": "pnpm --filter \"@jaamd/astro...\" run build && node --test \"tests/consumer/**/*.test.mjs\"",
+    "test:build": "pnpm --filter jaamd-fixture build && node tests/build/smoke.mjs && JAAMD_PROCESSOR=unified pnpm --filter jaamd-fixture build && node tests/build/smoke.mjs"
+  }
 }

package/src/astro-satteri.ts

@@ -0,0 +1,10 @@
+import type * as AstroSatteri from '@astrojs/markdown-satteri'
+import { createRequire } from 'node:module'
+import { pathToFileURL } from 'node:url'
+
+// Resolved from Astro's location: the copy its processor runs on.
+const fromAstro = createRequire(createRequire(import.meta.url).resolve('astro/package.json'))
+
+export const { satteriCollectHastText, satteriHeadingIdsPlugin }: typeof AstroSatteri = await import(
+    /* @vite-ignore */ pathToFileURL(fromAstro.resolve('@astrojs/markdown-satteri')).href
+)

package/src/client.ts

@@ -0,0 +1 @@
+export * from '@jaamd/core/client'