@publier/shell 0.2.0 → 0.3.0

package/dist/index.d.mts

@@ -11,7 +11,7 @@
  *   '@publier/shell/plugins/remark-structure'   → search-index structure collector
  *   '@publier/shell/plugins/remark-asides'      → :::note / :::tip / :::caution / :::danger
  */
-import { g as docsShell, i as DocsShellOptions } from "./integration-Dvp9zu_X.mjs";
+import { i as DocsShellOptions, v as docsShell } from "./integration-DGNkCfVa.mjs";
 import "astro/zod";
 /**
  * Cache-control + security headers emitted by `docsShell()` during

package/dist/{integration-Dvp9zu_X.d.mts → integration-DGNkCfVa.d.mts}

@@ -167,6 +167,19 @@ interface NavItem {
   href: string;
   external?: boolean;
   description?: string;
+  /** Mega menu: local path or https URL of a small decorative image. */
+  icon?: string;
+}
+/** Mega menu: a titled sub-group of a group; sub-groups nest up to three levels. */
+interface NavGroup {
+  label: string;
+  items?: NavItem[];
+  groups?: NavGroup[];
+}
+/** Mega menu: the column shared by every group's panel (featured links). */
+interface NavAside {
+  label?: string;
+  items: NavItem[];
 }
 /** A plain link, or a labelled group of one-level navigation items. */
 interface NavLink {
@@ -174,6 +187,14 @@ interface NavLink {
   href?: string;
   external?: boolean;
   items?: NavItem[];
+  /** Mega menu: titled sub-groups (a tree). */
+  groups?: NavGroup[];
+  /** Mega menu: sub-group columns on desktop, 1 to 4 (default 2). */
+  columns?: 1 | 2 | 3 | 4;
+  /** Mega menu: links under the group's body. */
+  footer?: NavItem[];
+  /** Mega menu: show a filter field in the group's panel. */
+  search?: boolean;
 }
 interface NavCta {
   label: string;
@@ -206,6 +227,8 @@ interface NavVariant {
   tabs: NavLink[];
   links: NavLink[];
   cta: NavCta | null;
+  /** Mega menu: featured links shown in every group's panel. */
+  aside?: NavAside;
 }
 interface NavPathRule {
   path: string;
@@ -220,4 +243,4 @@ interface NavConfig {
   searchHotkey: string;
 }
 declare function docsShell(options?: DocsShellOptions): AstroIntegration;
-export { hoistMediaOutOfUtilitiesLayer as _, DocsSidebarMetaOverride as a, NavCta as c, NavPathRule as d, NavProduct as f, docsShell as g, SiteConfig as h, DocsShellOptions as i, NavItem as l, SidebarAnchorConfig as m, DocVersionConfig as n, LlmsConfig as o, NavVariant as p, DocsConfig as r, NavConfig as s, AnnouncementConfig as t, NavLink as u, publierCascadeHoistPlugin as v };
+export { SiteConfig as _, DocsSidebarMetaOverride as a, publierCascadeHoistPlugin as b, NavConfig as c, NavItem as d, NavLink as f, SidebarAnchorConfig as g, NavVariant as h, DocsShellOptions as i, NavCta as l, NavProduct as m, DocVersionConfig as n, LlmsConfig as o, NavPathRule as p, DocsConfig as r, NavAside as s, AnnouncementConfig as t, NavGroup as u, docsShell as v, hoistMediaOutOfUtilitiesLayer as y };

package/dist/integration.d.mts

@@ -6,5 +6,5 @@
  * `injectScript`, `injectRoute`). The planner returns JSON "plans" the body
  * below iterates over and dispatches.
  */
-import { _ as hoistMediaOutOfUtilitiesLayer, a as DocsSidebarMetaOverride, c as NavCta, d as NavPathRule, f as NavProduct, g as docsShell, h as SiteConfig, i as DocsShellOptions, l as NavItem, m as SidebarAnchorConfig, n as DocVersionConfig, o as LlmsConfig, p as NavVariant, r as DocsConfig, s as NavConfig, t as AnnouncementConfig, u as NavLink, v as publierCascadeHoistPlugin } from "./integration-Dvp9zu_X.mjs";
-export { AnnouncementConfig, DocVersionConfig, DocsConfig, DocsShellOptions, DocsSidebarMetaOverride, LlmsConfig, NavConfig, NavCta, NavItem, NavLink, NavPathRule, NavProduct, NavVariant, SidebarAnchorConfig, SiteConfig, docsShell, hoistMediaOutOfUtilitiesLayer, publierCascadeHoistPlugin };
+import { _ as SiteConfig, a as DocsSidebarMetaOverride, b as publierCascadeHoistPlugin, c as NavConfig, d as NavItem, f as NavLink, g as SidebarAnchorConfig, h as NavVariant, i as DocsShellOptions, l as NavCta, m as NavProduct, n as DocVersionConfig, o as LlmsConfig, p as NavPathRule, r as DocsConfig, s as NavAside, t as AnnouncementConfig, u as NavGroup, v as docsShell, y as hoistMediaOutOfUtilitiesLayer } from "./integration-DGNkCfVa.mjs";
+export { AnnouncementConfig, DocVersionConfig, DocsConfig, DocsShellOptions, DocsSidebarMetaOverride, LlmsConfig, NavAside, NavConfig, NavCta, NavGroup, NavItem, NavLink, NavPathRule, NavProduct, NavVariant, SidebarAnchorConfig, SiteConfig, docsShell, hoistMediaOutOfUtilitiesLayer, publierCascadeHoistPlugin };

package/dist/presets-D_MQnAtK.mjs

@@ -0,0 +1 @@
+const e=[`almond`,`aspen`,`catppuccin`,`dark`,`dusk`,`emerald`,`enterprise`,`hearth`,`light`,`maple`,`neutral`,`ocean`,`purple`,`ruby`,`solar`,`vitepress`];function t(){return e}function n(t){return e.includes(t)}const r=[`display-xl`,`display-lg`,`display-md`,`heading-lg`,`heading-md`,`heading-sm`,`title`,`body-lg`,`body-md`,`body-sm`,`caption`,`label`,`button`,`code`],i=[`size`,`weight`,`line-height`,`tracking`];export{t as a,n as i,i as n,r,e as t};

package/dist/{presets-Bk89M8E_.d.mts → presets-PH6ZjfE7.d.mts}

@@ -5,7 +5,7 @@
  * Node-side introspection (reading CSS files, computing contrast) lives in
  * `./loader.ts` to keep `node:fs` out of the browser bundle path.
  */
-declare const AVAILABLE_THEMES: readonly ['almond', 'aspen', 'catppuccin', 'dark', 'dusk', 'emerald', 'enterprise', 'light', 'maple', 'neutral', 'ocean', 'purple', 'ruby', 'solar', 'vitepress'];
+declare const AVAILABLE_THEMES: readonly ['almond', 'aspen', 'catppuccin', 'dark', 'dusk', 'emerald', 'enterprise', 'hearth', 'light', 'maple', 'neutral', 'ocean', 'purple', 'ruby', 'solar', 'vitepress'];
 type ThemePreset = (typeof AVAILABLE_THEMES)[number];
 /** Return a read-only copy of the built-in preset list. */
 declare function listPresets(): readonly ThemePreset[];

package/dist/runtime/marketing-nav.mjs

@@ -1 +1 @@
-import"@github/details-menu-element";const e=matchMedia(`(min-width: 1024px)`),t=matchMedia(`(hover: hover) and (pointer: fine)`),n=matchMedia(`(prefers-reduced-motion: reduce)`);let r,i,a;function o(){return i||=import(`motion/mini`).then(e=>{r=e.animate}).catch(()=>{i=void 0}),i}function s(){a?.();let i=Array.from(document.querySelectorAll(`[data-publier-top-nav]:not([data-publier-docs-header]) details.dropdown[data-publier-nav-group]:not([data-publier-docs-selector])`));if(!i.length)return;let s=new AbortController,c={signal:s.signal},l=/* @__PURE__ */ new Set;e.matches&&!n.matches&&o();for(let a of i){let i=a.querySelector(`:scope > summary`),u=a.querySelector(`:scope > details-menu`);if(!i||!u)continue;let d,f,p=0,m=!1,h=()=>{clearTimeout(d),d=void 0},g=()=>{p+=1,f?.cancel(),f=void 0},_=()=>{h(),g(),m=!1,a.open=!1};l.add(_),a.addEventListener(`pointerenter`,n=>{n.pointerType!==`touch`&&e.matches&&t.matches&&(h(),a.open||=(a.dispatchEvent(new MouseEvent(`mousedown`)),m=!0,!0))},c),a.addEventListener(`pointerleave`,e=>{e.pointerType!==`touch`&&(h(),d=setTimeout(()=>{u.contains(document.activeElement)||_()},160))},c),i.addEventListener(`click`,e=>{e.detail>0&&m&&a.open&&e.preventDefault(),m=!1},c),document.addEventListener(`keydown`,e=>{e.key===`Escape`&&!e.defaultPrevented&&a.open&&!a.contains(document.activeElement)&&(_(),e.preventDefault())},c),a.addEventListener(`focusout`,()=>{queueMicrotask(()=>{!a.contains(document.activeElement)&&!a.matches(`:hover`)&&_()})},c),a.addEventListener(`toggle`,()=>{if(g(),!a.open){m=!1;return}if(n.matches||!e.matches)return;let t=p;o().then(()=>{t!==p||s.signal.aborted||a.isConnected&&a.open&&!n.matches&&e.matches&&(f=r?.(u,{opacity:[0,1],transform:[`translateY(6px)`,`translateY(0)`]},{duration:.18,ease:[.16,1,.3,1]}))})},c),n.addEventListener(`change`,g,c)}e.addEventListener(`change`,()=>{for(let e of l)e()},c),t.addEventListener(`change`,()=>{for(let e of l)e()},c),a=()=>{s.abort();for(let e of l)e();a=void 0}}s(),document.addEventListener(`astro:before-swap`,()=>a?.()),document.addEventListener(`astro:after-swap`,s);export{};
+import"@github/details-menu-element";function e(e){return e.normalize(`NFKC`).toLowerCase().replace(/\s+/gu,``)}function t(n,r,i){let a=i||r!==``&&e(n.title).includes(r),o=n.items.map(t=>r===``||a||e(t.title).includes(r)||e(t.description).includes(r)),s=n.sections.map(e=>t(e,r,a));return{visible:o.some(Boolean)||s.some(e=>e.visible),items:o,sections:s}}function n(n,r,i){let a=e(i),o=a!==``&&e(n).includes(a),s=r.map(e=>t(e,a,o));return{sections:s,empty:a!==``&&!s.some(e=>e.visible)}}const r=`[data-publier-nav-trigger]`,i=`[data-publier-nav-search]`,a=matchMedia(`(min-width: 1024px)`),o=matchMedia(`(hover: hover) and (pointer: fine)`),s=matchMedia(`(prefers-reduced-motion: reduce)`);let c,l,u;function d(){return l||=import(`motion/mini`).then(e=>{c=e.animate}).catch(()=>{l=void 0}),l}const f=e=>!e.closest(`dialog`),p=e=>e.querySelector(`:scope > summary`),m=e=>e.querySelector(`:scope > [data-publier-nav-panel]`);function h(e){return e?.textContent?.trim()??``}function g(e){return{title:h(e.querySelector(`:scope > [data-publier-nav-title]`)),items:Array.from(e.querySelectorAll(`:scope > ul > li[data-publier-nav-item]`)).map(e=>({title:h(e.querySelector(`[data-publier-nav-item-title]`)),description:h(e.querySelector(`[data-publier-nav-description]`))})),sections:Array.from(e.querySelectorAll(`:scope > [data-publier-nav-section]`)).map(g)}}function _(e){return Array.from(e.querySelectorAll(`[data-publier-nav-section]`)).filter(e=>e.parentElement?.closest(`[data-publier-nav-section]`)==null)}function v(e,t){e.hidden=!t.visible,e.querySelectorAll(`:scope > ul > li[data-publier-nav-item]`).forEach((e,n)=>{e.hidden=!(t.items[n]??!0)}),e.querySelectorAll(`:scope > [data-publier-nav-section]`).forEach((e,n)=>{let r=t.sections[n];r&&v(e,r)})}function y(e){e.hidden=!1;for(let t of e.querySelectorAll(`li[data-publier-nav-item]`))t.hidden=!1;for(let t of e.querySelectorAll(`[data-publier-nav-section]`))t.hidden=!1}const b=/* @__PURE__ */ new WeakMap;function x(e){let t=e.closest(`[data-publier-nav-panel]`),r=t?.querySelector(`[data-publier-nav-main]`);if(!t||!r)return;let i=_(r),a=b.get(r);a||(a=i.map(g),b.set(r,a));let o=n(t.closest(`[data-publier-nav-group]`)?.getAttribute(`data-publier-nav-group`)??``,a,e.value);if(e.value.trim()===``)for(let e of i)y(e);else i.forEach((e,t)=>{let n=o.sections[t];n&&v(e,n)});let s=r.querySelector(`[data-publier-nav-empty]`);s&&(s.hidden=!o.empty)}function S(e){let t=e.querySelector(i);t&&t.value!==``&&(t.value=``,x(t))}function C(e){let t=p(e),n=m(e);if(!t||!n)return;let r=t.getBoundingClientRect(),i=n.getBoundingClientRect();n.style.setProperty(`--publier-nav-mega-notch-x`,`${Math.round(r.left+r.width/2-i.left)}px`)}function w(){u?.();let e=Array.from(document.querySelectorAll(`details[data-publier-nav-mega-group]`));if(!e.length)return;let t=new AbortController,n={signal:t.signal},l=e.filter(f),h=/* @__PURE__ */ new Set,g=!1;a.matches&&!s.matches&&l.length&&d();let _=()=>l.filter(e=>e.open),v=e=>{g=_().some(t=>t!==e);for(let t of l)t!==e&&(t.open=!1);e.open=!0};for(let r of e){let e=p(r),i=m(r);if(!e||!i)continue;let l=f(r),u,y,b=0,x=!1,w=()=>{clearTimeout(u),u=void 0},T=()=>{b+=1,y?.cancel(),y=void 0},E=()=>{w(),T(),x=!1,r.open=!1};h.add(E),l&&(r.addEventListener(`pointerenter`,e=>{e.pointerType!==`touch`&&a.matches&&o.matches&&(w(),r.open||(x=!0,v(r)))},n),r.addEventListener(`pointerleave`,e=>{e.pointerType!==`touch`&&(w(),x&&(u=setTimeout(()=>{i.contains(document.activeElement)||E()},150)))},n),r.addEventListener(`focusout`,e=>{let t=e.relatedTarget;t instanceof Node&&r.contains(t)||setTimeout(()=>{r.open&&!r.contains(document.activeElement)&&(r.matches(`:hover`)||E())},0)},n)),e.addEventListener(`click`,e=>{e.detail>0&&x&&r.open?e.preventDefault():l&&!r.open&&(g=_().some(e=>e!==r)),x=!1},{...n,capture:!0}),r.addEventListener(`toggle`,()=>{if(T(),!r.open){x=!1,S(r);return}let e=g;if(g=!1,!l||(C(r),e||s.matches||!a.matches))return;let n=b;d().then(()=>{n!==b||t.signal.aborted||r.isConnected&&r.open&&!s.matches&&(y=c?.(i,{opacity:[0,1]},{duration:.15,ease:`easeOut`}))})},n),s.addEventListener(`change`,T,n)}let y=new Set(l.map(e=>e.closest(`[data-publier-top-nav]`)).filter(e=>e!==null));for(let e of y)e.addEventListener(`keydown`,t=>{let n=t.target instanceof Element?t.target.closest(r):null;if(!n||t.altKey||t.ctrlKey||t.metaKey)return;let a=Array.from(e.querySelectorAll(r)).filter(e=>e.offsetParent!==null),o=a.indexOf(n),s=n.parentElement instanceof HTMLDetailsElement?n.parentElement:null;if(t.key===`ArrowRight`||t.key===`ArrowLeft`){let e=a[(o+(t.key===`ArrowRight`?1:-1)+a.length)%a.length];if(!e)return;let n=_().length>0;e.focus();let r=e.parentElement instanceof HTMLDetailsElement?e.parentElement:null;if(n&&r&&l.includes(r))v(r);else if(n)for(let e of _())e.open=!1;t.preventDefault()}else t.key===`ArrowDown`&&s&&l.includes(s)&&(v(s),s.querySelector(`${i}, a[href]`)?.focus(),t.preventDefault())},n);document.addEventListener(`keydown`,e=>{if(e.key!==`Escape`||e.defaultPrevented)return;let t=(e.target instanceof Element?e.target:null)?.closest(i);if(t&&t.value!==``){t.value=``,x(t),e.preventDefault();return}let n=_()[0];if(!n)return;let r=n.contains(document.activeElement);for(let e of _())e.open=!1;r&&p(n)?.focus(),e.preventDefault()},n),document.addEventListener(`input`,e=>{let t=e.target instanceof Element?e.target.closest(i):null;t instanceof HTMLInputElement&&x(t)},n),document.addEventListener(`pointerdown`,e=>{if(e.target instanceof Element&&!e.target.closest(r))for(let t of _())t.contains(e.target)||(t.open=!1)},n),document.addEventListener(`click`,e=>{let t=e.target instanceof Element?e.target.closest(`[data-publier-nav-empty] [data-publier-search-button]`):null;if(t){for(let e of _())e.open=!1;t.closest(`dialog[data-publier-nav-dialog]`)?.close()}},n);let b=()=>{for(let e of h)e()};a.addEventListener(`change`,b,n),o.addEventListener(`change`,b,n),window.addEventListener(`resize`,()=>{for(let e of _())C(e)},n),u=()=>{t.abort(),b(),u=void 0}}function T(){w()}function E(){u?.()}const D=matchMedia(`(min-width: 1024px)`),O=matchMedia(`(hover: hover) and (pointer: fine)`),k=matchMedia(`(prefers-reduced-motion: reduce)`);let A,j,M;function N(){return j||=import(`motion/mini`).then(e=>{A=e.animate}).catch(()=>{j=void 0}),j}function P(){M?.();let e=Array.from(document.querySelectorAll(`[data-publier-top-nav]:not([data-publier-docs-header]) details.dropdown[data-publier-nav-group]:not([data-publier-docs-selector])`));if(!e.length)return;let t=new AbortController,n={signal:t.signal},r=/* @__PURE__ */ new Set;D.matches&&!k.matches&&N();for(let i of e){let e=i.querySelector(`:scope > summary`),a=i.querySelector(`:scope > details-menu`);if(!e||!a)continue;let o,s,c=0,l=!1,u=()=>{clearTimeout(o),o=void 0},d=()=>{c+=1,s?.cancel(),s=void 0},f=()=>{u(),d(),l=!1,i.open=!1};r.add(f),i.addEventListener(`pointerenter`,e=>{e.pointerType!==`touch`&&D.matches&&O.matches&&(u(),i.open||=(i.dispatchEvent(new MouseEvent(`mousedown`)),l=!0,!0))},n),i.addEventListener(`pointerleave`,e=>{e.pointerType!==`touch`&&(u(),o=setTimeout(()=>{a.contains(document.activeElement)||f()},160))},n),e.addEventListener(`click`,e=>{e.detail>0&&l&&i.open&&e.preventDefault(),l=!1},n),document.addEventListener(`keydown`,e=>{e.key===`Escape`&&!e.defaultPrevented&&i.open&&!i.contains(document.activeElement)&&(f(),e.preventDefault())},n),i.addEventListener(`focusout`,()=>{queueMicrotask(()=>{!i.contains(document.activeElement)&&!i.matches(`:hover`)&&f()})},n),i.addEventListener(`toggle`,()=>{if(d(),!i.open){l=!1;return}if(k.matches||!D.matches)return;let e=c;N().then(()=>{e!==c||t.signal.aborted||i.isConnected&&i.open&&!k.matches&&D.matches&&(s=A?.(a,{opacity:[0,1],transform:[`translateY(6px)`,`translateY(0)`]},{duration:.18,ease:[.16,1,.3,1]}))})},n),k.addEventListener(`change`,d,n)}D.addEventListener(`change`,()=>{for(let e of r)e()},n),O.addEventListener(`change`,()=>{for(let e of r)e()},n),M=()=>{t.abort();for(let e of r)e();M=void 0}}P(),T(),document.addEventListener(`astro:before-swap`,()=>{M?.(),E()}),document.addEventListener(`astro:after-swap`,()=>{P(),T()});export{};

package/dist/tailwind/index.d.mts

@@ -1,3 +1,3 @@
-import { i as listPresets, n as ThemePreset, r as isValidPreset, t as AVAILABLE_THEMES } from "../presets-Bk89M8E_.mjs";
+import { i as listPresets, n as ThemePreset, r as isValidPreset, t as AVAILABLE_THEMES } from "../presets-PH6ZjfE7.mjs";
 export declare const PRESET_CSS_PATH: '@publier/shell/tailwind/preset.css';
 export { AVAILABLE_THEMES, type ThemePreset, isValidPreset, listPresets };

package/dist/tailwind/index.mjs

@@ -1 +1 @@
-import{n as e,r as t,t as n}from"../presets-CYFX0GLA.mjs";const r=`@publier/shell/tailwind/preset.css`;export{n as AVAILABLE_THEMES,r as PRESET_CSS_PATH,e as isValidPreset,t as listPresets};
+import{a as e,i as t,t as n}from"../presets-D_MQnAtK.mjs";const r=`@publier/shell/tailwind/preset.css`;export{n as AVAILABLE_THEMES,r as PRESET_CSS_PATH,t as isValidPreset,e as listPresets};

package/dist/tailwind/loader.d.mts

@@ -4,7 +4,7 @@
  * Reads built-in preset files from disk. Node-only (uses `node:fs` via native).
  * Theme resolution / override composition lives in `./override.ts`.
  */
-import { i as listPresets, n as ThemePreset, r as isValidPreset, t as AVAILABLE_THEMES } from "../presets-Bk89M8E_.mjs";
+import { i as listPresets, n as ThemePreset, r as isValidPreset, t as AVAILABLE_THEMES } from "../presets-PH6ZjfE7.mjs";
 /** Shape of a parsed `theme.yaml`. Fields match `content-spec/theme.schema.json`. */
 interface ThemeYaml {
   /**
@@ -25,6 +25,11 @@ interface ThemeYaml {
   layout?: Record<string, string>;
   prose?: Record<string, string>;
   code?: Record<string, string>;
+  spacing?: Record<string, string>;
+  radius?: Record<string, string>;
+  elevation?: Record<string, string>;
+  motion?: Record<string, string>;
+  variants?: Record<string, string>;
   logo?: {
     light?: string;
     dark?: string;
@@ -32,7 +37,7 @@ interface ThemeYaml {
   favicon?: string;
 }
 /** Allow-listed override sections — parallel to the JSON Schema. */
-export declare const THEME_SECTIONS: readonly ['colors', 'typography', 'layout', 'prose', 'code'];
+export declare const THEME_SECTIONS: readonly ['colors', 'typography', 'layout', 'prose', 'code', 'spacing', 'radius', 'elevation', 'motion', 'variants'];
 type ThemeSection = (typeof THEME_SECTIONS)[number];
 /**
  * Keys accepted under each section. Mirrors content-spec/theme.schema.json.

package/dist/tailwind/loader.mjs

@@ -1,2 +1,2 @@
-import{n as e,r as t,t as n}from"../presets-CYFX0GLA.mjs";import{tailwindComposeThemeCss as r,tailwindReadPresetCss as i,tailwindResolveTheme as a}from"@publier/native";import{fileURLToPath as o}from"node:url";const s=[`colors`,`typography`,`layout`,`prose`,`code`],c={colors:[`primary`,`primary-content`,`secondary`,`secondary-content`,`accent`,`accent-content`,`neutral`,`neutral-content`,`base-100`,`base-200`,`base-300`,`base-content`,`info`,`info-content`,`success`,`success-content`,`warning`,`warning-content`,`error`,`error-content`],typography:[`heading`,`body`,`mono`,`body-weight`,`heading-weight`],layout:[`nav-height`,`sidebar-width`,`toc-width`,`page-max-width`],prose:[`content-gap-y`,`line-height`,`heading-line-height`],code:[`block-radius`,`inline-radius`,`inline-padding-y`,`inline-padding-x`]};function l(e){if(!e||typeof e!=`object`||Array.isArray(e))return{preset:void 0,overrides:{},overrideCss:``,errors:[]};let t=a(JSON.stringify(e));return{preset:t.preset??void 0,overrides:t.overrides,overrideCss:t.overrideCss,errors:t.errors.map(e=>({code:e.code,message:e.message,path:e.path}))}}function u(e){let t=Object.keys(e).sort();return t.length===0?``:`:root[data-theme="light"], :root[data-theme="dark"] {\n${t.map(t=>`\t${t}: ${e[t]};`).join(`
-`)}\n}\n`}function d(e,t){let n=l(e),r=t.defaultPreset;return n.preset!==void 0&&(t.isValidPreset(n.preset)?r=n.preset:n.errors.push({code:`unknown-preset`,message:`Unknown preset "${n.preset}". Theme will fall back to "${t.defaultPreset}".`,path:`preset`})),{...n,preset:r}}function f(e,t){return r(e,t)}const p=o(new URL(`./themes/`,import.meta.url));function m(e){return`${p}${e}.css`}async function h(e){return i(p,e)}export{n as AVAILABLE_THEMES,c as THEME_KEYS,s as THEME_SECTIONS,f as composeThemeCss,e as isValidPreset,t as listPresets,h as loadPresetCss,m as presetPath,u as renderOverrideCss,l as resolveTheme,d as resolveThemeWithPreset};
+import{a as e,i as t,n,r,t as i}from"../presets-D_MQnAtK.mjs";import{tailwindComposeThemeCss as a,tailwindReadPresetCss as o,tailwindResolveTheme as s}from"@publier/native";import{fileURLToPath as c}from"node:url";const l=[`colors`,`typography`,`layout`,`prose`,`code`,`spacing`,`radius`,`elevation`,`motion`,`variants`],u={colors:[`primary`,`primary-content`,`secondary`,`secondary-content`,`accent`,`accent-content`,`neutral`,`neutral-content`,`base-100`,`base-200`,`base-300`,`base-content`,`info`,`info-content`,`success`,`success-content`,`warning`,`warning-content`,`error`,`error-content`],typography:[`heading`,`body`,`mono`,`body-weight`,`heading-weight`,...r.flatMap(e=>n.map(t=>`scale-${e}-${t}`))],layout:[`nav-height`,`sidebar-width`,`toc-width`,`page-max-width`],prose:[`content-gap-y`,`line-height`,`heading-line-height`],code:[`block-radius`,`inline-radius`,`inline-padding-y`,`inline-padding-x`],spacing:[`xxs`,`xs`,`sm`,`md`,`base`,`lg`,`xl`,`xxl`,`section`],radius:[`button`,`control`,`card`,`panel`,`chip`],elevation:[`flat`,`raised`,`overlay`],motion:[`duration-fast`,`duration-base`,`duration-slow`,`easing`],variants:[`nav`,`button`,`card`,`hero`,`section`]};function d(e){if(!e||typeof e!=`object`||Array.isArray(e))return{preset:void 0,overrides:{},overrideCss:``,errors:[]};let t=s(JSON.stringify(e));return{preset:t.preset??void 0,overrides:t.overrides,overrideCss:t.overrideCss,errors:t.errors.map(e=>({code:e.code,message:e.message,path:e.path}))}}function f(e){let t=Object.keys(e).sort();return t.length===0?``:`:root[data-theme="light"], :root[data-theme="dark"] {\n${t.map(t=>`\t${t}: ${e[t]};`).join(`
+`)}\n}\n`}function p(e,t){let n=d(e),r=t.defaultPreset;return n.preset!==void 0&&(t.isValidPreset(n.preset)?r=n.preset:n.errors.push({code:`unknown-preset`,message:`Unknown preset "${n.preset}". Theme will fall back to "${t.defaultPreset}".`,path:`preset`})),{...n,preset:r}}function m(e,t){return a(e,t)}const h=c(new URL(`./themes/`,import.meta.url));function g(e){return`${h}${e}.css`}async function _(e){return o(h,e)}export{i as AVAILABLE_THEMES,u as THEME_KEYS,l as THEME_SECTIONS,m as composeThemeCss,t as isValidPreset,e as listPresets,_ as loadPresetCss,g as presetPath,f as renderOverrideCss,d as resolveTheme,p as resolveThemeWithPreset};

package/dist/themes/hearth.css

@@ -0,0 +1,227 @@
+:root, [data-theme="light"] {
+color-scheme: light;
+
+	--color-base-100: #ffffff;
+	--color-base-200: #f7f7f7;
+	--color-base-300: #ebebeb;
+	--color-base-content: #222222;
+	--color-primary: #c2410c;
+	--color-primary-content: #ffffff;
+	--color-secondary: #3f3f3f;
+	--color-secondary-content: #ffffff;
+	--color-accent: #c2410c;
+	--color-accent-content: #ffffff;
+	--color-neutral: #222222;
+	--color-neutral-content: #ffffff;
+	--color-error: #c13515;
+	--color-error-content: #ffffff;
+
+	--radius-selector: 9999px;
+	--radius-field: 8px;
+	--radius-box: 14px;
+	--border: 1px;
+	--depth: 0;
+	--noise: 0;
+}
+
+[data-theme="dark"] {
+color-scheme: dark;
+
+	--color-base-100: #1a1817;
+	--color-base-200: #24211f;
+	--color-base-300: #3a3634;
+	--color-base-content: #ececec;
+	--color-primary: #fb923c;
+	--color-primary-content: #1a1817;
+	--color-secondary: #a8a29e;
+	--color-secondary-content: #1a1817;
+	--color-accent: #fb923c;
+	--color-accent-content: #1a1817;
+	--color-neutral: #ececec;
+	--color-neutral-content: #1a1817;
+	--color-error: #f2765a;
+	--color-error-content: #1a1817;
+
+	--radius-selector: 9999px;
+	--radius-field: 8px;
+	--radius-box: 14px;
+	--border: 1px;
+	--depth: 0;
+	--noise: 0;
+}
+
+@media (prefers-color-scheme: dark) {
+:root:not([data-theme]) {
+color-scheme: dark;
+
+	--color-base-100: #1a1817;
+	--color-base-200: #24211f;
+	--color-base-300: #3a3634;
+	--color-base-content: #ececec;
+	--color-primary: #fb923c;
+	--color-primary-content: #1a1817;
+	--color-secondary: #a8a29e;
+	--color-secondary-content: #1a1817;
+	--color-accent: #fb923c;
+	--color-accent-content: #1a1817;
+	--color-neutral: #ececec;
+	--color-neutral-content: #1a1817;
+	--color-error: #f2765a;
+	--color-error-content: #1a1817;
+
+	--radius-selector: 9999px;
+	--radius-field: 8px;
+	--radius-box: 14px;
+	--border: 1px;
+	--depth: 0;
+	--noise: 0;
+}
+}
+
+:root {
+
+	--publier-scale-display-xl-size: 3.5rem;
+	--publier-scale-display-xl-weight: 600;
+	--publier-scale-display-xl-line-height: 1.1;
+	--publier-scale-display-xl-tracking: -0.02em;
+	--publier-scale-display-lg-size: 2.75rem;
+	--publier-scale-display-lg-weight: 600;
+	--publier-scale-display-lg-line-height: 1.12;
+	--publier-scale-display-lg-tracking: -0.02em;
+	--publier-scale-display-md-size: 2rem;
+	--publier-scale-display-md-weight: 600;
+	--publier-scale-display-md-line-height: 1.2;
+	--publier-scale-display-md-tracking: -0.01em;
+	--publier-scale-heading-lg-size: 1.75rem;
+	--publier-scale-heading-lg-weight: 600;
+	--publier-scale-heading-lg-line-height: 1.3;
+	--publier-scale-heading-lg-tracking: 0;
+	--publier-scale-heading-md-size: 1.375rem;
+	--publier-scale-heading-md-weight: 500;
+	--publier-scale-heading-md-line-height: 1.18;
+	--publier-scale-heading-md-tracking: -0.02em;
+	--publier-scale-heading-sm-size: 1.25rem;
+	--publier-scale-heading-sm-weight: 600;
+	--publier-scale-heading-sm-line-height: 1.2;
+	--publier-scale-heading-sm-tracking: 0;
+	--publier-scale-title-size: 1rem;
+	--publier-scale-title-weight: 600;
+	--publier-scale-title-line-height: 1.25;
+	--publier-scale-title-tracking: 0;
+	--publier-scale-body-lg-size: 1.125rem;
+	--publier-scale-body-lg-weight: 400;
+	--publier-scale-body-lg-line-height: 1.55;
+	--publier-scale-body-lg-tracking: 0;
+	--publier-scale-body-md-size: 1rem;
+	--publier-scale-body-md-weight: 400;
+	--publier-scale-body-md-line-height: 1.5;
+	--publier-scale-body-md-tracking: 0;
+	--publier-scale-body-sm-size: 0.875rem;
+	--publier-scale-body-sm-weight: 400;
+	--publier-scale-body-sm-line-height: 1.43;
+	--publier-scale-body-sm-tracking: 0;
+	--publier-scale-caption-size: 0.8125rem;
+	--publier-scale-caption-weight: 400;
+	--publier-scale-caption-line-height: 1.23;
+	--publier-scale-caption-tracking: 0;
+	--publier-scale-button-size: 1rem;
+	--publier-scale-button-weight: 500;
+	--publier-scale-button-line-height: 1.25;
+	--publier-scale-button-tracking: 0;
+	--publier-scale-label-size: 0.875rem;
+	--publier-scale-label-weight: 500;
+	--publier-scale-label-line-height: 1.29;
+	--publier-scale-label-tracking: 0;
+	--publier-scale-code-size: 0.875rem;
+	--publier-scale-code-weight: 400;
+	--publier-scale-code-line-height: 1.6;
+	--publier-scale-code-tracking: 0;
+
+	--publier-font-weight-body: 400;
+	--publier-font-weight-heading: 600;
+
+	--publier-space-xxs: 0.125rem;
+	--publier-space-xs: 0.25rem;
+	--publier-space-sm: 0.5rem;
+	--publier-space-md: 0.75rem;
+	--publier-space-base: 1rem;
+	--publier-space-lg: 1.5rem;
+	--publier-space-xl: 2rem;
+	--publier-space-xxl: 3rem;
+	--publier-space-section: 4rem;
+
+	--publier-radius-button: 8px;
+	--publier-radius-control: 8px;
+	--publier-radius-card: 14px;
+	--publier-radius-panel: 20px;
+	--publier-radius-chip: 9999px;
+	--publier-control-radius: 8px;
+	--publier-surface-radius: 14px;
+	--publier-card-radius: 14px;
+	--publier-nav-item-radius: 8px;
+	--publier-code-block-radius: 8px;
+	--publier-code-inline-radius: 6px;
+
+	--publier-elevation-flat: none;
+	--publier-elevation-raised:
+		0 0 0 1px rgb(0 0 0 / 0.02), 0 2px 6px rgb(0 0 0 / 0.04), 0 4px 8px rgb(0 0 0 / 0.1);
+	--publier-elevation-overlay:
+		0 0 0 1px rgb(0 0 0 / 0.02), 0 2px 6px rgb(0 0 0 / 0.04), 0 4px 8px rgb(0 0 0 / 0.1);
+
+	--publier-motion-duration-fast: 120ms;
+	--publier-motion-duration-base: 150ms;
+	--publier-motion-duration-slow: 240ms;
+	--publier-motion-easing: cubic-bezier(0.2, 0, 0, 1);
+
+	--publier-nav-height: 4.5rem;
+	--publier-page-max-width: 45rem;
+	--publier-layout-width: 1280px;
+	--publier-shadow-color: 0 0 0;
+}
+
+:root,
+:root[data-theme="light"] {
+	--color-pl-muted: #6a6a6a;
+	--color-pl-muted-bg: #f2f2f2;
+	--color-pl-subtle: #6a6a6a;
+	--color-pl-card: #ffffff;
+	--color-pl-card-hover: #ffffff;
+	--color-pl-popover: #ffffff;
+	--color-pl-border: #dddddd;
+	--color-pl-border-strong: #c1c1c1;
+	--color-pl-ring: #222222;
+	--color-pl-sidebar-accent: #f7f7f7;
+	--color-pl-sidebar-active: #fff4ed;
+	--color-pl-sidebar-active-fg: #c2410c;
+
+	--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);
+}
+
+:root[data-theme="dark"],
+.dark {
+	--color-pl-muted: #a8a29e;
+	--color-pl-muted-bg: #24211f;
+	--color-pl-subtle: #a8a29e;
+	--color-pl-card: #24211f;
+	--color-pl-card-hover: #24211f;
+	--color-pl-popover: #24211f;
+	--color-pl-border: #3a3634;
+	--color-pl-border-strong: #4a4644;
+	--color-pl-ring: #ececec;
+	--color-pl-sidebar-accent: #24211f;
+	--color-pl-sidebar-active: color-mix(in oklch, #fb923c 14%, transparent);
+	--color-pl-sidebar-active-fg: #fb923c;
+
+	--publier-elevation-raised:
+		0 0 0 1px #3a3634, 0 2px 6px rgb(0 0 0 / 0.08), 0 4px 8px rgb(0 0 0 / 0.2);
+	--publier-elevation-overlay:
+		0 0 0 1px #3a3634, 0 2px 6px rgb(0 0 0 / 0.08), 0 4px 8px rgb(0 0 0 / 0.2);
+
+	--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": "0.2.0",
+  "version": "0.3.0",
   "license": "UNLICENSED",
   "description": "Qwik + Astro docs layout for Publier sites.",
   "type": "module",
@@ -119,7 +119,7 @@
     "@github/details-menu-element": "^1.0.13",
     "@github/relative-time-element": "^5.3.1",
     "@github/tab-container-element": "^4.9.0",
-    "@publier/native": "0.1.1",
+    "@publier/native": "0.2.0",
     "@tailwindcss/typography": "^0.5.20",
     "astro-pagefind": "^2.0.1",
     "daisyui": "^5.7.50",

package/src/components/top-nav-mobile.astro

@@ -4,8 +4,8 @@ import { navConfig, type NavVariant } from 'virtual:publier-nav-config';
 import type { TopNavMobileProps } from './types.ts';
 
 const EMPTY: NavVariant = { brand: '', logo: null, tabs: [], links: [], cta: null };
-const { variant = 'default', currentPath = '', variantConfig } = Astro.props as TopNavMobileProps;
+const { variant = 'default', currentPath = '', variantConfig, navVariant } = Astro.props as TopNavMobileProps;
 const v = variantConfig ?? navConfig.variants[variant] ?? navConfig.variants.default ?? EMPTY;
-const html = shellRenderTopNavMobile(JSON.stringify({ currentPath, v }));
+const html = shellRenderTopNavMobile(JSON.stringify({ currentPath, v, navVariant, searchEnabled: navConfig.searchEnabled }));
 ---
 <Fragment set:html={html} />

package/src/components/top-nav.astro

@@ -4,7 +4,7 @@ import { navConfig, type NavVariant } from 'virtual:publier-nav-config';
 import type { TopNavProps } from './types.ts';
 
 const EMPTY: NavVariant = { brand: '', logo: null, tabs: [], links: [], cta: null };
-const { variant = 'default', currentPath = '', variantConfig } = Astro.props as TopNavProps;
+const { variant = 'default', currentPath = '', variantConfig, navVariant } = Astro.props as TopNavProps;
 const v = variantConfig ?? navConfig.variants[variant] ?? navConfig.variants.default ?? EMPTY;
 const [searchSlotHtml, themeSlotHtml, mobileSlotHtml] = await Promise.all([
 	Astro.slots.has('search') ? Astro.slots.render('search') : Promise.resolve(null),
@@ -12,7 +12,7 @@ const [searchSlotHtml, themeSlotHtml, mobileSlotHtml] = await Promise.all([
 	Astro.slots.has('mobile') ? Astro.slots.render('mobile') : Promise.resolve(null),
 ]);
 const html = shellRenderTopNav(JSON.stringify({
-	variant, currentPath, v,
+	variant, navVariant, currentPath, v,
 	searchEnabled: navConfig.searchEnabled,
 	searchSlotHtml, themeSlotHtml, mobileSlotHtml,
 }));

package/src/components/types.ts

@@ -479,12 +479,16 @@ export interface TopNavProps {
 	variantConfig?: import('virtual:publier-nav-config').NavVariant;
 	/** Current page path for active highlighting. Pass `Astro.url.pathname`. */
 	currentPath?: string;
+	/** Navigation style: `"mega"` renders group panels; anything else is the simple dropdown nav. */
+	navVariant?: string;
 }
 
 export interface TopNavMobileProps {
 	variant?: string;
 	variantConfig?: import('virtual:publier-nav-config').NavVariant;
 	currentPath?: string;
+	/** Same value as `TopNavProps.navVariant`. */
+	navVariant?: string;
 }
 
 // ---------------------------------------------------------------------------

package/src/layouts/base-layout.astro

@@ -12,6 +12,7 @@ import { feeds } from 'virtual:publier-feeds';
 import { fonts } from 'virtual:publier-fonts';
 import { navConfig, type NavVariant } from 'virtual:publier-nav-config';
 import { site } from 'virtual:publier-site';
+import { fullPreset, variants } from 'virtual:publier-theme-variants';
 
 interface Props { title: string; description?: string; nav?: string | false; navConfig?: NavVariant; class?: string; lang?: string }
 const { title, description, nav: navProp, navConfig: resolvedNav, class: className, lang = Astro.currentLocale ?? 'en' } = Astro.props;
@@ -28,6 +29,10 @@ if (navProp !== undefined) {
 			: (JSON.parse(matched) as string);
 }
 
+const htmlHooks = fullPreset
+	? Object.fromEntries([['data-full-preset', ''], ...Object.entries(variants).map(([k, v]) => [`data-variant-${k}`, v])])
+	: {};
+
 const emailProtectionStart = '<!--email_off-->';
 const emailProtectionEnd = '<!--/email_off-->';
 const storageKey = announcement?.storageKey ?? 'publier-announcement';
@@ -38,7 +43,7 @@ const [head, bodyOpen, bodyClose] = JSON.parse(shellRenderBaseLayout(JSON.string
 }))) as [string, string, string];
 ---
 <!doctype html>
