@publier/shell 3.1.5

package/package.json

@@ -0,0 +1,178 @@
+{
+  "name": "@publier/shell",
+  "version": "3.1.5",
+  "license": "UNLICENSED",
+  "description": "Qwik + Astro docs layout for Publier sites.",
+  "_filesRationale": "mixed: dist for build-time TS + source globs for shipped .astro components",
+  "type": "module",
+  "files": [
+    "dist",
+    "src/**/*.astro",
+    "src/**/*.css",
+    "!src/tailwind/themes/**",
+    "src/routes/**/*.xml.ts",
+    "src/schemas/**/*.ts",
+    "src/components/index.ts",
+    "src/components/types.ts",
+    "src/components/ui/types.ts",
+    "src/components/ask-ai.tsx",
+    "src/components/theme-storage.ts",
+    "src/components/theme-toggle-element.ts",
+    "src/runtime/banner-init.ts",
+    "src/runtime/lazy-upgrade-init.ts",
+    "src/runtime/sidebar-scroll-init.ts",
+    "src/runtime/theme-init.ts",
+    "src/icons/index.tsx",
+    "src/qwik.ts",
+    "src/astro-modules.d.ts",
+    "src/virtual-modules.d.ts",
+    "!src/**/__tests__/**",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./qwik": "./src/qwik.ts",
+    "./build": {
+      "types": "./dist/build-integration.d.mts",
+      "import": "./dist/build-integration.mjs"
+    },
+    "./schemas": "./src/schemas/index.ts",
+    "./loaders": {
+      "types": "./dist/loaders/index.d.mts",
+      "import": "./dist/loaders/index.mjs"
+    },
+    "./components": "./src/components/index.ts",
+    "./layouts/base-layout.astro": "./src/layouts/base-layout.astro",
+    "./routes/*.astro": "./src/routes/*.astro",
+    "./routes/*.xml.ts": "./src/routes/*.xml.ts",
+    "./search": {
+      "types": "./dist/search/index.d.mts",
+      "import": "./dist/search/index.mjs"
+    },
+    "./styles/base.css": "./src/styles/base.css",
+    "./styles/expressive-code.css": "./src/styles/expressive-code.css",
+    "./styles/tailwind-sources.css": "./src/styles/tailwind-sources.css",
+    "./plugins/remark-structure": {
+      "types": "./dist/plugins/remark-structure.d.mts",
+      "import": "./dist/plugins/remark-structure.mjs"
+    },
+    "./plugins/remark-asides": {
+      "types": "./dist/plugins/remark-asides.d.mts",
+      "import": "./dist/plugins/remark-asides.mjs"
+    },
+    "./plugins/remark-snippets": {
+      "types": "./dist/plugins/remark-snippets.d.mts",
+      "import": "./dist/plugins/remark-snippets.mjs"
+    },
+    "./plugins/remark-vars": {
+      "types": "./dist/plugins/remark-vars.d.mts",
+      "import": "./dist/plugins/remark-vars.mjs"
+    },
+    "./integration": {
+      "types": "./dist/integration.d.mts",
+      "import": "./dist/integration.mjs"
+    },
+    "./runtime/code-group-sync": {
+      "types": "./dist/runtime/code-group-sync.d.mts",
+      "import": "./dist/runtime/code-group-sync.mjs"
+    },
+    "./runtime/lazy-upgrade-registry": {
+      "types": "./dist/runtime/lazy-upgrade-registry.d.mts",
+      "import": "./dist/runtime/lazy-upgrade-registry.mjs"
+    },
+    "./runtime/tabs-sync": {
+      "types": "./dist/runtime/tabs-sync.d.mts",
+      "import": "./dist/runtime/tabs-sync.mjs"
+    },
+    "./tailwind": {
+      "types": "./dist/tailwind/index.d.mts",
+      "import": "./dist/tailwind/index.mjs"
+    },
+    "./tailwind/css-plugin": {
+      "types": "./dist/tailwind/css-plugin.d.mts",
+      "import": "./dist/tailwind/css-plugin.mjs"
+    },
+    "./tailwind/loader": {
+      "types": "./dist/tailwind/loader.d.mts",
+      "import": "./dist/tailwind/loader.mjs"
+    },
+    "./tailwind/preset.css": "./src/tailwind/preset.css",
+    "./tailwind/themes/*": "./dist/themes/*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@astrojs/rss": "^4.0.18",
+    "@astrojs/sitemap": "^3.7.2",
+    "@fontsource-variable/inter": "^5.2.8",
+    "@fontsource-variable/jetbrains-mono": "^5.2.8",
+    "@github/clipboard-copy-element": "^1.3.0",
+    "@github/relative-time-element": "^5.0.0",
+    "@github/tab-container-element": "^4.8.2",
+    "@tailwindcss/typography": "^0.5.19",
+    "astro-pagefind": "^1.8.6",
+    "daisyui": "^5.5.19",
+    "hastscript": "^9.0.1",
+    "katex": "^0.16.45",
+    "mdast-util-directive": "^3.1.0",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-to-markdown": "^2.1.2",
+    "mdast-util-to-string": "^4.0.0",
+    "medium-zoom": "^1.1.0",
+    "rehype-autolink-headings": "^7.1.0",
+    "rehype-external-links": "^3.0.0",
+    "rehype-katex": "^7.0.1",
+    "remark-directive": "^4.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-math": "^6.0.0",
+    "unist-util-visit": "^5.1.0",
+    "yaml": "^2.9.0",
+    "@publier/native": "1.1.3"
+  },
+  "peerDependencies": {
+    "@astrojs/markdown-remark": ">=7.0.0",
+    "@qwik.dev/astro": ">=1.0.0",
+    "@qwik.dev/core": ">=2.0.0-beta",
+    "@tailwindcss/vite": "^4",
+    "astro": "^6.0.0 || >=7.0.0-alpha.0",
+    "astro-expressive-code": ">=0.35.0",
+    "tailwindcss": "^4",
+    "vite": ">=8"
+  },
+  "peerDependenciesMeta": {
+    "astro-expressive-code": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@astrojs/mdx": "^7.0.0",
+    "@qwik.dev/core": "2.0.0-beta.34",
+    "@types/mdast": "^4.0.4",
+    "astro": "7.0.0",
+    "rehype-stringify": "^10.0.1",
+    "remark-parse": "^11.0.0",
+    "remark-rehype": "^11.1.2",
+    "tsdown": "^0.22.0",
+    "typescript": "^6.0.3",
+    "unified": "^11.0.5",
+    "vfile": "^6.0.3",
+    "vite": "^8.0.12"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Publier/publier.git",
+    "directory": "packages/shell"
+  },
+  "scripts": {
+    "build": "tsdown && node --experimental-strip-types --no-warnings ../../tools/css-theme-precompile/precompile.ts .",
+    "dev": "tsdown --watch",
+    "check-types": "tsc --noEmit",
+    "test": "echo \"@publier/shell: covered by root vitest workspace\" && exit 0"
+  }
+}

