@grove-dev/starlight 0.6.1 → 0.8.0

package/styles/layers.css

@@ -1 +1 @@
-@layer starlight, lucode;
+@layer starlight, grove;

package/styles/theme.css

@@ -1,67 +1,67 @@
-@layer lucode {
-    :root[data-theme='dark'] {
-        /* starlight gray scale */
-        --foreground: oklch(98.5% 0 0); /* neutral-50 */
-        --gray-1: oklch(98.5% 0 0); /* neutral-50 */
-        --gray-2: oklch(87% 0 0); /* neutral-300 */
-        --gray-3: oklch(70.8% 0 0); /* neutral-400 */
-        --gray-4: oklch(55.6% 0 0); /* neutral-500 */
-        --gray-5: oklch(37.1% 0 0); /* neutral-700 */
-        --gray-6: oklch(26.9% 0 0); /* neutral-800 */
-        --gray-7: oklch(20.5% 0 0); /* neutral-900 */
-        --background: oklch(14.5% 0 0); /* neutral-950 */
+@layer grove {
+  :root[data-theme="dark"] {
+    /* starlight gray scale */
+    --foreground: oklch(98.5% 0 0); /* neutral-50 */
+    --gray-1: oklch(98.5% 0 0); /* neutral-50 */
+    --gray-2: oklch(87% 0 0); /* neutral-300 */
+    --gray-3: oklch(70.8% 0 0); /* neutral-400 */
+    --gray-4: oklch(55.6% 0 0); /* neutral-500 */
+    --gray-5: oklch(37.1% 0 0); /* neutral-700 */
+    --gray-6: oklch(26.9% 0 0); /* neutral-800 */
+    --gray-7: oklch(20.5% 0 0); /* neutral-900 */
+    --background: oklch(14.5% 0 0); /* neutral-950 */
 
-        /* colors */
-        --orange-low: oklch(40.8% 0.123 38.172);
-        --orange: oklch(83.7% 0.128 66.29);
-        --orange-high: oklch(90.1% 0.076 70.697);
-        --green-low: oklch(26.6% 0.065 152.934);
-        --green: oklch(78% 0.19 152);
-        --green-high: oklch(87.1% 0.15 154.449);
-        --blue-low: oklch(29.3% 0.066 243.157);
-        --blue: oklch(70.7% 0.165 254.624);
-        --blue-high: oklch(82.8% 0.111 230.318);
-        --purple-low: oklch(29.1% 0.149 302.717);
-        --purple: oklch(71.4% 0.203 305.504);
-        --purple-high: oklch(82.7% 0.119 306.383);
-        --red-low: oklch(25.8% 0.092 26.042);
-        --red: oklch(70.4% 0.191 22.216);
-        --red-high: oklch(80.8% 0.114 19.571);
-    }
+    /* colors */
+    --orange-low: oklch(40.8% 0.123 38.172);
+    --orange: oklch(83.7% 0.128 66.29);
+    --orange-high: oklch(90.1% 0.076 70.697);
+    --green-low: oklch(26.6% 0.065 152.934);
+    --green: oklch(79.2% 0.209 151.711);
+    --green-high: oklch(87.1% 0.15 154.449);
+    --blue-low: oklch(29.3% 0.066 243.157);
+    --blue: oklch(70.7% 0.165 254.624);
+    --blue-high: oklch(82.8% 0.111 230.318);
+    --purple-low: oklch(29.1% 0.149 302.717);
+    --purple: oklch(71.4% 0.203 305.504);
+    --purple-high: oklch(82.7% 0.119 306.383);
+    --red-low: oklch(25.8% 0.092 26.042);
+    --red: oklch(70.4% 0.191 22.216);
+    --red-high: oklch(80.8% 0.114 19.571);
+  }
 
-    :root[data-theme='light'] {
-        /* starlight gray scale */
-        --foreground: oklch(14.5% 0 0); /* neutral-950 */
-        --gray-1: oklch(20.5% 0 0); /* neutral-900 */
-        --gray-2: oklch(26.9% 0 0); /* neutral-800 */
-        --gray-3: oklch(37.1% 0 0); /* neutral-700 */
-        --gray-4: oklch(55.6% 0 0); /* neutral-500 */
-        --gray-5: oklch(70.8% 0 0); /* neutral-400 */
-        --gray-6: oklch(87% 0 0); /* neutral-300 */
-        --gray-7: oklch(97% 0 0); /* neutral-100 */
-        --background: oklch(100% 0 0); /* white */
+  :root[data-theme="light"] {
+    /* starlight gray scale */
+    --foreground: oklch(14.5% 0 0); /* neutral-950 */
+    --gray-1: oklch(20.5% 0 0); /* neutral-900 */
+    --gray-2: oklch(26.9% 0 0); /* neutral-800 */
+    --gray-3: oklch(37.1% 0 0); /* neutral-700 */
+    --gray-4: oklch(55.6% 0 0); /* neutral-500 */
+    --gray-5: oklch(70.8% 0 0); /* neutral-400 */
+    --gray-6: oklch(87% 0 0); /* neutral-300 */
+    --gray-7: oklch(97% 0 0); /* neutral-100 */
+    --background: oklch(100% 0 0); /* white */
 
-        /* colors */
-        --orange-low: oklch(98% 0.016 73.684);
-        --orange: oklch(70.5% 0.213 47.604);
-        --orange-high: oklch(55.3% 0.195 38.402);
-        --green-low: oklch(98.2% 0.018 155.826);
-        --green: oklch(72.3% 0.219 149.579);
-        --green-high: oklch(52.7% 0.154 150.069);
-        --blue-low: oklch(97% 0.014 254.604);
-        --blue: oklch(68.5% 0.169 237.323);
-        --blue-high: oklch(48.8% 0.243 264.376);
-        --purple-low: oklch(97.7% 0.014 308.299);
-        --purple: oklch(62.7% 0.265 303.9);
-        --purple-high: oklch(49.6% 0.265 301.924);
-        --red-low: oklch(97.1% 0.013 17.38);
-        --red: oklch(63.7% 0.237 25.331);
-        --red-high: oklch(50.5% 0.213 27.518);
+    /* colors */
+    --orange-low: oklch(98% 0.016 73.684);
+    --orange: oklch(70.5% 0.213 47.604);
+    --orange-high: oklch(55.3% 0.195 38.402);
+    --green-low: oklch(98.2% 0.018 155.826);
+    --green: oklch(72.3% 0.219 149.579);
+    --green-high: oklch(52.7% 0.154 150.069);
+    --blue-low: oklch(97% 0.014 254.604);
+    --blue: oklch(68.5% 0.169 237.323);
+    --blue-high: oklch(48.8% 0.243 264.376);
+    --purple-low: oklch(97.7% 0.014 308.299);
+    --purple: oklch(62.7% 0.265 303.9);
+    --purple-high: oklch(49.6% 0.265 301.924);
+    --red-low: oklch(97.1% 0.013 17.38);
+    --red: oklch(63.7% 0.237 25.331);
+    --red-high: oklch(50.5% 0.213 27.518);
 
-        /* light overrides */
-        --accent: var(--gray-7);
-        --secondary: var(--gray-7);
-        --muted-foreground: var(--gray-4);
-        --popover-background: var(--background);
-    }
+    /* light overrides */
+    --accent: var(--gray-7);
+    --secondary: var(--gray-7);
+    --muted-foreground: var(--gray-4);
+    --popover-background: var(--background);
+  }
 }

package/user-components.ts

@@ -1,4 +1,3 @@
-export { default as Card } from './components/custom/Card.astro';
 export { default as ContainerSection } from './components/custom/ContainerSection.astro';
-export { default as LinkButton } from './components/custom/LinkButton.astro';
 export { default as Dropdown } from './components/custom/dropdown';
+export { default as LinkButton } from './components/custom/LinkButton.astro';

package/virtual.d.ts

@@ -1,51 +1,51 @@
-declare module 'virtual:lucode-starlight-config' {
-    const LucodeStarlightConfig: import('./core/config/schemas').LucodeStarlightConfig;
-    export default LucodeStarlightConfig;
+declare module 'virtual:grove-starlight-config' {
+  const GroveStarlightConfig: import('./core/config/schemas').GroveStarlightConfig;
+  export default GroveStarlightConfig;
 }
 
 declare module 'virtual:starlight/user-config' {
-    const Config: import('@astrojs/starlight/types').StarlightConfig;
-    export default Config;
+  const Config: import('@astrojs/starlight/types').StarlightConfig;
+  export default Config;
 }
 
 declare module 'virtual:starlight/user-images' {
-    type ImageMetadata = import('astro').ImageMetadata;
-    export const logos: {
-        dark?: ImageMetadata;
-        light?: ImageMetadata;
-    };
+  type ImageMetadata = import('astro').ImageMetadata;
+  export const logos: {
+    dark?: ImageMetadata;
+    light?: ImageMetadata;
+  };
 }
 
 declare module 'virtual:starlight/pagefind-config' {
-    export const pagefindUserConfig: Partial<
-        Extract<import('@astrojs/starlight/types').StarlightConfig['pagefind'], object>
-    >;
+  export const pagefindUserConfig: Partial<
+    Extract<import('@astrojs/starlight/types').StarlightConfig['pagefind'], object>
+  >;
 }
 
 declare module 'virtual:starlight/project-context' {
-    const ProjectContext: {
-        root: string;
-        srcDir: string;
-        trailingSlash: import('astro').AstroConfig['trailingSlash'];
-        build: {
-            format: import('astro').AstroConfig['build']['format'];
-        };
-        legacyCollections: boolean;
+  const ProjectContext: {
+    root: string;
+    srcDir: string;
+    trailingSlash: import('astro').AstroConfig['trailingSlash'];
+    build: {
+      format: import('astro').AstroConfig['build']['format'];
     };
-    export default ProjectContext;
+    legacyCollections: boolean;
+  };
+  export default ProjectContext;
 }
 
 declare module 'virtual:starlight/components/LastUpdated' {
-    const LastUpdated: typeof import('@astrojs/starlight/components/LastUpdated.astro').default;
-    export default LastUpdated;
+  const LastUpdated: typeof import('@astrojs/starlight/components/LastUpdated.astro').default;
+  export default LastUpdated;
 }
 
 declare module 'virtual:starlight/components/Pagination' {
-    const Pagination: typeof import('@astrojs/starlight/components/Pagination.astro').default;
-    export default Pagination;
+  const Pagination: typeof import('@astrojs/starlight/components/Pagination.astro').default;
+  export default Pagination;
 }
 
 declare module 'virtual:starlight/components/EditLink' {
-    const EditLink: typeof import('@astrojs/starlight/components/EditLink.astro').default;
-    export default EditLink;
+  const EditLink: typeof import('@astrojs/starlight/components/EditLink.astro').default;
+  export default EditLink;
 }

package/THIRD_PARTY_LICENSES.md

@@ -1,68 +0,0 @@
-# Third-party attributions — `@grove-dev/starlight`
-
-This package incorporates design and code from upstream projects. The
-contributions are credited below; reproduction of the upstream license
-texts follows the attribution block. The Grove project ships
-`@grove-dev/starlight` under the same MIT license that the rest of the
-monorepo uses; the third-party license texts below are reproduced here
-to satisfy the upstream attribution requirements.
-
-> **⚠️ TODO(decision): license compatibility check.**
-> The audit and the project's own README credit the upstream work as
-> "lucode / lucas-labs" and reference
-> `https://github.com/lucas-labs/@grove-dev/starlight-theme`. Before the
-> first publish of `@grove-dev/starlight` to npm, the project owner
-> must:
->
-> 1. Confirm the exact upstream repo URL (the `lucas-labs/...` path
->    in the README is a placeholder; the real upstream is
->    `lucode-labs/lucode` or similar — verify on GitHub).
-> 2. Verify the upstream license (MIT? Apache-2.0? something else?)
->    and confirm it is compatible with the Grove monorepo's MIT
->    distribution.
-> 3. If compatible, replace the `<!-- TODO LICENSE TEXT -->` block
->    below with the verbatim upstream license text (most MIT projects
->    use the standard MIT text — the canonical version is at
->    <https://opensource.org/licenses/MIT>).
-> 4. If not compatible, either obtain a written license grant from
->    the upstream maintainer OR replace the derivative design with
->    original work before publishing.
->
-> Tracking issue:
-> <https://github.com/tortuvshin/grove/issues/new?title=starlight%3A+verify+third-party+license+compatibility>
-
-## Upstream credits
-
-The design and component overrides in this package derive from:
-
-- **[lucode](https://github.com/lucas-labs/@grove-dev/starlight-theme)** by the
-  **lucas-labs** organization (also referenced as "Lucode" in the
-  package's `user-components.ts` and component overrides). The theme
-  recreates the design of [shadcn/ui](https://ui.shadcn.com/) (MIT)
-  for use inside Astro Starlight, with custom overrides for the
-  header, sidebar, page frame, hero, footer, search, table of
-  contents, pagination, and Markdown content. See the package
-  `README.md` (the "Attribution" and "Usage" sections) for the
-  in-code pointers.
-- **[adrian-ub/starlight-theme-black](https://github.com/adrian-ub/starlight-theme-black)**
-  — the earlier shadcn/ui-inspired Starlight theme that
-  `lucas-labs/@grove-dev/starlight-theme` was based on (per the
-  upstream README).
-- **[shadcn/ui](https://ui.shadcn.com/)** — the original design
-  language that the upstream work and this package both target.
-
-## Upstream license
-
-<!-- TODO LICENSE TEXT: paste the verbatim upstream license (typically
-the standard MIT text with copyright line) here once the license
-compatibility check above is complete. Until then this section is
-intentionally empty so the file can ship without misrepresenting the
-upstream license. -->
-
-## License for this package
-
-`@grove-dev/starlight` is distributed under the **MIT License** — see
-[`../core/LICENSE`](../../LICENSE) at the monorepo root for the
-canonical text. The third-party attributions above are reproduced for
-compliance with the upstream license terms; they do not change the
-license of the rest of the package.

package/components/custom/Card.astro

@@ -1,118 +0,0 @@
----
-/**
- * Starlight `<Card>` override that adds an optional `href` prop.
- *
- * The upstream `Card.astro` in `@astrojs/starlight@0.40` only accepts
- * `icon` and `title`, so a `<Card title="..." href="...">` call silently
- * dropped the link and rendered a non-clickable `<article>`. We wrap the
- * inner content in an `<a>` when `href` is present so the entire card
- * surface is interactive (the same affordance the `LinkCard` component
- * uses, but with our visual `Card` styling).
- *
- * Visual styles are identical to upstream — only the structure gains a
- * single `<a>` wrapper when `href` is set.
- */
-import { Icon } from '@astrojs/starlight/components';
-import type { StarlightIcon } from '@astrojs/starlight/components-internals/Icons';
-
-interface Props {
-  icon?: StarlightIcon;
-  title: string;
-  href?: string;
-}
-
-const { icon, title, href } = Astro.props;
----
-
-<article class="card sl-flex">
-    <p class="title sl-flex">
-        {icon && <Icon name={icon} class="icon" size="1.333em" />}
-        <span>{title}</span>
-    </p>
-    <div class="body">
-        {href ? <a {href} class="sl-card-link"><slot /></a> : <slot />}
-    </div>
-</article>
-
-<style>
-    @layer starlight.components {
-        .card {
-            --sl-card-border: var(--sl-color-purple);
-            --sl-card-bg: var(--sl-color-purple-low);
-            border: 1px solid var(--sl-color-gray-5);
-            background-color: var(--sl-color-black);
-            padding: clamp(1rem, calc(0.125rem + 3vw), 2.5rem);
-            flex-direction: column;
-            gap: clamp(0.5rem, calc(0.125rem + 1vw), 1rem);
-            transition: border-color 0.15s ease, transform 0.15s ease;
-        }
-        .card:nth-child(4n + 1) {
-            --sl-card-border: var(--sl-color-orange);
-            --sl-card-bg: var(--sl-color-orange-low);
-        }
-        .card:nth-child(4n + 3) {
-            --sl-card-border: var(--sl-color-green);
-            --sl-card-bg: var(--sl-color-green-low);
-        }
-        .card:nth-child(4n + 4) {
-            --sl-card-border: var(--sl-color-red);
-            --sl-card-bg: var(--sl-color-red-low);
-        }
-        .card:nth-child(4n + 5) {
-            --sl-card-border: var(--sl-color-blue);
-            --sl-card-bg: var(--sl-color-blue-low);
-        }
-        .title {
-            font-weight: 600;
-            font-size: var(--sl-text-h4);
-            color: var(--sl-color-white);
-            line-height: var(--sl-line-height-headings);
-            gap: 1rem;
-            align-items: center;
-        }
-        .card .icon {
-            border: 1px solid var(--sl-card-border);
-            background-color: var(--sl-card-bg);
-            padding: 0.2em;
-            border-radius: 0.25rem;
-            flex-shrink: 0;
-        }
-        .card .body {
-            margin: 0;
-            font-size: clamp(var(--sl-text-sm), calc(0.5rem + 1vw), var(--sl-text-body));
-        }
-        .card .body .sl-card-link {
-            /* The link is invisible text-decoration-wise; the card itself
-             * is the click target thanks to the ::before pseudo-element
-             * below. Display:contents lets the link wrap the body text
-             * without breaking the flex/grid layout. */
-            display: contents;
-            color: inherit;
-        }
-        .card:has(.sl-card-link) {
-            position: relative;
-            cursor: pointer;
-        }
-        .card:has(.sl-card-link):hover {
-            border-color: var(--sl-color-gray-2);
-        }
-        .card:has(.sl-card-link):hover .title {
-            color: var(--sl-color-accent-high);
-        }
-        /* a11y: a transparent overlay makes the whole card clickable
-         * without changing layout. Same trick Starlight's LinkCard uses. */
-        .card:has(.sl-card-link) .sl-card-link::before {
-            content: '';
-            position: absolute;
-            inset: 0;
-            border-radius: inherit;
-        }
-        /* Focus-visible ring anchored to the card surface so keyboard
-         * users see a clear focus indicator (otherwise the transparent
-         * overlay hides the default link outline). */
-        .card:has(.sl-card-link:focus-visible) {
-            outline: 2px solid var(--sl-color-accent);
-            outline-offset: 2px;
-        }
-    }
-</style>