@hagicode/hagilight-starlight 0.1.0-dev.148.1.e0c630e

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@hagicode/hagilight-starlight",
+  "version": "0.1.0-dev.148.1.e0c630e",
+  "type": "module",
+  "description": "Starlight plugin and components for HagiCode documentation",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HagiCode-org/hagilight.git",
+    "directory": "packages/starlight"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "prepack": "tsc -b"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./locales": {
+      "types": "./dist/locales.d.ts",
+      "default": "./dist/locales.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "default": "./dist/schema.js"
+    },
+    "./showcase": {
+      "types": "./dist/showcase.d.ts",
+      "default": "./dist/showcase.js"
+    },
+    "./ContentLayoutToggle": "./ContentLayoutToggle.astro",
+    "./ThemeSelect": "./ThemeSelect.astro",
+    "./Header": "./Header.astro",
+    "./Footer": "./Footer.astro",
+    "./MarkdownContent": "./MarkdownContent.astro",
+    "./ArticlePromotion": "./ArticlePromotion.astro",
+    "./PageTitle": "./PageTitle.astro",
+    "./NotFoundHero": "./NotFoundHero.astro",
+    "./PromotoFooter": "./PromotoFooter.astro"
+  },
+  "files": [
+    "README.md",
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "*.astro",
+    "*.css",
+    "rss*.xml.ts",
+    "assets/showcase/*"
+  ],
+  "dependencies": {
+    "@hagicode/hagilight-core": "0.1.0-dev.148.1.e0c630e"
+  },
+  "peerDependencies": {
+    "@astrojs/starlight": "^0.42.4",
+    "astro": "^7.3.5"
+  },
+  "devDependencies": {
+    "@astrojs/starlight": "^0.42.4",
+    "astro": "^7.3.5"
+  },
+  "keywords": [
+    "hagicode",
+    "hagicode-org",
+    "hagilight",
+    "astro-component",
+    "withastro",
+    "astro-seo",
+    "starlight",
+    "starlight-plugin",
+    "multilingual-documentation",
+    "hreflang",
+    "structured-data"
+  ],
+  "homepage": "https://github.com/HagiCode-org/hagilight#readme",
+  "bugs": {
+    "url": "https://github.com/HagiCode-org/hagilight/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "HagiCode",
+    "url": "https://github.com/HagiCode-org"
+  }
+}

package/rss.[language].xml.ts

@@ -0,0 +1,20 @@
+import { getCollection } from 'astro:content';
+import type { APIRoute, GetStaticPaths } from 'astro';
+import rssConfig from 'virtual:hagilight-starlight/rss-config';
+import { generateRssFeed } from './dist/rss-renderer.js';
+
+export const getStaticPaths: GetStaticPaths = () => {
+  const filenames = new Set(['en', ...rssConfig.locales.map(({ filename }) => filename)]);
+  return [...filenames].map((language) => ({ params: { language } }));
+};
+
+export const GET: APIRoute = async ({ params, site }) => {
+  const entries = await getCollection('docs');
+  return generateRssFeed({
+    site,
+    baseUrl: import.meta.env.BASE_URL,
+    filename: params.language,
+    ...rssConfig,
+    entries,
+  });
+};

package/rss.xml.ts

@@ -0,0 +1,15 @@
+import { getCollection } from 'astro:content';
+import type { APIRoute } from 'astro';
+import rssConfig from 'virtual:hagilight-starlight/rss-config';
+import { generateRssFeed } from './dist/rss-renderer.js';
+
+export const GET: APIRoute = async ({ site }) => {
+  const entries = await getCollection('docs');
+  return generateRssFeed({
+    site,
+    baseUrl: import.meta.env.BASE_URL,
+    filename: 'en',
+    ...rssConfig,
+    entries,
+  });
+};

package/themes.css

