@publier/shell 3.4.2 → 3.5.0

package/dist/index.mjs

@@ -1 +1 @@
-import{a as e,i as t,t as n}from"./integration-CtaVlGLq.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-B0arJ8Mq.mjs";export{t as HASHED_ASSET_RE,n as docsShell,e as publierCacheControl};

package/dist/{integration-CtaVlGLq.mjs → integration-B0arJ8Mq.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`,`@qwik.dev/core`,`@qwik.dev/astro`],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-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.mjs

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

package/dist/runtime/lazy-upgrade-registry.d.mts

@@ -37,5 +37,6 @@ declare const upgradeThemeToggle: () => Promise<unknown>;
  * itself on `astro:page-load` after the first import.
  */
 declare const upgradeImageZoom: () => Promise<unknown>;
+declare const upgradeDetailsMenu: () => Promise<unknown>;
 //#endregion
-export { upgradeClipboardCopy, upgradeImageZoom, upgradeRelativeTime, upgradeTabContainer, upgradeThemeToggle };
+export { upgradeClipboardCopy, upgradeDetailsMenu, upgradeImageZoom, upgradeRelativeTime, upgradeTabContainer, upgradeThemeToggle };

package/dist/runtime/lazy-upgrade-registry.mjs

@@ -1 +1 @@
-const e=()=>import(`@github/clipboard-copy-element`),t=()=>import(`@github/tab-container-element`),n=()=>import(`@github/relative-time-element`),r=()=>import(`../theme-toggle-element-DJTP9Mbw.mjs`),i=()=>import(`../image-zoom-runtime-CnJeWrYp.mjs`);export{e as upgradeClipboardCopy,i as upgradeImageZoom,n as upgradeRelativeTime,t as upgradeTabContainer,r as upgradeThemeToggle};
+const e=()=>import(`@github/clipboard-copy-element`),t=()=>import(`@github/tab-container-element`),n=()=>import(`@github/relative-time-element`),r=()=>import(`../theme-toggle-element-DJTP9Mbw.mjs`),i=()=>import(`../image-zoom-runtime-CnJeWrYp.mjs`),a=()=>import(`@github/details-menu-element`);export{e as upgradeClipboardCopy,a as upgradeDetailsMenu,i as upgradeImageZoom,n as upgradeRelativeTime,t as upgradeTabContainer,r as upgradeThemeToggle};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@publier/shell",
-  "version": "3.4.2",
+  "version": "3.5.0",
   "license": "UNLICENSED",
   "description": "Qwik + Astro docs layout for Publier sites.",
   "_filesRationale": "mixed: dist for build-time TS + source globs for shipped .astro components",
@@ -113,9 +113,10 @@
     "@fontsource-variable/inter": "^5.2.8",
     "@fontsource-variable/jetbrains-mono": "^5.2.8",
     "@github/clipboard-copy-element": "^1.3.2",
+    "@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.0",
+    "@publier/native": "2.2.2",
     "@tailwindcss/typography": "^0.5.20",
     "astro-pagefind": "^2.0.1",
     "daisyui": "^5.7.22",
@@ -154,7 +155,7 @@
     "@astrojs/markdown-remark": "7.2.4",
     "@astrojs/mdx": "^7.0.8",
     "@qwik.dev/astro": "^1.1.0",
-    "@qwik.dev/core": "2.0.0-beta.45",
+    "@qwik.dev/core": "2.0.0-rc.0",
     "@types/mdast": "^4.0.4",
     "astro": "7.2.6",
     "astro-expressive-code": "^0.44.0",

package/src/components/index.ts

@@ -37,6 +37,7 @@ export { default as OpenInAI } from './open-in-ai.astro';
 export { default as PackageInstall } from './package-install.astro';
 export { default as Panels } from './panels.astro';
 export { default as SearchButton } from './search-button.astro';
+export { default as SectionSwitcher } from './section-switcher.astro';
 export { default as Sidebar } from './sidebar.astro';
 export { default as SkipLink } from './skip-link.astro';
 export { default as Steps } from './steps.astro';

package/src/components/section-switcher.astro

@@ -0,0 +1,25 @@
+---
+import { navigationActiveIndex } from '@publier/native';
+
+interface Props {
+	sections: { label: string; href: string }[];
+	currentPath: string;
+}
+const { sections, currentPath } = Astro.props;
+const active = navigationActiveIndex(JSON.stringify(sections), currentPath);
+---
+{sections.length > 1 && (
+  <nav aria-label="Documentation sections" class="mb-4">
+    <details class="dropdown w-full">
+      <summary class="btn btn-outline w-full justify-between font-normal" aria-label={`Documentation: ${sections[active]?.label ?? 'Choose a section'}`}>
+        <span class="truncate">{sections[active]?.label ?? 'Choose a section'}</span>
+        <span aria-hidden="true">⌄</span>
+      </summary>
+      <details-menu role="menu" class="dropdown-content menu bg-base-100 rounded-box border border-base-300 shadow-lg z-30 w-full p-2">
+        {sections.map((section, index) => (
+          <li role="none"><a role="menuitem" href={section.href} aria-current={index === active ? 'location' : undefined}>{section.label}</a></li>
+        ))}
+      </details-menu>
+    </details>
+  </nav>
+)}

package/src/routes/docs-slug.astro

@@ -1,7 +1,7 @@
 ---
 import { getCollection, render } from 'astro:content';
 import BaseLayout from '../layouts/base-layout.astro';
-import { type BreadcrumbItem, DocsLayout, LastModified, Sidebar, SkipLink, TableOfContents } from '../components/index.ts';
+import { type BreadcrumbItem, DocsLayout, LastModified, SectionSwitcher, Sidebar, SkipLink, TableOfContents } from '../components/index.ts';
 import { buildSidebar, entryToPage } from '@publier/shell/search';
 import { shellPlanDocsSlug, shellRenderDocsSlug } from '@publier/native';
 import { docsConfig } from 'virtual:publier-docs-config';
@@ -13,15 +13,31 @@ const { entry } = Astro.props;
 const { Content, headings } = await render(entry);
 const all = await getCollection('docs');
 const plan = JSON.parse(shellPlanDocsSlug(JSON.stringify({ entry_id: entry.id, title: entry.data.title, description: entry.data.description ?? null, tab_sections: docsConfig.tabSections, all_entry_ids: all.map((e) => e.id) }))) as { breadcrumbs: BreadcrumbItem[]; section_entry_ids: string[]; scope: string; current_path: string; sidebar_persist_key: string };
+const pages = all.map((e) => entryToPage({ slug: e.id.replace(/\.(mdx?|md)$/, ''), data: e.data, headings: [] }, { urlPrefix: '/docs' }));
+const sections = [
+	...(pages.some((page) => page.url === '/docs') ? [{ label: 'All documentation', href: '/docs' }] : []),
+	...docsConfig.tabSections.flatMap((section) => {
+		const path = `/docs/${section}`;
+		const page = pages.find((page) => page.url === path) ?? pages.find((page) => page.url.startsWith(`${path}/`));
+		return page ? [{ label: page.url === path ? page.frontmatter.title : section, href: page.url }] : [];
+	}),
+];
+const breadcrumbs = plan.breadcrumbs.map((crumb) => {
+	const page = pages.find((page) => page.url === crumb.href);
+	return page && crumb.href !== '/docs' ? { ...crumb, label: page.frontmatter.title } : crumb;
+});
 const ids = new Set(plan.section_entry_ids);
-const sidebarItems = buildSidebar(all.filter((e) => ids.has(e.id)).map((e) => entryToPage({ slug: e.id.replace(/\.(mdx?|md)$/, ''), data: e.data, headings: [] }, { urlPrefix: '/docs' })), { urlPrefix: '/docs', meta: docsConfig.sidebarMeta });
+const sidebarItems = buildSidebar(pages.filter((_, index) => ids.has(all[index].id)), { urlPrefix: '/docs', meta: docsConfig.sidebarMeta });
 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;
 ---
 <BaseLayout title={`${entry.data.title} — Docs`} description={entry.data.description} nav="docs">
 	<SkipLink slot="skip" targetId="main-content" />
-	<DocsLayout breadcrumbs={plan.breadcrumbs.length > 2 ? plan.breadcrumbs : undefined} sidebarPersistKey={plan.sidebar_persist_key}>
-		<Sidebar slot="sidebar" items={sidebarItems} currentPath={plan.current_path} versions={docsConfig.versions.length > 0 ? docsConfig.versions : undefined} anchors={docsConfig.anchors.length > 0 ? docsConfig.anchors : undefined} scope={plan.scope} />
+	<DocsLayout breadcrumbs={breadcrumbs.length > 2 ? breadcrumbs : undefined}>
+		<Fragment slot="sidebar">
+			<SectionSwitcher sections={sections} currentPath={plan.current_path} />
+			<Sidebar items={sidebarItems} currentPath={plan.current_path} versions={docsConfig.versions.length > 0 ? docsConfig.versions : undefined} anchors={docsConfig.anchors.length > 0 ? docsConfig.anchors : undefined} scope={plan.scope} />
+		</Fragment>
 		<TableOfContents slot="toc" headings={headings} />
 		<Fragment set:html={bodyHead} />
 		<Content />

package/src/styles/base.css

@@ -625,3 +625,23 @@ header.alert[data-publier-banner] [data-publier-banner-dismiss] {
 	margin-inline-start: 0;
 	color: var(--color-base-content);
 }
+
+/* Native dialog top-layer placement keeps mobile docs above the sticky header. */
+.publier-docs-dialog {
+	justify-items: start;
+	align-items: stretch;
+}
+.publier-docs-dialog .modal-box {
+	width: min(20rem, calc(100vw - 2rem));
+	max-width: none;
+	max-height: 100dvh;
+	height: 100dvh;
+	border-radius: 0;
+	padding: 1rem;
+}
+[data-publier-mobile-toc] .publier-toc__label {
+	display: none;
+}
+.prose :where(h2, h3, h4, h5, h6)[id] {
+	scroll-margin-top: 5rem;
+}