package/src/astro-modules.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Ambient type for `.astro` component imports.
+ *
+ * Astro files are normally typed via `astro sync` in a consumer project,
+ * but `@publier/shell` type-checks its own source via `tsc --noEmit` outside
+ * of Astro's build pipeline. This declaration lets `index.ts` re-export the
+ * default export of sibling `.astro` files without TypeScript erroring.
+ *
+ * At runtime, the consumer's Astro build (via Vite's astro plugin) provides
+ * the real implementation — the `.astro` default export is an Astro
+ * `ComponentFactory` that Astro's SSR renderer knows how to emit.
+ */
+declare module '*.astro' {
+	// Props are validated in each `.astro` file's own frontmatter via an
+	// exported `Props` interface; we use `any` at the boundary to avoid
+	// forcing a generic type import everywhere.
+	// biome-ignore lint/suspicious/noExplicitAny: library-boundary escape hatch, see docblock above.
+	const Component: (_props: any) => any;
+	export default Component;
+}

package/src/components/LastModified.astro

@@ -0,0 +1,25 @@
+---
+import { shellRenderLastModified } from '@publier/native';
+
+interface Props {
+	date: Date | string | null | undefined;
+	format?: 'relative' | 'absolute';
+}
+
+const { date, format = 'relative' } = Astro.props;
+
+const parsed: Date | null = date
+	? date instanceof Date
+		? Number.isNaN(date.getTime())
+			? null
+			: date
+		: (() => {
+				const d = new Date(date);
+				return Number.isNaN(d.getTime()) ? null : d;
+			})()
+	: null;
+
+const html = shellRenderLastModified(parsed ? parsed.getTime() : null, Date.now(), format);
+---
+
+<Fragment set:html={html} />

package/src/components/announcement-banner.astro

