@refrakt-md/astro 0.9.2

package/dist/behaviors.d.ts

@@ -0,0 +1,17 @@
+import type { RendererNode } from '@refrakt-md/types';
+/**
+ * Check whether a rendered page tree contains any interactive runes
+ * that require behavior initialization scripts.
+ *
+ * Used to conditionally include the behavior `<script>` tag,
+ * shipping zero JS for static-only pages.
+ */
+export declare function hasInteractiveRunes(node: RendererNode): boolean;
+/**
+ * Generate the inline behavior initialization script for an Astro page.
+ *
+ * Supports both standard page loads and Astro View Transitions
+ * via the `astro:page-load` event.
+ */
+export declare function behaviorScript(pages: unknown[], currentUrl: string): string;
+//# sourceMappingURL=behaviors.d.ts.map

package/dist/behaviors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"behaviors.d.ts","sourceRoot":"","sources":["../src/behaviors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAyB3E"}

package/dist/behaviors.js

@@ -0,0 +1,45 @@
+import { hasMatchingRunes } from '@refrakt-md/transform';
+import { getBehaviorNames } from '@refrakt-md/behaviors';
+/**
+ * Check whether a rendered page tree contains any interactive runes
+ * that require behavior initialization scripts.
+ *
+ * Used to conditionally include the behavior `<script>` tag,
+ * shipping zero JS for static-only pages.
+ */
+export function hasInteractiveRunes(node) {
+    return hasMatchingRunes(node, getBehaviorNames());
+}
+/**
+ * Generate the inline behavior initialization script for an Astro page.
+ *
+ * Supports both standard page loads and Astro View Transitions
+ * via the `astro:page-load` event.
+ */
+export function behaviorScript(pages, currentUrl) {
+    const contextData = JSON.stringify({ pages, currentUrl });
+    return `
+import { registerElements, RfContext, initRuneBehaviors, initLayoutBehaviors } from '@refrakt-md/behaviors';
+
+function init() {
+  const contextEl = document.getElementById('rf-context');
+  if (contextEl) {
+    try {
+      const ctx = JSON.parse(contextEl.textContent || '{}');
+      RfContext.pages = ctx.pages;
+      RfContext.currentUrl = ctx.currentUrl;
+    } catch {}
+  }
+  registerElements();
+  initRuneBehaviors();
+  initLayoutBehaviors();
+}
+
+// Standard page load
+init();
+
+// View Transitions support — re-init after each navigation
+document.addEventListener('astro:page-load', () => init());
+`;
+}
+//# sourceMappingURL=behaviors.js.map

