starlight-pele 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 torben haack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,37 @@
-# Temporary Holding Version
+# starlight-pele
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Starlight plugin that renders Mermaid fences to themeable SVG with [Pele](https://pele.run).
+
+It adds the Astro integration, maps Pele's colors to Starlight's light and dark theme, and leaves no client JavaScript unless zoom is enabled.
+
+## Install
+
+```sh
+npm install starlight-pele
+```
+
+## Setup
+
+```js
+// astro.config.mjs
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+import { starlightPele } from 'starlight-pele';
+
+export default defineConfig({
+	integrations: [starlight({ title: 'Docs', plugins: [starlightPele()] })],
+});
+```
+
+Then use a normal Mermaid fence:
+
+````md
+```mermaid
+flowchart LR
+  A[Markdown] --> B[Static SVG]
+```
+````
+
+Add `zoom` to a fence for pan and zoom, or pass `starlightPele({ zoom: true })` to enable it everywhere.
+
+Full docs: https://t128n.github.io/pele-x/

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { AstroPeleOptions } from "astro-pele";
+import { StarlightPlugin } from "@astrojs/starlight/types";
+export interface StarlightPeleOptions extends AstroPeleOptions {}
+export declare function starlightPele(options?: StarlightPeleOptions): StarlightPlugin;

package/dist/index.js

@@ -0,0 +1,18 @@
+import { pele } from "astro-pele";
+// src/index.ts
+const theme = "starlight-pele/theme.css";
+const configured = /* @__PURE__ */ new WeakSet();
+function starlightPele(options = {}) {
+	return {
+		name: "starlight-pele",
+		hooks: { "config:setup": ({ config, addIntegration, updateConfig }) => {
+			if (!configured.has(config)) {
+				addIntegration(pele(options));
+				configured.add(config);
+			}
+			const customCss = config.customCss ?? [];
+			if (!customCss.includes(theme)) updateConfig({ customCss: [...customCss, theme] });
+		} }
+	};
+}
+export { starlightPele };

package/package.json

@@ -1,6 +1,57 @@
 {
-  "name": "starlight-pele",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "starlight-pele",
+	"version": "0.1.0",
+	"description": "Starlight plugin that renders Mermaid fences to themeable SVG with Pele.",
+	"license": "MIT",
+	"type": "module",
+	"keywords": [
+		"starlight",
+		"astro",
+		"mermaid",
+		"pele",
+		"svg",
+		"diagrams",
+		"documentation"
+	],
+	"homepage": "https://t128n.github.io/pele-x/",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/t128n/pele-x.git",
+		"directory": "packages/starlight"
+	},
+	"bugs": {
+		"url": "https://github.com/t128n/pele-x/issues"
+	},
+	"files": [
+		"dist",
+		"theme.css",
+		"README.md",
+		"LICENSE"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"engines": {
+		"node": ">=22.23.4"
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./theme.css": "./theme.css"
+	},
+	"scripts": {
+		"build": "tsdown",
+		"typecheck": "tsc --noEmit"
+	},
+	"dependencies": {
+		"astro-pele": "workspace:*"
+	},
+	"peerDependencies": {
+		"@astrojs/starlight": "^0.42.0",
+		"astro": "^7.2.0"
+	}
+}

package/theme.css

@@ -0,0 +1,38 @@
+:root {
+	--pele-bg: var(--sl-color-bg);
+	--pele-fg: var(--sl-color-text);
+	--pele-muted: var(--sl-color-gray-3);
+	--pele-line: var(--sl-color-gray-5);
+	--pele-surface: var(--sl-color-bg-sidebar);
+	--pele-surface-alt: var(--sl-color-bg-inline-code);
+	--pele-border: var(--sl-color-hairline);
+	--pele-accent: var(--sl-color-accent);
+}
+
+.pele-diagram {
+	margin: 1.5rem 0;
+	overflow-x: auto;
+}
+
+.pele-diagram svg {
+	display: block;
+	max-width: 100%;
+	height: auto;
+	margin-inline: auto;
+}
+
+.pele-diagram figcaption {
+	margin-top: 0.75rem;
+	color: var(--pele-muted);
+	font-size: 0.875rem;
+	text-align: center;
+}
+
+.pele-error {
+	padding: 1rem;
+	border: 1px solid var(--pele-border);
+	border-radius: var(--pele-radius, 4px);
+	background: var(--pele-surface);
+	color: var(--pele-fg);
+	white-space: pre-wrap;
+}