@publier/shell 3.5.1 → 3.6.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { i as DocsShellOptions, m as docsShell } from "./integration-CiX7_JNh.mjs";
+import { i as DocsShellOptions, m as docsShell } from "./integration-BHNGso70.mjs";
 import "astro/zod";
 //#region src/build/headers.d.ts
 /**

package/dist/index.mjs

@@ -1 +1 @@
-import{a as e,i as t,t as n}from"./integration-B0arJ8Mq.mjs";export{t as HASHED_ASSET_RE,n as docsShell,e as publierCacheControl};
+import{a as e,i as t,t as n}from"./integration-DgDVMttc.mjs";export{t as HASHED_ASSET_RE,n as docsShell,e as publierCacheControl};

package/dist/{integration-CiX7_JNh.d.mts → integration-BHNGso70.d.mts}

@@ -151,6 +151,7 @@ interface SidebarAnchorConfig {
   badge?: string;
 }
 interface DocsConfig {
+  defaultOpenLevel?: number;
   tabSections: string[];
   sidebarMeta: Record<string, DocsSidebarMetaOverride>;
   versions: DocVersionConfig[];

package/dist/{integration-B0arJ8Mq.mjs → integration-DgDVMttc.mjs}

@@ -37,7 +37,7 @@ mdx.
   ]
 
 Missing:\n  ${C.map(e=>e.pkg).join(`
-  `)}\n`);let T=n.prefetch;ie(T===void 0?void 0:JSON.stringify(T),p)&&r({prefetch:{prefetchAll:!0,defaultStrategy:`viewport`}});let{entries:E,familyOnlyCss:D,slots:O}=_?De(_,u):{entries:[],familyOnlyCss:``,slots:[]},k=m.snippets??null,se=k==null?null:k===!1?`false`:JSON.stringify(k),ce=ae(p,se??void 0,w(A.join(u,`content/snippets`))),N=JSON.parse(ce),P={...e,snippets:N===null?void 0:N},F=JSON.stringify(P),I=e.math!==!1,L=I?pe(f,l):null,R=re(F,!!(g&&Object.keys(g).length>0),N!==null&&N!==!1,I&&L!==null),z=ne(p,I&&L!==null),B=he(R,g,L),V=ge(z,L),H=me(f,l);await _e(e,n.integrations,u,r);let U=ye({root:u,mathEnabled:I}),W=Ee({searchEnabled:e.search!==!1}),G=JSON.stringify({docs:$(u,`docs`),blog:$(u,`blog`),changelog:$(u,`changelog`)}),K=JSON.parse(te(p,x,G)),q=K.filter(e=>e.pattern.endsWith(`/rss.xml`)).map(e=>({title:e.pattern===`/blog/rss.xml`?`Blog feed`:e.pattern===`/changelog/rss.xml`?`Changelog feed`:e.pattern,href:e.pattern}));if(H){let e=n.markdown?.processor,t=e?.options?.hastPlugins;e?.name!==`unified`&&Array.isArray(t)&&t.length>0&&l.warn(`[@publier/shell] docsShell() is replacing the configured "${e?.name}" Markdown processor, discarding ${t.length} HAST plugin(s) another integration already registered on it — typically astro-expressive-code >=0.43, which registers into the processor it finds at its own setup. Code fences will silently lose ALL processing (plain <pre><code>, no syntax highlighting). Fix: move docsShell() BEFORE expressiveCode() (and any other Markdown-processor-touching integration) in astro.config.ts integrations[] so they register into docsShell's unified() processor instead.`)}r({markdown:H?{processor:H({remarkPlugins:B,rehypePlugins:V})}:{remarkPlugins:[...B],rehypePlugins:[...V]},vite:{ssr:{noExternal:[`@publier/shell`],external:[`@publier/native`]},build:{rollupOptions:{external:[`@publier/native`]}},optimizeDeps:{exclude:[`@publier/shell`,`@publier/native`]},plugins:[...be(f,l,n.vite?.plugins??[]),s({root:u}),o({root:u}),Q(`virtual:publier-nav-config`,`navConfig`,v),xe({entryPath:U}),Ce(),Q(`virtual:publier-announcement`,`announcement`,y),Q(`virtual:publier-site`,`site`,h),Q(`virtual:publier-docs-config`,`docsConfig`,b),Q(`virtual:publier-feeds`,`feeds`,q),Q(`virtual:publier-fonts`,`fonts`,{slots:O}),we()]}}),r({fonts:[{name:`Inter Variable`,cssVariable:`--publier-font-builtin-sans`,provider:M.npm({remote:!1}),fallbacks:[`system-ui`,`sans-serif`],weights:[`100 900`],styles:[`normal`],subsets:[`latin`],options:{package:`@fontsource-variable/inter`}},{name:`JetBrains Mono Variable`,cssVariable:`--publier-font-builtin-mono`,provider:M.npm({remote:!1}),fallbacks:[`monospace`],weights:[`100 800`],styles:[`normal`],subsets:[`latin`],options:{package:`@fontsource-variable/jetbrains-mono`}},...E]}),i(`page-ssr`,[`import ${JSON.stringify(U)};`,`import 'virtual:publier-theme-css';`,`import 'virtual:publier-custom-css';`,`import '@publier/shell/styles/base.css';`].join(`
+  `)}\n`);let T=n.prefetch;ie(T===void 0?void 0:JSON.stringify(T),p)&&r({prefetch:{prefetchAll:!0,defaultStrategy:`viewport`}});let{entries:E,familyOnlyCss:D,slots:O}=_?De(_,u):{entries:[],familyOnlyCss:``,slots:[]},k=m.snippets??null,se=k==null?null:k===!1?`false`:JSON.stringify(k),ce=ae(p,se??void 0,w(A.join(u,`content/snippets`))),N=JSON.parse(ce),P={...e,snippets:N===null?void 0:N},F=JSON.stringify(P),I=e.math!==!1,L=I?pe(f,l):null,R=re(F,!!(g&&Object.keys(g).length>0),N!==null&&N!==!1,I&&L!==null),z=ne(p,I&&L!==null),B=he(R,g,L),V=ge(z,L),H=me(f,l);await _e(e,n.integrations,u,r);let U=ye({root:u,mathEnabled:I}),W=Ee({searchEnabled:e.search!==!1}),G=JSON.stringify({docs:$(u,`docs`),blog:$(u,`blog`),changelog:$(u,`changelog`)}),K=JSON.parse(te(p,x,G)),q=K.filter(e=>e.pattern.endsWith(`/rss.xml`)).map(e=>({title:e.pattern===`/blog/rss.xml`?`Blog feed`:e.pattern===`/changelog/rss.xml`?`Changelog feed`:e.pattern,href:e.pattern}));if(H){let e=n.markdown?.processor,t=e?.options?.hastPlugins;e?.name!==`unified`&&Array.isArray(t)&&t.length>0&&l.warn(`[@publier/shell] docsShell() is replacing the configured "${e?.name}" Markdown processor, discarding ${t.length} HAST plugin(s) another integration already registered on it — typically astro-expressive-code >=0.43, which registers into the processor it finds at its own setup. Code fences will silently lose ALL processing (plain <pre><code>, no syntax highlighting). Fix: move docsShell() BEFORE expressiveCode() (and any other Markdown-processor-touching integration) in astro.config.ts integrations[] so they register into docsShell's unified() processor instead.`)}r({markdown:H?{processor:H({remarkPlugins:B,rehypePlugins:V})}:{remarkPlugins:[...B],rehypePlugins:[...V]},vite:{ssr:{noExternal:[`@publier/shell`],external:[`@publier/native`]},build:{rollupOptions:{external:[`@publier/native`]}},optimizeDeps:{exclude:[`@publier/shell`,`@publier/native`]},plugins:[...be(f,l,n.vite?.plugins??[]),s({root:u}),o({root:u}),Q(`virtual:publier-nav-config`,`navConfig`,v),xe({entryPath:U}),Ce(),Q(`virtual:publier-announcement`,`announcement`,y),Q(`virtual:publier-site`,`site`,h),Q(`virtual:publier-docs-config`,`docsConfig`,b),Q(`virtual:publier-appearance`,`appearance`,m.appearance),Q(`virtual:publier-feeds`,`feeds`,q),Q(`virtual:publier-fonts`,`fonts`,{slots:O}),we()]}}),r({fonts:[{name:`Inter Variable`,cssVariable:`--publier-font-builtin-sans`,provider:M.npm({remote:!1}),fallbacks:[`system-ui`,`sans-serif`],weights:[`100 900`],styles:[`normal`],subsets:[`latin`],options:{package:`@fontsource-variable/inter`}},{name:`JetBrains Mono Variable`,cssVariable:`--publier-font-builtin-mono`,provider:M.npm({remote:!1}),fallbacks:[`monospace`],weights:[`100 800`],styles:[`normal`],subsets:[`latin`],options:{package:`@fontsource-variable/jetbrains-mono`}},...E]}),i(`page-ssr`,[`import ${JSON.stringify(U)};`,`import 'virtual:publier-theme-css';`,`import 'virtual:publier-custom-css';`,`import '@publier/shell/styles/base.css';`].join(`
 `)),i(`page`,W),i(`head-inline`,`(function(){
   if (typeof window === 'undefined' || !window.sessionStorage || !window.fetch) return;
   var store = window.sessionStorage;

package/dist/integration.d.mts

@@ -1,2 +1,2 @@
-import { a as DocsSidebarMetaOverride, c as NavCta, d as NavVariant, f as SidebarAnchorConfig, g as publierCascadeHoistPlugin, h as hoistMediaOutOfUtilitiesLayer, i as DocsShellOptions, l as NavLink, m as docsShell, n as DocVersionConfig, o as LlmsConfig, p as SiteConfig, r as DocsConfig, s as NavConfig, t as AnnouncementConfig, u as NavPathRule } from "./integration-CiX7_JNh.mjs";
+import { a as DocsSidebarMetaOverride, c as NavCta, d as NavVariant, f as SidebarAnchorConfig, g as publierCascadeHoistPlugin, h as hoistMediaOutOfUtilitiesLayer, i as DocsShellOptions, l as NavLink, m as docsShell, n as DocVersionConfig, o as LlmsConfig, p as SiteConfig, r as DocsConfig, s as NavConfig, t as AnnouncementConfig, u as NavPathRule } from "./integration-BHNGso70.mjs";
 export { AnnouncementConfig, DocVersionConfig, DocsConfig, DocsShellOptions, DocsSidebarMetaOverride, LlmsConfig, NavConfig, NavCta, NavLink, NavPathRule, NavVariant, SidebarAnchorConfig, SiteConfig, docsShell, hoistMediaOutOfUtilitiesLayer, publierCascadeHoistPlugin };

package/dist/integration.mjs

@@ -1 +1 @@
-import{n as e,r as t,t as n}from"./integration-B0arJ8Mq.mjs";export{n as docsShell,e as hoistMediaOutOfUtilitiesLayer,t as publierCascadeHoistPlugin};
+import{n as e,r as t,t as n}from"./integration-DgDVMttc.mjs";export{n as docsShell,e as hoistMediaOutOfUtilitiesLayer,t as publierCascadeHoistPlugin};

package/dist/search/index.d.mts

@@ -51,6 +51,8 @@ interface SidebarMetaOverride {
   pages?: string[];
 }
 interface BuildSidebarOptions {
+  /** When set, folders stay collapsible regardless of child count. */
+  defaultOpenLevel?: number;
   meta?: Record<string, SidebarMetaOverride>;
   urlPrefix?: string;
 }