package/dist/behaviors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"behaviors.js","sourceRoot":"","sources":["../src/behaviors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAkB;IACrD,OAAO,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAgB,EAAE,UAAkB;IAClE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAC1D,OAAO;;;;;;;;;;;;;;;;;;;;;;CAsBP,CAAC;AACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { refrakt } from './integration.js';
+export { renderPage } from './render.js';
+export type { RenderPageInput } from './render.js';
+export { buildSeoHead } from './seo.js';
+export type { SeoHeadProps } from './seo.js';
+export { hasInteractiveRunes, behaviorScript } from './behaviors.js';
+export { registry } from './registry.js';
+export type { ComponentRegistry } from './registry.js';
+export type { AstroTheme, RefraktAstroOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// Integration
+export { refrakt } from './integration.js';
+// Rendering
+export { renderPage } from './render.js';
+// SEO
+export { buildSeoHead } from './seo.js';
+// Behaviors
+export { hasInteractiveRunes, behaviorScript } from './behaviors.js';
+// Component registry (ADR-008)
+export { registry } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,YAAY;AACZ,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM;AACN,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErE,+BAA+B;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/integration.d.ts

@@ -0,0 +1,10 @@
+import type { AstroIntegration } from 'astro';
+import type { RefraktAstroOptions } from './types.js';
+/**
+ * Astro integration for refrakt.
+ *
+ * Reads `refrakt.config.json`, configures SSR noExternal,
+ * and sets up content HMR in dev mode.
+ */
+export declare function refrakt(options?: RefraktAstroOptions): AstroIntegration;
+//# sourceMappingURL=integration.d.ts.map

package/dist/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAG9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,gBAAgB,CAiC3E"}

package/dist/integration.js

@@ -0,0 +1,40 @@
+import { resolve } from 'node:path';
+import { CORE_PACKAGES } from '@refrakt-md/transform';
+import { loadRefraktConfig } from '@refrakt-md/transform/node';
+/**
+ * Astro integration for refrakt.
+ *
+ * Reads `refrakt.config.json`, configures SSR noExternal,
+ * and sets up content HMR in dev mode.
+ */
+export function refrakt(options = {}) {
+    const configPath = options.configPath ?? './refrakt.config.json';
+    return {
+        name: '@refrakt-md/astro',
+        hooks: {
+            'astro:config:setup'({ config, updateConfig, addWatchFile }) {
+                const refraktConfig = loadRefraktConfig(configPath);
+                const noExternal = [
+                    ...CORE_PACKAGES,
+                    '@refrakt-md/astro',
+                    refraktConfig.theme,
+                    ...(refraktConfig.packages ?? []),
+                ];
+                updateConfig({
+                    vite: {
+                        ssr: {
+                            noExternal,
+                            optimizeDeps: {
+                                include: ['@markdoc/markdoc'],
+                            },
+                        },
+                    },
+                });
+                // Watch content directory for changes in dev mode
+                const contentDir = resolve(config.root.pathname, refraktConfig.contentDir);
+                addWatchFile(contentDir);
+            },
+        },
+    };
+}
+//# sourceMappingURL=integration.js.map

package/dist/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,UAA+B,EAAE;IACxD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,uBAAuB,CAAC;IAEjE,OAAO;QACN,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE;YACN,oBAAoB,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE;gBAC1D,MAAM,aAAa,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;gBAEpD,MAAM,UAAU,GAAG;oBAClB,GAAG,aAAa;oBAChB,mBAAmB;oBACnB,aAAa,CAAC,KAAK;oBACnB,GAAG,CAAC,aAAa,CAAC,QAAQ,IAAI,EAAE,CAAC;iBACjC,CAAC;gBAEF,YAAY,CAAC;oBACZ,IAAI,EAAE;wBACL,GAAG,EAAE;4BACJ,UAAU;4BACV,YAAY,EAAE;gCACb,OAAO,EAAE,CAAC,kBAAkB,CAAC;6BAC7B;yBACD;qBACD;iBACD,CAAC,CAAC;gBAEH,kDAAkD;gBAClD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;gBAC3E,YAAY,CAAC,UAAU,CAAC,CAAC;YAC1B,CAAC;SACD;KACD,CAAC;AACH,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Component registry for Astro component overrides.
+ *
+ * Maps rune type names (the `data-rune` attribute value) to Astro components.
+ * Components receive extracted properties as props, named refs as named slots,
+ * anonymous content as the default slot, and the original `tag` as a prop.
+ *
+ * Usage in an .astro page:
+ * ```astro
+ * ---
+ * import MyRecipe from '../components/MyRecipe.astro';
+ * const components = { recipe: MyRecipe };
+ * ---
+ * <RfRenderer node={renderable} components={components} />
+ * ```
+ */
+export type ComponentRegistry = Record<string, any>;
+/**
+ * Default component registry — empty.
+ *
+ * All runes render through the identity transform + @refrakt-md/behaviors.
+ * Theme authors or site authors register .astro component overrides for runes
+ * that need custom rendering.
+ */
+export declare const registry: ComponentRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,EAAE,iBAAsB,CAAC"}

package/dist/registry.js

@@ -0,0 +1,9 @@
+/**
+ * Default component registry — empty.
+ *
+ * All runes render through the identity transform + @refrakt-md/behaviors.
+ * Theme authors or site authors register .astro component overrides for runes
+ * that need custom rendering.
+ */
+export const registry = {};
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAkBA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAsB,EAAE,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,3 @@
+export { renderPage } from '@refrakt-md/transform';
+export type { RenderPageInput } from '@refrakt-md/transform';
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/render.js

@@ -0,0 +1,2 @@
+export { renderPage } from '@refrakt-md/transform';
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/seo.d.ts

@@ -0,0 +1,14 @@
+import type { SeoInput } from '@refrakt-md/transform';
+export type SeoHeadProps = SeoInput;
+/**
+ * Build HTML strings for SEO meta tags suitable for injection into `<head>`.
+ *
+ * Returns an object with `title`, `metaTags` (OG + description), and
+ * `jsonLd` (structured data script tags).
+ */
+export declare function buildSeoHead(props: SeoHeadProps): {
+    title: string;
+    metaTags: string;
+    jsonLd: string;
+};
+//# sourceMappingURL=seo.d.ts.map

package/dist/seo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CACf,CAEA"}

package/dist/seo.js

@@ -0,0 +1,11 @@
+import { extractSeoData, seoToHtml } from '@refrakt-md/transform';
+/**
+ * Build HTML strings for SEO meta tags suitable for injection into `<head>`.
+ *
+ * Returns an object with `title`, `metaTags` (OG + description), and
+ * `jsonLd` (structured data script tags).
+ */
+export function buildSeoHead(props) {
+    return seoToHtml(extractSeoData(props));
+}
+//# sourceMappingURL=seo.js.map

package/dist/seo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.js","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAKlE;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAmB;IAK/C,OAAO,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,14 @@
+import type { AdapterTheme } from '@refrakt-md/transform';
+/**
+ * Theme definition for the Astro adapter.
+ *
+ * Alias for the shared `AdapterTheme` — all non-Svelte adapters
+ * use the same shape (manifest + layouts).
+ */
+export type AstroTheme = AdapterTheme;
+/** Options for the refrakt Astro integration */
+export interface RefraktAstroOptions {
+    /** Path to refrakt.config.json (default: './refrakt.config.json') */
+    configPath?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,CAAC;AAEtC,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IACnC,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@refrakt-md/astro",
+  "description": "Astro integration for refrakt.md — render Markdoc runes in Astro projects",
+  "version": "0.9.2",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/refrakt-md/refrakt.git",
+    "directory": "packages/astro"
+  },
+  "bugs": "https://github.com/refrakt-md/refrakt/issues",
+  "homepage": "https://github.com/refrakt-md/refrakt",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./BaseLayout.astro": "./src/BaseLayout.astro",
+    "./RfRenderer.astro": "./src/RfRenderer.astro",
+    "./elements/Table.astro": "./src/elements/Table.astro",
+    "./elements/Pre.astro": "./src/elements/Pre.astro"
+  },
+  "files": [
+    "dist",
+    "src/BaseLayout.astro",
+    "src/RfRenderer.astro",
+    "src/elements"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@refrakt-md/behaviors": "0.9.2",
+    "@refrakt-md/content": "0.9.2",
+    "@refrakt-md/transform": "0.9.2",
+    "@refrakt-md/types": "0.9.2"
+  },
+  "devDependencies": {
+    "astro": "^5.0.0"
+  },
+  "peerDependencies": {
+    "astro": "^5.0.0"
+  }
+}