@@ -0,0 +1,25 @@
+---
+import { shellRenderAnnouncementBanner } from '@publier/native';
+
+export type AnnouncementBannerVariant = 'info' | 'warning' | 'success';
+
+interface Props {
+	message: string;
+	href?: string;
+	variant?: AnnouncementBannerVariant;
+	dismissible?: boolean;
+	storageKey?: string;
+}
+
+const {
+	message,
+	href,
+	variant = 'info',
+	dismissible = true,
+	storageKey = 'publier-banner-dismissed',
+} = Astro.props;
+
+const html = shellRenderAnnouncementBanner(message, href ?? null, variant, dismissible, storageKey);
+---
+
+<Fragment set:html={html} />

package/src/components/aside.astro

@@ -0,0 +1,17 @@
+---
+import { shellRenderAside } from '@publier/native';
+
+export type AsideType = 'note' | 'tip' | 'caution' | 'danger';
+
+interface Props {
+	type?: AsideType;
+	title?: string;
+}
+
+const { type = 'note', title } = Astro.props;
+const titleId = `publier-aside-${Math.random().toString(36).slice(2, 10)}`;
+const slotHtml = await Astro.slots.render('default');
+const html = shellRenderAside(type, title ?? null, slotHtml, titleId);
+---
+
+<Fragment set:html={html} />

package/src/components/ask-ai.tsx

@@ -0,0 +1,146 @@
+import { $, component$, useOnDocument, useSignal, useVisibleTask$ } from '@qwik.dev/core';
+import { MessageCircle, Send, Sparkles, X } from '../icons/index';
+
+export const AskAi = component$(() => {
+	const open = useSignal(false);
+	const input = useSignal('');
+	const textareaRef = useSignal<HTMLTextAreaElement>();
+
+	
+	useOnDocument(
+		'keydown',
+		$((e: Event) => {
+			const ke = e as KeyboardEvent;
+			if ((ke.metaKey || ke.ctrlKey) && ke.key === '/') {
+				ke.preventDefault();
+				open.value = !open.value;
+			}
+			if (ke.key === 'Escape' && open.value) {
+				open.value = false;
+			}
+		}),
+	);
+
+	
+	useOnDocument(
+		'publier:ai-toggle',
+		$(() => {
+			open.value = !open.value;
+		}),
+	);
+
+	
+	
+	// biome-ignore lint/correctness/noQwikUseVisibleTask: focusing a dialog input after it mounts requires DOM access.
+	useVisibleTask$(({ track }) => {
+		track(() => open.value);
+		if (open.value) {
+			textareaRef.value?.focus();
+		}
+	});
+
+	return (
+		<>
+			{}
+			<button
+				type="button"
+				class={[
+					'fixed bottom-4 right-4 z-50 inline-flex items-center gap-2 rounded-full border border-border bg-background px-4 py-2.5 text-sm font-medium text-foreground shadow-lg transition-all hover:bg-accent',
+					open.value ? 'translate-y-10 opacity-0 pointer-events-none' : '',
+				].join(' ')}
+				onClick$={() => {
+					open.value = true;
+				}}
+				aria-label="Ask AI"
+			>
+				<MessageCircle width={16} height={16} />
+				<span>Ask AI</span>
+			</button>
+
+			{}
+			{open.value && (
+				<>
+					{}
+					<div
+						class="fixed inset-0 z-50 bg-background/80 backdrop-blur-sm lg:hidden"
+						onClick$={() => {
+							open.value = false;
+						}}
+					/>
+
+					{}
+					<div
+						role="dialog"
+						aria-modal="true"
+						aria-label="Ask AI"
+						class="fixed inset-x-2 top-4 z-50 flex flex-col rounded-2xl border border-border bg-background shadow-2xl lg:inset-x-auto lg:inset-y-2 lg:right-2 lg:w-[460px] lg:rounded-xl"
+					>
+						{}
+						<div class="flex items-center justify-between border-b border-border px-4 py-3">
+							<div class="flex items-center gap-2">
+								<Sparkles width={16} height={16} class="text-primary" />
+								<span class="text-sm font-medium">Ask AI</span>
+							</div>
+							<button
+								type="button"
+								class="rounded-md p-1 text-muted-foreground transition-colors hover:bg-accent hover:text-foreground"
+								onClick$={() => {
+									open.value = false;
+								}}
+								aria-label="Close"
+							>
+								<X width={16} height={16} />
+							</button>
+						</div>
+
+						{}
+						<div class="flex-1 overflow-y-auto px-4 py-6">
+							<div class="flex flex-col items-center justify-center gap-3 text-center text-muted-foreground">
+								<div class="flex size-12 items-center justify-center rounded-full bg-accent">
+									<Sparkles width={24} height={24} class="text-primary" />
+								</div>
+								<p class="text-sm font-medium text-foreground">How can I help you?</p>
+								<p class="text-xs">Ask a question about the documentation.</p>
+								<p class="mt-4 text-xs">AI integration coming soon.</p>
+							</div>
+						</div>
+
+						{}
+						<div class="border-t border-border p-3">
+							<div class="flex items-end gap-2">
+								<textarea
+									ref={textareaRef}
+									class="max-h-32 min-h-[40px] flex-1 resize-none rounded-lg border border-border bg-muted/40 px-3 py-2 text-sm text-foreground placeholder:text-muted-foreground focus:border-primary focus:outline-none"
+									placeholder="Ask a question..."
+									rows={1}
+									value={input.value}
+									onInput$={(_, el) => {
+										input.value = el.value;
+									}}
+								/>
+								<button
+									type="button"
+									class="flex size-9 shrink-0 items-center justify-center rounded-lg bg-primary text-primary-foreground transition-colors hover:bg-primary/90 disabled:opacity-50"
+									disabled={!input.value.trim()}
+									aria-label="Send"
+								>
+									<Send width={16} height={16} />
+								</button>
+							</div>
+							<div class="mt-2 flex items-center justify-between text-[10px] text-muted-foreground">
+								<span>
+									Press{' '}
+									<kbd class="rounded border border-border bg-background px-1 py-0.5 font-mono">
+										⌘/
+									</kbd>{' '}
+									to toggle
+								</span>
+								<span>Powered by Publier AI</span>
+							</div>
+						</div>
+					</div>
+				</>
+			)}
+		</>
+	);
+});