-<html lang={lang}>
+<html lang={lang} {...htmlHooks}>
 <head>
 <Fragment set:html={head} />
 <Font cssVariable="--publier-font-builtin-sans" preload />
@@ -59,10 +64,10 @@ const [head, bodyOpen, bodyClose] = JSON.parse(shellRenderBaseLayout(JSON.string
 <slot name="skip" />
 <Fragment set:html={bodyOpen} />
 {navVariant !== false && (
-	<TopNav variant={navVariant} variantConfig={resolvedNav} currentPath={currentPath}>
+	<TopNav variant={navVariant} variantConfig={resolvedNav} currentPath={currentPath} navVariant={variants.nav}>
 		{navConfig.searchEnabled && <SearchButton slot="search" />}
 		<ThemeToggle slot="theme" default={appearance.default} strict={appearance.strict} />
-		<TopNavMobile slot="mobile" variant={navVariant} variantConfig={resolvedNav} currentPath={currentPath} />
+		<TopNavMobile slot="mobile" variant={navVariant} variantConfig={resolvedNav} currentPath={currentPath} navVariant={variants.nav} />
 	</TopNav>
 )}
 <slot />

package/src/tailwind/preset.css

@@ -193,3 +193,122 @@
 	--color-pl-sidebar-active-fg: var(--color-primary);
 	--color-pl-sidebar-border: var(--color-pl-border);
 }
+
+/* ─── Full-preset base layer ────────────────────────────────
+ * Every element a full preset can set, with neutral defaults, so a preset or
+ * `theme.yaml` can override any one of them and the colour-only presets keep
+ * looking as they do today. Cascade: this base, then the preset's theme file,
+ * then `theme.yaml` overrides, then `customCss`.
+ *
+ * The consuming rules below apply only when the document carries
+ * `data-full-preset` (a full preset, or a `theme.yaml` that sets one of these
+ * sections). Renderers emit the same markup either way; presets switch
+ * components through `data-variant-*` hooks on <html>. */
+@layer publier-theme {
+	:root {
+		--publier-radius-button: var(--radius-field, 0.5rem);
+		--publier-radius-control: var(--radius-field, 0.5rem);
+		--publier-radius-card: var(--radius-box, 0.75rem);
+		--publier-radius-panel: var(--radius-box, 0.75rem);
+		--publier-radius-chip: var(--radius-selector, 0.5rem);
+
+		--publier-space-xxs: 0.125rem;
+		--publier-space-xs: 0.25rem;
+		--publier-space-sm: 0.5rem;
+		--publier-space-md: 0.75rem;
+		--publier-space-base: 1rem;
+		--publier-space-lg: 1.5rem;
+		--publier-space-xl: 2rem;
+		--publier-space-xxl: 3rem;
+		--publier-space-section: 4rem;
+
+		--publier-elevation-flat: none;
+		--publier-elevation-raised: var(--shadow-sm);
+		--publier-elevation-overlay: var(--shadow-lg);
+
+		--publier-motion-duration-fast: 100ms;
+		--publier-motion-duration-base: 150ms;
+		--publier-motion-duration-slow: 240ms;
+		--publier-motion-easing: cubic-bezier(0.4, 0, 0.2, 1);
+	}
+
+	html[data-full-preset] {
+		--publier-transition-duration: var(--publier-motion-duration-base);
+		--publier-transition-timing: var(--publier-motion-easing);
+		--publier-card-radius: var(--publier-radius-card);
+		--publier-control-radius: var(--publier-radius-control);
+		--publier-surface-radius: var(--publier-radius-panel);
+	}
+
+	html[data-full-preset] .prose :where(h1) {
+		font-size: var(--publier-scale-display-lg-size);
+		font-weight: var(--publier-scale-display-lg-weight);
+		line-height: var(--publier-scale-display-lg-line-height);
+		letter-spacing: var(--publier-scale-display-lg-tracking);
+	}
+	html[data-full-preset] .prose :where(h2) {
+		font-size: var(--publier-scale-heading-lg-size);
+		font-weight: var(--publier-scale-heading-lg-weight);
+		line-height: var(--publier-scale-heading-lg-line-height);
+		letter-spacing: var(--publier-scale-heading-lg-tracking);
+	}
+	html[data-full-preset] .prose :where(h3) {
+		font-size: var(--publier-scale-heading-md-size);
+		font-weight: var(--publier-scale-heading-md-weight);
+		line-height: var(--publier-scale-heading-md-line-height);
+		letter-spacing: var(--publier-scale-heading-md-tracking);
+	}
+	html[data-full-preset] .prose :where(h4) {
+		font-size: var(--publier-scale-heading-sm-size);
+		font-weight: var(--publier-scale-heading-sm-weight);
+		line-height: var(--publier-scale-heading-sm-line-height);
+	}
+	html[data-full-preset] .prose :where(p, li) {
+		font-size: var(--publier-scale-body-md-size);
+		line-height: var(--publier-scale-body-md-line-height);
+	}
+	html[data-full-preset] .prose :where(.lead) {
+		font-size: var(--publier-scale-body-lg-size);
+		line-height: var(--publier-scale-body-lg-line-height);
+	}
+	html[data-full-preset] .btn {
+		font-size: var(--publier-scale-label-size);
+		font-weight: var(--publier-scale-label-weight);
+		border-radius: var(--publier-radius-button);
+	}
+	html[data-full-preset] .badge {
+		border-radius: var(--publier-radius-chip);
+	}
+	html[data-full-preset] .card {
+		border-radius: var(--publier-radius-card);
+	}
+	html[data-full-preset] :where(.dropdown-content, .menu.dropdown-content, [popover]) {
+		box-shadow: var(--publier-elevation-overlay);
+		border-radius: var(--publier-radius-card);
+	}
+	html[data-full-preset] :where(section, .publier-section) {
+		--publier-section-gap: var(--publier-space-section);
+	}
+
+	/* Component variants. */
+	html[data-full-preset][data-variant-button="pill"] .btn {
+		border-radius: 9999px;
+	}
+	html[data-full-preset][data-variant-button="square"] .btn {
+		border-radius: 0;
+	}
+	html[data-full-preset][data-variant-card="elevated"] .card {
+		box-shadow: var(--publier-elevation-raised);
+		border-color: transparent;
+	}
+	html[data-full-preset][data-variant-card="filled"] .card {
+		background-color: var(--color-pl-muted-bg);
+		border-color: transparent;
+	}
+	html[data-full-preset][data-variant-card="hairline"] .card {
+		border: 1px solid var(--color-pl-border);
+	}
+	html[data-full-preset][data-variant-card="hairline"] .card:hover {
+		box-shadow: var(--publier-elevation-raised);
+	}
+}

package/src/virtual-modules.d.ts

@@ -21,6 +21,13 @@ declare module 'virtual:publier-appearance' {
 }
 
 declare module 'virtual:publier-theme-css';
+
+declare module 'virtual:publier-theme-variants' {
+	import type { VariantSet } from './tailwind/presets.ts';
+	/** True for a full preset, or when `theme.yaml` sets a non-colour element. */
+	export const fullPreset: boolean;
+	export const variants: VariantSet;
+}
 declare module 'virtual:publier-custom-css';
 
 declare module 'virtual:publier-nav-config' {
@@ -29,6 +36,21 @@ declare module 'virtual:publier-nav-config' {
 		href: string;
 		external?: boolean;
 		description?: string;
+		/** Mega menu: local path or https URL of a small decorative image. */
+		icon?: string;
+	}
+
+	/** Mega menu: a titled sub-group of a group; sub-groups nest up to three levels. */
+	export interface NavGroup {
+		label: string;
+		items?: NavItem[];
+		groups?: NavGroup[];
+	}
+
+	/** Mega menu: the column shared by every group's panel (featured links). */
+	export interface NavAside {
+		label?: string;
+		items: NavItem[];
 	}
 
 	/** A plain link, or a labelled group of one-level navigation items. */
@@ -37,6 +59,14 @@ declare module 'virtual:publier-nav-config' {
 		href?: string;
 		external?: boolean;
 		items?: NavItem[];
+		/** Mega menu: titled sub-groups (a tree). */
+		groups?: NavGroup[];
+		/** Mega menu: sub-group columns on desktop, 1 to 4 (default 2). */
+		columns?: 1 | 2 | 3 | 4;
+		/** Mega menu: links under the group's body. */
+		footer?: NavItem[];
+		/** Mega menu: show a filter field in the group's panel. */
+		search?: boolean;
 	}
 
 	export interface NavCta {
@@ -69,6 +99,8 @@ declare module 'virtual:publier-nav-config' {
 		links: NavLink[];
 		/** Primary CTA button. Null when absent. */
 		cta: NavCta | null;
+		/** Mega menu: featured links shown in every group's panel. */
+		aside?: NavAside;
 	}
 
 	/**

package/dist/presets-CYFX0GLA.mjs

@@ -1 +0,0 @@
-const e=[`almond`,`aspen`,`catppuccin`,`dark`,`dusk`,`emerald`,`enterprise`,`light`,`maple`,`neutral`,`ocean`,`purple`,`ruby`,`solar`,`vitepress`];function t(){return e}function n(t){return e.includes(t)}export{n,t as r,e as t};