package/src/BaseLayout.astro

@@ -0,0 +1,59 @@
+---
+import type { LayoutPageData } from '@refrakt-md/transform';
+import type { AstroTheme } from './types.js';
+import { renderPage } from './render.js';
+import { buildSeoHead } from './seo.js';
+import { hasInteractiveRunes } from './behaviors.js';
+
+interface Props {
+	theme: AstroTheme;
+	page: LayoutPageData;
+	seo?: { jsonLd: object[]; og: { title?: string; description?: string; image?: string; type?: string; url?: string } };
+	lang?: string;
+}
+
+const { theme, page, seo, lang = 'en' } = Astro.props;
+
+const html = renderPage({ theme, page });
+const head = buildSeoHead({ title: page.title, description: undefined, frontmatter: page.frontmatter, seo });
+const needsBehaviors = hasInteractiveRunes(page.renderable);
+const contextData = JSON.stringify({ pages: page.pages, currentUrl: page.url });
+---
+
+<html lang={lang}>
+<head>
+	<meta charset="utf-8" />
+	<meta name="viewport" content="width=device-width, initial-scale=1" />
+	{head.title && <title>{head.title}</title>}
+	<Fragment set:html={head.metaTags} />
+	<Fragment set:html={head.jsonLd} />
+	<slot name="head" />
+</head>
+<body>
+	<Fragment set:html={html} />
+	<script type="application/json" id="rf-context" set:html={contextData} />
+	{needsBehaviors && (
+		<script>
+			import { registerElements, RfContext, initRuneBehaviors, initLayoutBehaviors } from '@refrakt-md/behaviors';
+
+			function init() {
+				const contextEl = document.getElementById('rf-context');
+				if (contextEl) {
+					try {
+						const ctx = JSON.parse(contextEl.textContent || '{}');
+						RfContext.pages = ctx.pages;
+						RfContext.currentUrl = ctx.currentUrl;
+					} catch {}
+				}
+				registerElements();
+				initRuneBehaviors();
+				initLayoutBehaviors();
+			}
+
+			init();
+			document.addEventListener('astro:page-load', () => init());
+		</script>
+	)}
+	<slot name="body-end" />
+</body>
+</html>

package/src/RfRenderer.astro