package/src/components/badge.astro

@@ -0,0 +1,18 @@
+---
+import { shellRenderBadge } from '@publier/native';
+
+export type BadgeVariant = 'default' | 'note' | 'tip' | 'caution' | 'danger' | 'success';
+export type BadgeSize = 'small' | 'medium' | 'large';
+
+interface Props {
+	text: string;
+	variant?: BadgeVariant;
+	size?: BadgeSize;
+	class?: string;
+}
+
+const { text, variant = 'default', size = 'medium', class: customClass } = Astro.props;
+const html = shellRenderBadge(text, variant, size, customClass ?? null);
+---
+
+<Fragment set:html={html} />

package/src/components/breadcrumbs.astro

@@ -0,0 +1,23 @@
+---
+import { shellRenderBreadcrumbs } from '@publier/native';
+
+export interface BreadcrumbItem {
+	label: string;
+	href?: string;
+}
+
+interface Props {
+	items: BreadcrumbItem[];
+	label?: string;
+	class?: string;
+}
+
+const { items, label, class: customClass } = Astro.props;
+const html = shellRenderBreadcrumbs(
+	JSON.stringify(Array.isArray(items) ? items : []),
+	label ?? null,
+	customClass ?? null,
+);
+---
+
+<Fragment set:html={html} />

package/src/components/callouts/caution.astro

@@ -0,0 +1,13 @@
+---
+import Aside from '../aside.astro';
+
+interface Props {
+	title?: string;
+}
+
+const { title } = Astro.props;
+---
+
+<Aside type="caution" title={title}>
+	<slot />
+</Aside>

package/src/components/callouts/check.astro

@@ -0,0 +1,13 @@
+---
+import Aside from '../aside.astro';
+
+interface Props {
+	title?: string;
+}
+
+const { title } = Astro.props;
+---
+
+<Aside type="tip" title={title ?? 'Check'}>
+	<slot />
+</Aside>

package/src/components/callouts/danger.astro

@@ -0,0 +1,13 @@
+---
+import Aside from '../aside.astro';
+
+interface Props {
+	title?: string;
+}
+
+const { title } = Astro.props;
+---
+
+<Aside type="danger" title={title}>
+	<slot />
+</Aside>

package/src/components/callouts/info.astro

@@ -0,0 +1,13 @@
+---
+import Aside from '../aside.astro';
+
+interface Props {
+	title?: string;
+}
+
+const { title } = Astro.props;
+---
+
+<Aside type="note" title={title ?? 'Info'}>
+	<slot />
+</Aside>