@@ -0,0 +1,160 @@
+/*
+ * Hagilight extra themes: Ocean, Sakura, and Forest. Each theme overrides Starlight's
+ * color custom properties for its dark and light appearance. The applied theme is exposed
+ * through `data-hagilight-theme` on `<html>` by the theme picker's pre-paint bootstrap
+ * script, while light/dark mode keeps using Starlight's `data-theme` attribute.
+ *
+ * Starlight's dark palette is the `:root` default, so dark overrides must exclude the light
+ * mode with `:not([data-theme='light'])`; otherwise they would out-specify the light palette
+ * because custom CSS loads after Starlight's own styles.
+ */
+
+/* Ocean — cool blue accent. */
+:root[data-hagilight-theme='ocean']:not([data-theme='light']),
+:root[data-hagilight-theme='ocean']:not([data-theme='light']) ::backdrop {
+  --sl-color-white: hsl(0, 0%, 100%);
+  --sl-color-gray-1: hsl(212, 24%, 94%);
+  --sl-color-gray-2: hsl(212, 12%, 77%);
+  --sl-color-gray-3: hsl(212, 10%, 56%);
+  --sl-color-gray-4: hsl(212, 10%, 36%);
+  --sl-color-gray-5: hsl(212, 14%, 23%);
+  --sl-color-gray-6: hsl(212, 18%, 16%);
+  --sl-color-black: hsl(212, 20%, 10%);
+
+  --sl-hue-orange: 25;
+  --sl-hue-green: 160;
+  --sl-hue-blue: 206;
+  --sl-hue-purple: 265;
+  --sl-hue-red: 355;
+
+  --sl-color-accent-low: hsl(212, 64%, 22%);
+  --sl-color-accent: hsl(206, 100%, 63%);
+  --sl-color-accent-high: hsl(205, 100%, 84%);
+
+  --sl-color-backdrop-overlay: hsla(212, 40%, 8%, 0.66);
+}
+
+:root[data-hagilight-theme='ocean'][data-theme='light'],
+:root[data-hagilight-theme='ocean'][data-theme='light'] ::backdrop {
+  --sl-color-white: hsl(212, 24%, 10%);
+  --sl-color-gray-1: hsl(212, 18%, 16%);
+  --sl-color-gray-2: hsl(212, 12%, 23%);
+  --sl-color-gray-3: hsl(212, 10%, 36%);
+  --sl-color-gray-4: hsl(212, 8%, 56%);
+  --sl-color-gray-5: hsl(212, 10%, 77%);
+  --sl-color-gray-6: hsl(212, 26%, 94%);
+  --sl-color-gray-7: hsl(212, 32%, 97%);
+  --sl-color-black: hsl(0, 0%, 100%);
+
+  --sl-hue-orange: 25;
+  --sl-hue-green: 160;
+  --sl-hue-blue: 206;
+  --sl-hue-purple: 265;
+  --sl-hue-red: 355;
+
+  --sl-color-accent-high: hsl(211, 80%, 30%);
+  --sl-color-accent: hsl(206, 90%, 42%);
+  --sl-color-accent-low: hsl(206, 88%, 90%);
+
+  --sl-color-backdrop-overlay: hsla(212, 30%, 35%, 0.66);
+}
+
+/* Sakura — rose accent with warm neutrals. */
+:root[data-hagilight-theme='sakura']:not([data-theme='light']),
+:root[data-hagilight-theme='sakura']:not([data-theme='light']) ::backdrop {
+  --sl-color-white: hsl(0, 0%, 100%);
+  --sl-color-gray-1: hsl(340, 24%, 94%);
+  --sl-color-gray-2: hsl(340, 12%, 77%);
+  --sl-color-gray-3: hsl(340, 10%, 56%);
+  --sl-color-gray-4: hsl(340, 10%, 36%);
+  --sl-color-gray-5: hsl(340, 14%, 23%);
+  --sl-color-gray-6: hsl(340, 18%, 16%);
+  --sl-color-black: hsl(340, 20%, 10%);
+
+  --sl-hue-orange: 20;
+  --sl-hue-green: 145;
+  --sl-hue-blue: 230;
+  --sl-hue-purple: 285;
+  --sl-hue-red: 350;
+
+  --sl-color-accent-low: hsl(338, 60%, 22%);
+  --sl-color-accent: hsl(340, 85%, 70%);
+  --sl-color-accent-high: hsl(340, 100%, 88%);
+
+  --sl-color-backdrop-overlay: hsla(340, 40%, 8%, 0.66);
+}
+
+:root[data-hagilight-theme='sakura'][data-theme='light'],
+:root[data-hagilight-theme='sakura'][data-theme='light'] ::backdrop {
+  --sl-color-white: hsl(340, 24%, 10%);
+  --sl-color-gray-1: hsl(340, 18%, 16%);
+  --sl-color-gray-2: hsl(340, 12%, 23%);
+  --sl-color-gray-3: hsl(340, 10%, 36%);
+  --sl-color-gray-4: hsl(340, 8%, 56%);
+  --sl-color-gray-5: hsl(340, 10%, 77%);
+  --sl-color-gray-6: hsl(340, 26%, 94%);
+  --sl-color-gray-7: hsl(340, 32%, 97%);
+  --sl-color-black: hsl(0, 0%, 100%);
+
+  --sl-hue-orange: 20;
+  --sl-hue-green: 145;
+  --sl-hue-blue: 230;
+  --sl-hue-purple: 285;
+  --sl-hue-red: 350;
+
+  --sl-color-accent-high: hsl(338, 80%, 34%);
+  --sl-color-accent: hsl(340, 80%, 44%);
+  --sl-color-accent-low: hsl(340, 90%, 91%);
+
+  --sl-color-backdrop-overlay: hsla(340, 30%, 35%, 0.66);
+}
+
+/* Forest — green accent with cool neutrals. */
+:root[data-hagilight-theme='forest']:not([data-theme='light']),
+:root[data-hagilight-theme='forest']:not([data-theme='light']) ::backdrop {
+  --sl-color-white: hsl(0, 0%, 100%);
+  --sl-color-gray-1: hsl(150, 20%, 94%);
+  --sl-color-gray-2: hsl(150, 10%, 77%);
+  --sl-color-gray-3: hsl(150, 8%, 56%);
+  --sl-color-gray-4: hsl(150, 8%, 36%);
+  --sl-color-gray-5: hsl(150, 12%, 23%);
+  --sl-color-gray-6: hsl(150, 16%, 16%);
+  --sl-color-black: hsl(150, 18%, 10%);
+
+  --sl-hue-orange: 35;
+  --sl-hue-green: 155;
+  --sl-hue-blue: 200;
+  --sl-hue-purple: 262;
+  --sl-hue-red: 5;
+
+  --sl-color-accent-low: hsl(152, 60%, 20%);
+  --sl-color-accent: hsl(158, 80%, 52%);
+  --sl-color-accent-high: hsl(150, 90%, 78%);
+
+  --sl-color-backdrop-overlay: hsla(150, 40%, 8%, 0.66);
+}
+
+:root[data-hagilight-theme='forest'][data-theme='light'],
+:root[data-hagilight-theme='forest'][data-theme='light'] ::backdrop {
+  --sl-color-white: hsl(150, 20%, 10%);
+  --sl-color-gray-1: hsl(150, 16%, 16%);
+  --sl-color-gray-2: hsl(150, 10%, 23%);
+  --sl-color-gray-3: hsl(150, 8%, 36%);
+  --sl-color-gray-4: hsl(150, 6%, 56%);
+  --sl-color-gray-5: hsl(150, 8%, 77%);
+  --sl-color-gray-6: hsl(150, 24%, 94%);
+  --sl-color-gray-7: hsl(150, 30%, 97%);
+  --sl-color-black: hsl(0, 0%, 100%);
+
+  --sl-hue-orange: 35;
+  --sl-hue-green: 155;
+  --sl-hue-blue: 200;
+  --sl-hue-purple: 262;
+  --sl-hue-red: 5;
+
+  --sl-color-accent-high: hsl(152, 100%, 24%);
+  --sl-color-accent: hsl(155, 100%, 26%);
+  --sl-color-accent-low: hsl(152, 85%, 89%);
+
+  --sl-color-backdrop-overlay: hsla(150, 30%, 35%, 0.66);
+}