@@ -0,0 +1,91 @@
+---
+/**
+ * Recursive Astro renderer for refrakt.md content (ADR-008).
+ *
+ * Renders a RendererNode tree, dispatching to registered component overrides
+ * for runes that have them, falling back to HTML for everything else.
+ *
+ * Component overrides receive:
+ * - Extracted properties as named props (e.g., prepTime, difficulty)
+ * - Named refs as named slots (e.g., <slot name="headline" />)
+ * - Anonymous content as the default slot
+ * - The original `tag` object as a prop for escape-hatch access
+ */
+import type { SerializedTag, RendererNode } from '@refrakt-md/types';
+import { isTag, extractComponentInterface, renderToHtml } from '@refrakt-md/transform';
+import RfRenderer from './RfRenderer.astro';
+
+interface Props {
+	node: RendererNode;
+	/** typeof name → Astro component (component overrides) */
+	components?: Record<string, any>;
+	/** HTML element name → Astro component (element-level overrides) */
+	elements?: Record<string, any>;
+}
+
+const { node, components, elements } = Astro.props;
+
+// Determine what kind of node we have
+const isArray = Array.isArray(node);
+const isString = typeof node === 'string';
+const isNumber = typeof node === 'number';
+const isNull = node === null || node === undefined;
+const isTagNode = !isArray && !isString && !isNumber && !isNull && isTag(node);
+
+// For tag nodes, determine the rendering path
+let Component: any = undefined;
+let ElementOverride: any = undefined;
+let iface: { properties: Record<string, string>; refs: Record<string, SerializedTag[]>; children: RendererNode[] } | undefined;
+let refHtml: Record<string, string> = {};
+let tagNode: SerializedTag | undefined;
+
+if (isTagNode) {
+	tagNode = node as SerializedTag;
+	const runeType = tagNode.attributes?.['data-rune'];
+
+	if (runeType && components?.[runeType]) {
+		Component = components[runeType];
+		iface = extractComponentInterface(tagNode);
+
+		// Pre-render refs to HTML for named slots
+		for (const [name, tags] of Object.entries(iface.refs)) {
+			refHtml[name] = tags.map(t => renderToHtml(t)).join('');
+		}
+	} else if (elements?.[tagNode.name]) {
+		ElementOverride = elements[tagNode.name];
+	}
+}
+---
+
+{isNull && null}
+
+{isString && node}
+
+{isNumber && String(node)}
+
+{isArray && (node as RendererNode[]).map((child: RendererNode) => (
+	<RfRenderer node={child} components={components} elements={elements} />
+))}
+
+{isTagNode && Component && iface && (
+	<Component {...iface.properties} tag={tagNode}>
+		{Object.entries(refHtml).map(([name, html]: [string, string]) => (
+			<Fragment slot={name} set:html={html} />
+		))}
+		{iface.children.map((child: RendererNode) => (
+			<RfRenderer node={child} components={components} elements={elements} />
+		))}
+	</Component>
+)}
+
+{isTagNode && ElementOverride && tagNode && (
+	<ElementOverride tag={tagNode}>
+		{tagNode.children.map((child: RendererNode) => (
+			<RfRenderer node={child} components={components} elements={elements} />
+		))}
+	</ElementOverride>
+)}
+
+{isTagNode && !Component && !ElementOverride && tagNode && (
+	<Fragment set:html={renderToHtml(tagNode)} />
+)}

package/src/elements/Pre.astro

@@ -0,0 +1,22 @@
+---
+/**
+ * Pre element override — wraps code blocks in the rf-codeblock structure
+ * that @refrakt-md/behaviors enhances with a copy button.
+ */
+import type { SerializedTag } from '@refrakt-md/types';
+
+interface Props {
+	tag: SerializedTag;
+}
+
+const { tag } = Astro.props;
+const isCodeBlock = 'data-language' in (tag.attributes || {});
+---
+
+{isCodeBlock ? (
+	<div class="rf-codeblock">
+		<pre {...tag.attributes}><slot /></pre>
+	</div>
+) : (
+	<pre {...tag.attributes}><slot /></pre>
+)}

package/src/elements/Table.astro

@@ -0,0 +1,24 @@
+---
+/**
+ * Table element override — wraps <table> in a scrollable container.
+ */
+import type { SerializedTag } from '@refrakt-md/types';
+
+interface Props {
+	tag: SerializedTag;
+}
+
+const { tag } = Astro.props;
+
+// Filter attributes for HTML output
+const attrs = Object.entries(tag.attributes)
+	.filter(([k, v]) => k !== '$$mdtype' && v !== undefined && v !== null && v !== false)
+	.map(([k, v]) => `${k}="${String(v === true ? '' : v).replace(/"/g, '&quot;')}"`)
+	.join(' ');
+---
+
+<div class="rf-table-wrapper">
+	<table {...tag.attributes}>
+		<slot />
+	</table>
+</div>