package/src/components/callouts/note.astro

@@ -0,0 +1,13 @@
+---
+import Aside from '../aside.astro';
+
+interface Props {
+	title?: string;
+}
+
+const { title } = Astro.props;
+---
+
+<Aside type="note" title={title}>
+	<slot />
+</Aside>

package/src/components/callouts/tip.astro

@@ -0,0 +1,13 @@
+---
+import Aside from '../aside.astro';
+
+interface Props {
+	title?: string;
+}
+
+const { title } = Astro.props;
+---
+
+<Aside type="tip" title={title}>
+	<slot />
+</Aside>

package/src/components/callouts/warning.astro

@@ -0,0 +1,13 @@
+---
+import Aside from '../aside.astro';
+
+interface Props {
+	title?: string;
+}
+
+const { title } = Astro.props;
+---
+
+<Aside type="caution" title={title ?? 'Warning'}>
+	<slot />
+</Aside>

package/src/components/card-grid.astro

@@ -0,0 +1,14 @@
+---
+import { shellRenderCardGrid } from '@publier/native';
+
+interface Props {
+	minColumnWidth?: string;
+	class?: string;
+}
+
+const { minColumnWidth = '15rem', class: customClass } = Astro.props;
+const slotHtml = await Astro.slots.render('default');
+const html = shellRenderCardGrid(minColumnWidth, customClass ?? null, slotHtml);
+---
+
+<Fragment set:html={html} />

package/src/components/card.astro

@@ -0,0 +1,18 @@
+---
+import { shellRenderCard } from '@publier/native';
+
+export type CardVariant = 'default' | 'note' | 'tip' | 'danger' | 'success';
+
+interface Props {
+	title: string;
+	variant?: CardVariant;
+	class?: string;
+}
+
+const { title, variant = 'default', class: customClass } = Astro.props;
+const iconSlot = Astro.slots.has('icon') ? await Astro.slots.render('icon') : null;
+const slotHtml = await Astro.slots.render('default');
+const html = shellRenderCard(title, variant, customClass ?? null, iconSlot, slotHtml);
+---
+
+<Fragment set:html={html} />

package/src/components/code-group.astro

@@ -0,0 +1,55 @@
+---
+import { Code } from 'astro-expressive-code/components';
+
+export interface CodeGroupItem {
+	label: string;
+	code: string;
+	lang?: string;
+	filename?: string;
+}
+
+interface Props {
+	items: CodeGroupItem[];
+	syncKey?: string;
+}
+
+const { items, syncKey } = Astro.props;
+const id = `publier-cg-${Math.random().toString(36).slice(2, 10)}`;
+---
+
+<tab-container
+	class="not-prose my-4 rounded-box overflow-hidden border border-base-300 bg-base-200"
+	data-publier-cg
+	data-sync-key={syncKey}
+>
+	<div role="tablist" class="tabs tabs-border px-2">
+		{items.map((item, i) => (
+			<button
+				type="button"
+				role="tab"
+				id={`${id}-tab-${i}`}
+				aria-controls={`${id}-panel-${i}`}
+				aria-selected={i === 0 ? 'true' : 'false'}
+				tabindex={i === 0 ? 0 : -1}
+				class="tab font-mono"
+				data-tab-label={item.label}
+			>
+				{item.label}
+			</button>
+		))}
+	</div>
+	{items.map((item, i) => (
+		<div
+			id={`${id}-panel-${i}`}
+			role="tabpanel"
+			aria-labelledby={`${id}-tab-${i}`}
+			hidden={i !== 0}
+		>
+			<Code
+				code={item.code}
+				lang={item.lang ?? 'plaintext'}
+				title={item.filename}
+			/>
+		</div>
+	))}
+</tab-container>

package/src/components/columns.astro

@@ -0,0 +1,18 @@
+---
+import { shellRenderColumns } from '@publier/native';
+
+export type ColumnCount = 2 | 3 | 4;
+export type ColumnGap = 'sm' | 'md' | 'lg';
+
+interface Props {
+	cols?: ColumnCount;
+	gap?: ColumnGap;
+	class?: string;
+}
+
+const { cols = 2, gap = 'md', class: customClass } = Astro.props;
+const slotHtml = await Astro.slots.render('default');
+const html = shellRenderColumns(cols, gap, customClass ?? null, slotHtml);
+---
+
+<Fragment set:html={html} />