starlight-theme-bejamas 0.0.0-canary.0138fd3

package/CHANGELOG.md

@@ -0,0 +1,132 @@
+# starlight-theme-bejamas
+
+## 0.2.1
+
+### Patch Changes
+
+- [#143](https://github.com/bejamas/ui/pull/143) [`94b6e69`](https://github.com/bejamas/ui/commit/94b6e698d22920f974d263709828cb9cfaa1bce5) Thanks [@Tadzik-2](https://github.com/Tadzik-2)! - Publish semantic icons publicly and validate packed release manifests so the theme installs without workspace protocol or private runtime dependencies.
+
+- Updated dependencies [[`94b6e69`](https://github.com/bejamas/ui/commit/94b6e698d22920f974d263709828cb9cfaa1bce5)]:
+  - @bejamas/semantic-icons@0.1.1
+
+## 0.2.0
+
+### Minor Changes
+
+- [#102](https://github.com/bejamas/ui/pull/102) [`25987b8`](https://github.com/bejamas/ui/commit/25987b872d38280dfe47f820019f86c1cb00eb6d) Thanks [@thomkrupa](https://github.com/thomkrupa)! - Improve the Starlight Bejamas theme runtime and expose the shared theme-choice helpers for consumers that need to integrate with theme state directly.
+  - Unify light, dark, and auto theme choice handling across the theme picker, page chrome, and preview surfaces so theme state stays in sync more reliably.
+  - Refresh browser theme-color metadata and the active theme stylesheet more consistently when theme state or presets change.
+  - Sync semantic icon updates as part of the theme runtime so icon-library changes propagate cleanly with preset-driven theme updates.
+  - Export `starlight-theme-bejamas/lib/theme-choice` as a public entrypoint for consumers that want to read, apply, or react to the shared theme-choice state.
+
+## 0.1.18
+
+### Patch Changes
+
+- [#83](https://github.com/bejamas/ui/pull/83) [`4e1ceaf`](https://github.com/bejamas/ui/commit/4e1ceaf8ab8dc2405f06b5124bf5bdb2bfae44bc) Thanks [@thomkrupa](https://github.com/thomkrupa)! - fix typo
+
+## 0.1.17
+
+### Patch Changes
+
+- [#80](https://github.com/bejamas/ui/pull/80) [`c3f2b3a`](https://github.com/bejamas/ui/commit/c3f2b3a2f94f8c60657e33bab49320a5d5258e11) Thanks [@thomkrupa](https://github.com/thomkrupa)! - fix shared splash layout bg
+
+- [#82](https://github.com/bejamas/ui/pull/82) [`043d0fa`](https://github.com/bejamas/ui/commit/043d0faa76a34f25620f7ad8bc30d8aa9be8e3be) Thanks [@thomkrupa](https://github.com/thomkrupa)! - fix sidebar margin
+
+## 0.1.16
+
+### Patch Changes
+
+- [#78](https://github.com/bejamas/ui/pull/78) [`a2d6526`](https://github.com/bejamas/ui/commit/a2d6526f3c6e205d1ccd219665afef299263db9c) Thanks [@thomkrupa](https://github.com/thomkrupa)! - improve mobile design
+
+## 0.1.15
+
+### Patch Changes
+
+- [#71](https://github.com/bejamas/ui/pull/71) [`4e38086`](https://github.com/bejamas/ui/commit/4e38086536db86aa7e25dbad3da28dcb0027f7a6) Thanks [@thomkrupa](https://github.com/thomkrupa)! - remove scrollbar from sidebar
+
+## 0.1.14
+
+### Patch Changes
+
+- [#66](https://github.com/bejamas/ui/pull/66) [`50515c3`](https://github.com/bejamas/ui/commit/50515c39115a0febdfa683db9263257ec4338baf) Thanks [@thomkrupa](https://github.com/thomkrupa)! - remove margin from console
+
+## 0.1.13
+
+### Patch Changes
+
+- [#60](https://github.com/bejamas/ui/pull/60) [`045558f`](https://github.com/bejamas/ui/commit/045558f12df6d2a1bcff82254baf06c79fbdd623) Thanks [@thomkrupa](https://github.com/thomkrupa)! - update theme switcher to new select
+
+## 0.1.12
+
+### Patch Changes
+
+- [#51](https://github.com/bejamas/ui/pull/51) [`342c66c`](https://github.com/bejamas/ui/commit/342c66cf9ebb85fa07de8d3f3d17074c82afe527) Thanks [@thomkrupa](https://github.com/thomkrupa)! - fix max-height for code
+
+## 0.1.11
+
+### Patch Changes
+
+- [#47](https://github.com/bejamas/ui/pull/47) [`099bc0f`](https://github.com/bejamas/ui/commit/099bc0f20772cc1e4e1d86e39f208737339a5693) Thanks [@thomkrupa](https://github.com/thomkrupa)! - improve background colors
+
+## 0.1.10
+
+### Patch Changes
+
+- [#45](https://github.com/bejamas/ui/pull/45) [`171f2fe`](https://github.com/bejamas/ui/commit/171f2fe63c2cb795f0f3cb30c1c16f37b5af62c1) Thanks [@thomkrupa](https://github.com/thomkrupa)! - make the page description a bit more narrow
+
+## 0.1.9
+
+### Patch Changes
+
+- [#42](https://github.com/bejamas/ui/pull/42) [`dd91b4e`](https://github.com/bejamas/ui/commit/dd91b4edbfd43a08a0b6766057b9c991bb18a5f0) Thanks [@thomkrupa](https://github.com/thomkrupa)! - improve table styling
+
+## 0.1.8
+
+### Patch Changes
+
+- [#40](https://github.com/bejamas/ui/pull/40) [`58fbd77`](https://github.com/bejamas/ui/commit/58fbd775b67b2e132662ecfd9e69f674b004e675) Thanks [@thomkrupa](https://github.com/thomkrupa)! - improve z-indexes for code blocks
+
+## 0.1.7
+
+### Patch Changes
+
+- [#30](https://github.com/bejamas/ui/pull/30) [`4f2f6d4`](https://github.com/bejamas/ui/commit/4f2f6d41ba455d0dc87ee8db45974f78c7ca4a7d) Thanks [@thomkrupa](https://github.com/thomkrupa)! - decrease inline padding for mobile component preview
+
+## 0.1.6
+
+### Patch Changes
+
+- [#25](https://github.com/bejamas/ui/pull/25) [`001ddca`](https://github.com/bejamas/ui/commit/001ddcae75e510cd5f2afca4e24af6412bf84ed9) Thanks [@thomkrupa](https://github.com/thomkrupa)! - improve source preview
+
+## 0.1.5
+
+### Patch Changes
+
+- [#19](https://github.com/bejamas/ui/pull/19) [`bd4c3a0`](https://github.com/bejamas/ui/commit/bd4c3a0b596718a25aefaf7b30d185d30693618a) Thanks [@thomkrupa](https://github.com/thomkrupa)! - improve page footer ui
+
+## 0.1.4
+
+### Patch Changes
+
+- [#17](https://github.com/bejamas/ui/pull/17) [`5751b96`](https://github.com/bejamas/ui/commit/5751b9652384891bc740947a654650cff272c2c1) Thanks [@thomkrupa](https://github.com/thomkrupa)! - improve pagination spacing
+
+## 0.1.3
+
+### Patch Changes
+
+- [#15](https://github.com/bejamas/ui/pull/15) [`067a92b`](https://github.com/bejamas/ui/commit/067a92bd34171b5403c7033cd2cccd54ad7ffe41) Thanks [@thomkrupa](https://github.com/thomkrupa)! - improve codeblock ui
+
+## 0.1.2
+
+### Patch Changes
+
+- [#6](https://github.com/bejamas/ui/pull/6) [`fcca220`](https://github.com/bejamas/ui/commit/fcca220c0d4760edbaaefbfe2ce0af512bfadc26) Thanks [@thomkrupa](https://github.com/thomkrupa)! - convert component names to PascalCase for barrel import
+
+- [#6](https://github.com/bejamas/ui/pull/6) [`41d9e97`](https://github.com/bejamas/ui/commit/41d9e97f7cee67e95d9c9eeb112762d1487d4e4f) Thanks [@thomkrupa](https://github.com/thomkrupa)! - change imports of bejamas/ui components
+
+## 0.1.1
+
+### Patch Changes
+
+- fix search position on tablet screen size

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "starlight-theme-bejamas",
+  "author": "Bejamas",
+  "version": "0.0.0-canary.0138fd3",
+  "license": "MIT",
+  "description": "A Starlight theme using bejamas/ui",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./config": "./src/config.ts",
+    "./lib/theme-choice": "./src/lib/theme-choice.ts",
+    "./styles/theme.css": "./src/styles/theme.css",
+    "./overrides/Header.astro": "./src/overrides/Header.astro",
+    "./overrides/PageFrame.astro": "./src/overrides/PageFrame.astro",
+    "./overrides/SiteTitle.astro": "./src/overrides/SiteTitle.astro",
+    "./overrides/Pagination.astro": "./src/overrides/Pagination.astro",
+    "./overrides/PageTitle.astro": "./src/overrides/PageTitle.astro",
+    "./overrides/Hero.astro": "./src/overrides/Hero.astro",
+    "./overrides/MobileTableOfContents.astro": "./src/overrides/MobileTableOfContents.astro",
+    "./overrides/Footer.astro": "./src/overrides/Footer.astro",
+    "./overrides/ThemeSelect.astro": "./src/overrides/ThemeSelect.astro",
+    "./overrides/ThemeProvider.astro": "./src/overrides/ThemeProvider.astro"
+  },
+  "scripts": {},
+  "keywords": [
+    "starlight",
+    "theme",
+    "bejamas",
+    "bejamas/ui",
+    "astro",
+    "astro-component",
+    "withastro"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bejamas/ui.git",
+    "directory": "packages/starlight-theme-bejamas"
+  },
+  "bugs": "https://github.com/bejamas/ui/issues",
+  "peerDependencies": {
+    "@astrojs/starlight": "^0.42.3",
+    "astro": "^7.3.4"
+  },
+  "dependencies": {
+    "@bejamas/semantic-icons": "0.0.0-canary.0138fd3",
+    "@fontsource-variable/inter": "^5.3.0",
+    "@fontsource/inter": "^5.3.0",
+    "@lucide/astro": "^1.47.0"
+  }
+}

package/src/config.test.ts

@@ -0,0 +1,40 @@
+import { describe, expect, test } from "bun:test";
+
+import { StarlightThemeBejamasConfigSchema } from "./config";
+
+describe("starlight-theme-bejamas config schema", () => {
+  test("parses nav and component maps under zod v4", () => {
+    const result = StarlightThemeBejamasConfigSchema.safeParse({
+      nav: [
+        {
+          label: {
+            en: "Docs",
+            fr: "Documentation",
+          },
+          href: "/docs/introduction",
+          attrs: {
+            rel: "prefetch",
+            "data-track": "docs-link",
+          },
+        },
+      ],
+      components: {
+        ThemeSelect: "./src/components/ThemeSwitcher.astro",
+        PageTitle: "./src/components/PageTitle.astro",
+      },
+    });
+
+    expect(result.success).toBe(true);
+    if (!result.success) {
+      throw result.error;
+    }
+
+    expect(result.data.nav?.[0]?.label).toEqual({
+      en: "Docs",
+      fr: "Documentation",
+    });
+    expect(result.data.components?.ThemeSelect).toBe(
+      "./src/components/ThemeSwitcher.astro",
+    );
+  });
+});

package/src/config.ts

@@ -0,0 +1,51 @@
+import type { AstroBuiltinAttributes } from "astro";
+import type { HTMLAttributes } from "astro/types";
+import { z } from "astro/zod";
+
+const linkHTMLAttributesSchema = z.record(
+  z.string(),
+  z.union([z.string(), z.number(), z.boolean(), z.undefined()]),
+) as z.Schema<
+  Omit<HTMLAttributes<"a">, keyof AstroBuiltinAttributes | "children">
+>;
+
+// eslint-disable-next-line ts/explicit-function-return-type
+const LinkItemHTMLAttributesSchema = () => linkHTMLAttributesSchema.default({});
+
+const navLinkSchema = z.object({
+  /**
+   * An optional badge to display next to the topic label.
+   *
+   * This option accepts the same configuration as the Starlight badge sidebar item configuration.
+   * @see https://starlight.astro.build/guides/sidebar/#badges
+   */
+  badge: z.string().optional(),
+  /**
+   * The topic label visible at the top of the sidebar.
+   *
+   * The value can be a string, or for multilingual sites, an object with values for each different locale. When using
+   * the object form, the keys must be BCP-47 tags (e.g. en, fr, or zh-CN).
+   */
+  label: z.union([z.string(), z.record(z.string(), z.string())]),
+  /**
+   * The link to the topic’s content which an be a relative link to local files or the full URL of an external page.
+   *
+   * For internal links, the link can either be a page included in the items array or a different page acting as the
+   * topic’s landing page.
+   */
+  href: z.string(),
+  /** HTML attributes to add to the link item. */
+  attrs: LinkItemHTMLAttributesSchema(),
+});
+
+export const StarlightThemeBejamasConfigSchema = z.object({
+  nav: z.array(navLinkSchema).optional(),
+  components: z.record(z.string(), z.string()).optional(),
+});
+
+export type StarlightThemeBejamasUserConfig = z.input<
+  typeof StarlightThemeBejamasConfigSchema
+>;
+export type StarlightThemeBejamasConfig = z.output<
+  typeof StarlightThemeBejamasConfigSchema
+>;

package/src/env.d.ts

@@ -0,0 +1,16 @@
+/// <reference path="./virtual-modules.d.ts" />
+/// <reference path="./virtual-internal.d.ts" />
+
+import type { I18nT } from "@astrojs/starlight/utils/createTranslationSystem";
+import type { StarlightRouteData } from "@astrojs/starlight/utils/routing/types";
+
+declare global {
+  namespace App {
+    interface Locals {
+      t: I18nT;
+      starlightRoute: StarlightRouteData;
+    }
+  }
+}
+
+export {};

package/src/global.d.ts

@@ -0,0 +1,20 @@
+declare global {
+  interface Window {
+    StarlightThemeProvider?: {
+      refreshThemeColors?: (theme?: string) => void;
+      updatePickers?: (theme?: string) => void;
+    };
+  }
+
+  const StarlightThemeProvider: {
+    refreshThemeColors?: (theme?: string) => void;
+    updatePickers?: (theme?: string) => void;
+  };
+
+  namespace App {
+    interface Locals {
+      t: I18nT;
+      starlightRoute: StarlightRouteData;
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,152 @@
+import type {
+  StarlightPlugin,
+  StarlightUserConfig,
+} from "@astrojs/starlight/types";
+import type { AstroIntegration, AstroIntegrationLogger } from "astro";
+
+import { createInlineSvgUrl } from "@astrojs/starlight/expressive-code";
+
+import {
+  StarlightThemeBejamasConfigSchema,
+  type StarlightThemeBejamasUserConfig,
+} from "./config";
+import { vitePluginStarlightThemeBejamas } from "./lib/vite";
+
+export default function starlightThemeBejamas(
+  userConfig: StarlightThemeBejamasUserConfig,
+): StarlightPlugin {
+  const parsedConfig = StarlightThemeBejamasConfigSchema.safeParse(userConfig);
+
+  if (!parsedConfig.success) {
+    throw new Error(
+      `The provided plugin configuration is invalid.\n${parsedConfig.error.issues
+        .map((issue: { message: string }) => issue.message)
+        .join("\n")}`,
+    );
+  }
+
+  const config = parsedConfig.data;
+
+  return {
+    name: "starlight-theme-bejamas-plugin",
+    hooks: {
+      "config:setup": function ({
+        config: starlightConfig,
+        logger,
+        updateConfig,
+        addIntegration,
+      }: {
+        config: StarlightUserConfig;
+        logger: AstroIntegrationLogger;
+        updateConfig: (config: StarlightUserConfig) => void;
+        addIntegration: (integration: AstroIntegration) => void;
+      }) {
+        const userExpressiveCodeConfig =
+          starlightConfig.expressiveCode === false ||
+          starlightConfig.expressiveCode === true
+            ? {}
+            : starlightConfig.expressiveCode;
+
+        const componentOverrides: typeof config.components = {};
+
+        type OverridableComponent =
+          | "Header"
+          | "PageFrame"
+          | "SiteTitle"
+          | "Pagination"
+          | "PageTitle"
+          | "Hero"
+          | "MobileTableOfContents"
+          | "Footer"
+          | "ThemeSelect"
+          | "ThemeProvider";
+
+        const overridableComponents: OverridableComponent[] = [
+          "Header",
+          "PageFrame",
+          "SiteTitle",
+          "Pagination",
+          "PageTitle",
+          "Hero",
+          "MobileTableOfContents",
+          "Footer",
+          "ThemeSelect",
+          "ThemeProvider",
+        ];
+
+        for (const component of overridableComponents) {
+          if (config.components?.[component]) {
+            logger.warn(
+              `It looks like you already have a \`${component}\` component override in your Starlight configuration.`,
+            );
+          } else {
+            componentOverrides[component] =
+              `starlight-theme-bejamas/overrides/${component}.astro`;
+          }
+        }
+
+        updateConfig({
+          components: {
+            ...componentOverrides,
+            ...config.components,
+          },
+          customCss: [
+            "@fontsource/inter/400.css",
+            "@fontsource/inter/500.css",
+            "@fontsource/inter/700.css",
+            ...(starlightConfig.customCss ?? []),
+            "starlight-theme-bejamas/styles/theme.css",
+          ],
+          expressiveCode:
+            starlightConfig.expressiveCode === false
+              ? false
+              : {
+                  themes: ["github-dark-default", "github-light-default"],
+                  ...userExpressiveCodeConfig,
+                  styleOverrides: {
+                    codeBackground: "var(--code-background)",
+                    borderWidth: "0px",
+                    borderRadius: "calc(var(--radius) + 4px)",
+                    gutterBorderWidth: "0px",
+                    ...userExpressiveCodeConfig?.styleOverrides,
+                    frames: {
+                      editorBackground: "var(--code-background)",
+                      terminalBackground: "var(--code-background)",
+                      copyIcon: createInlineSvgUrl(
+                        `<svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-clipboard"><rect width="8" height="4" x="8" y="2" rx="1" ry="1"></rect><path d="M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2"></path></svg>`,
+                      ),
+                      ...userExpressiveCodeConfig?.styleOverrides?.frames,
+                    },
+                    textMarkers: {
+                      markBackground: "var(--mark-background)",
+                      markBorderColor: "var(--border)",
+                      ...userExpressiveCodeConfig?.styleOverrides?.textMarkers,
+                    },
+                  },
+                  defaultProps: {
+                    showLineNumbers: false,
+                    overridesByLang: {
+                      astro: {
+                        showLineNumbers: true,
+                      },
+                    },
+                  },
+                },
+        });
+
+        addIntegration({
+          name: "starlight-theme-bejamas-integration",
+          hooks: {
+            "astro:config:setup": ({ updateConfig }) => {
+              updateConfig({
+                vite: {
+                  plugins: [vitePluginStarlightThemeBejamas(config)],
+                },
+              });
+            },
+          },
+        });
+      },
+    },
+  };
+}