package/dist/themes/neutral.css

@@ -1,4 +1,4 @@
-[data-theme="light"] {
+:root, [data-theme="light"] {
 color-scheme: light;
 
 	--color-base-100: oklch(98.51% 0 0);
@@ -24,14 +24,38 @@ color-scheme: light;
 [data-theme="dark"] {
 color-scheme: dark;
 
-	--color-base-100: oklch(98.51% 0 0);
-	--color-base-200: oklch(100.00% 0 0);
-	--color-base-300: oklch(92.19% 0 0);
-	--color-base-content: oklch(20.46% 0 0);
-	--color-primary: oklch(37.15% 0 0);
-	--color-primary-content: oklch(98.51% 0 0);
-	--color-accent: oklch(55.55% 0 0);
-	--color-accent-content: oklch(98.51% 0 0);
+	--color-base-100: oklch(20.46% 0 0);
+	--color-base-200: oklch(25.2% 0 0);
+	--color-base-300: oklch(31.2% 0 0);
+	--color-base-content: oklch(92.19% 0 0);
+	--color-primary: oklch(76.5% 0 0);
+	--color-primary-content: oklch(20.46% 0 0);
+	--color-accent: oklch(70.8% 0 0);
+	--color-accent-content: oklch(20.46% 0 0);
+	--color-success: oklch(72.27% 0.192 149.58);
+	--color-error: oklch(57.71% 0.215 27.33);
+	--color-error-content: oklch(100.00% 0 0);
+
+	--radius-selector: 0.5rem;
+	--radius-field: 0.5rem;
+	--radius-box: 0.75rem;
+	--border: 1px;
+	--depth: 1;
+	--noise: 0;
+}
+
+@media (prefers-color-scheme: dark) {
+:root:not([data-theme]) {
+color-scheme: dark;
+
+	--color-base-100: oklch(20.46% 0 0);
+	--color-base-200: oklch(25.2% 0 0);
+	--color-base-300: oklch(31.2% 0 0);
+	--color-base-content: oklch(92.19% 0 0);
+	--color-primary: oklch(76.5% 0 0);
+	--color-primary-content: oklch(20.46% 0 0);
+	--color-accent: oklch(70.8% 0 0);
+	--color-accent-content: oklch(20.46% 0 0);
 	--color-success: oklch(72.27% 0.192 149.58);
 	--color-error: oklch(57.71% 0.215 27.33);
 	--color-error-content: oklch(100.00% 0 0);
@@ -43,6 +67,7 @@ color-scheme: dark;
 	--depth: 1;
 	--noise: 0;
 }
+}
 
 :root {
 	--publier-nav-height: 4rem;
@@ -52,17 +77,18 @@ color-scheme: dark;
 	--publier-layout-width: 1400px;
 }
 
-:root {
+:root,
+:root[data-theme="light"] {
 
-	--color-pl-muted: oklch(42% 0.06 0);
-	--color-pl-muted-bg: oklch(95% 0.022 0);
-	--color-pl-subtle: oklch(55% 0.03 0);
-	--color-pl-card: oklch(99.5% 0.008 0);
-	--color-pl-card-hover: oklch(97% 0.015 0);
-	--color-pl-popover: oklch(99.5% 0.008 0);
-	--color-pl-border: oklch(90% 0.02 0);
-	--color-pl-border-strong: oklch(82% 0.025 0);
-	--color-pl-sidebar-accent: oklch(95% 0.022 0);
+	--color-pl-muted: oklch(42% 0 0);
+	--color-pl-muted-bg: oklch(95% 0 0);
+	--color-pl-subtle: oklch(55% 0 0);
+	--color-pl-card: oklch(99.5% 0 0);
+	--color-pl-card-hover: oklch(97% 0 0);
+	--color-pl-popover: oklch(99.5% 0 0);
+	--color-pl-border: oklch(90% 0 0);
+	--color-pl-border-strong: oklch(82% 0 0);
+	--color-pl-sidebar-accent: oklch(95% 0 0);
 	--color-pl-sidebar-active: color-mix(in oklch, var(--color-primary) 10%, transparent);
 	--color-pl-sidebar-active-fg: var(--color-primary);
 
@@ -71,3 +97,23 @@ color-scheme: dark;
 	--menu-hover-bg: var(--color-pl-sidebar-accent);
 	--menu-hover-color: var(--color-pl-sidebar-accent-fg);
 }
+
+:root[data-theme="dark"],
+.dark {
+	--color-pl-muted: oklch(72% 0 0);
+	--color-pl-muted-bg: oklch(22.5% 0 0);
+	--color-pl-subtle: oklch(65% 0 0);
+	--color-pl-card: oklch(20.5% 0 0);
+	--color-pl-card-hover: oklch(26% 0 0);
+	--color-pl-popover: oklch(20.5% 0 0);
+	--color-pl-border: oklch(28% 0 0);
+	--color-pl-border-strong: oklch(36% 0 0);
+	--color-pl-sidebar-accent: oklch(26% 0 0);
+	--color-pl-sidebar-active: color-mix(in oklch, var(--color-primary) 14%, transparent);
+	--color-pl-sidebar-active-fg: var(--color-primary);
+
+	--menu-active-bg: var(--color-pl-sidebar-active);
+	--menu-active-color: var(--color-pl-sidebar-active-fg);
+	--menu-hover-bg: var(--color-pl-sidebar-accent);
+	--menu-hover-color: var(--color-pl-sidebar-accent-fg);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@publier/shell",
-  "version": "3.5.1",
+  "version": "3.6.0",
   "license": "UNLICENSED",
   "description": "Qwik + Astro docs layout for Publier sites.",
   "type": "module",
@@ -115,7 +115,7 @@
     "@github/details-menu-element": "^1.0.13",
     "@github/relative-time-element": "^5.3.1",
     "@github/tab-container-element": "^4.9.0",
-    "@publier/native": "2.2.3",
+    "@publier/native": "3.0.0",
     "@tailwindcss/typography": "^0.5.20",
     "astro-pagefind": "^2.0.1",
     "daisyui": "^5.7.22",

package/src/layouts/base-layout.astro

@@ -7,6 +7,7 @@ import ThemeToggle from '../components/theme-toggle.astro';
 import TopNavMobile from '../components/top-nav-mobile.astro';
 import { TopNav } from '../components/index.ts';
 import { announcement } from 'virtual:publier-announcement';
+import { appearance } from 'virtual:publier-appearance';
 import { feeds } from 'virtual:publier-feeds';
 import { fonts } from 'virtual:publier-fonts';
 import { navConfig } from 'virtual:publier-nav-config';
@@ -29,7 +30,7 @@ if (navProp !== undefined) {
 const storageKey = announcement?.storageKey ?? 'publier-announcement';
 
 const [head, bodyOpen, bodyClose] = JSON.parse(shellRenderBaseLayout(JSON.stringify({
-	title, description, className, favicon: site.favicon, footer: site.footer, serviceWorker: !!site.serviceWorker,
+	title, description, className, defaultScheme: appearance.default, strictScheme: appearance.strict, favicon: site.favicon, footer: site.footer, serviceWorker: !!site.serviceWorker,
 	announcement: announcement && { ...announcement, variant: announcement.variant ?? 'info', storageKey, dismissible: true },
 }))) as [string, string, string];
 ---
@@ -55,7 +56,7 @@ const [head, bodyOpen, bodyClose] = JSON.parse(shellRenderBaseLayout(JSON.string
 {navVariant !== false && (
 	<TopNav variant={navVariant} currentPath={currentPath}>
 		{navConfig.searchEnabled && <SearchButton slot="search" />}
-		<ThemeToggle slot="theme" />
+		<ThemeToggle slot="theme" default={appearance.default} strict={appearance.strict} />
 		<TopNavMobile slot="mobile" variant={navVariant} currentPath={currentPath} />
 	</TopNav>
 )}

package/src/routes/docs-slug.astro

@@ -27,7 +27,7 @@ const breadcrumbs = plan.breadcrumbs.map((crumb) => {
 	return page && crumb.href !== '/docs' ? { ...crumb, label: page.frontmatter.title } : crumb;
 });
 const ids = new Set(plan.section_entry_ids);
-const sidebarItems = buildSidebar(pages.filter((_, index) => ids.has(all[index].id)), { urlPrefix: '/docs', meta: docsConfig.sidebarMeta });
+const sidebarItems = buildSidebar(pages.filter((_, index) => ids.has(all[index].id)), { urlPrefix: '/docs', meta: docsConfig.sidebarMeta, defaultOpenLevel: docsConfig.defaultOpenLevel });
 const [bodyHead, bodyTail] = shellRenderDocsSlug(JSON.stringify({ title: entry.data.title, description: entry.data.description ?? null })).split('<!--publier-content-slot-->');
 const lastUpdated = entry.data.lastUpdated instanceof Date ? entry.data.lastUpdated : null;
 ---

package/src/virtual-modules.d.ts

@@ -16,6 +16,10 @@
  * imports them directly.
  */
 
+declare module 'virtual:publier-appearance' {
+	export const appearance: { default: 'system' | 'light' | 'dark'; strict: boolean };
+}
+
 declare module 'virtual:publier-theme-css';
 declare module 'virtual:publier-custom-css';
 
@@ -146,6 +150,8 @@ declare module 'virtual:publier-docs-config' {
 	import type { SidebarMetaOverride } from '@publier/shell/search';
 
 	export interface DocsConfig {
+		/** Sidebar levels expanded by default, from sidebar.defaultOpenLevel. */
+		defaultOpenLevel?: number;
 		/**
 		 * Top-level folders under `src/content/docs/` that render as their own
 		 * tab-scoped sidebars. Empty array → single flat sidebar for every