@vezham/start 0.3.3 → 26.0.0-alpha.6

package/LICENSE

@@ -0,0 +1,173 @@
+SPDX-License-Identifier: BUSL-1.1
+
+Business Source License 1.1
+
+License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+---
+
+Parameters
+
+Licensor:             Vezham Technologies Private Limited
+
+Licensed Work:        The source code and packages in this repository (“the Licensed Work”).
+                      The Licensed Work is (c) 2025–present Vezham Technologies Private Limited
+
+Release Tag:          The applicable release tag or commit identifier (for example, “v1.0.0”)
+                      published by the Licensor for this version of the Licensed Work.
+                      Users must cross-check the tag or commit identifier to verify
+                      the release version and applicable Change Date.
+
+Additional Use Grant: 1. You may make non-production use of the Licensed Work.
+
+                      2. You may make production use of the Licensed Work, provided
+                         your use does not include offering the Licensed Work, or any
+                         derivative thereof, to third parties on a hosted, embedded,
+                         or managed basis in order to compete with the Licensor’s
+                         commercial offerings based on the Licensed Work, or offerings
+                         that provide substantially similar functionality.
+
+                         For purposes of this license:
+
+                         A “competitive offering” is a Product that is offered to third
+                         parties on a paid basis, including through paid support,
+                         consulting, managed service arrangements, or similar commercial
+                         relationships, that significantly overlaps with the capabilities
+                         or functionality of the Licensor’s commercial offerings based on
+                         the Licensed Work.
+
+                         If your Product is not a competitive offering when you first
+                         make it generally available, it will not become a competitive
+                         offering solely because the Licensor releases a new version of the
+                         Licensed Work with additional features or capabilities. Products
+                         that are not provided on a paid basis are not competitive offerings.
+
+                         “Product” means any software or service that is (a) offered to end
+                         users for deployment in their own environments (self-managed), or
+                         (b) offered as a hosted, cloud, or managed service by you or on
+                         your behalf.
+
+                         “Embedded” means including the source code or executable code of
+                         the Licensed Work in a competitive offering. “Embedded” also means
+                         packaging or distributing the competitive offering in a way that
+                         requires the Licensed Work to be accessed, invoked, or downloaded
+                         for the competitive offering to function.
+
+                         Hosting or using the Licensed Work internally within your own
+                         organization, including your affiliates under common control,
+                         is not considered a competitive offering.
+
+                      3. Educational institutions and legally recognised non-profit
+                         organizations may use the Licensed Work in a production
+                         environment without restriction, provided such use is not 
+                         for commercial profit.
+
+                      For binding interpretive guidance on using Vezham products under
+                      the Business Source License, please visit our licensing FAQ:
+                      https://trust.vezham.com/legal/license-faq
+
+Change Date:          Four (4) years from the date the Licensed Work is first publicly
+                      released under the specified Release Tag
+
+Change License:       GNU Affero General Public License v3.0 (AGPL-3.0-or-later)
+                      The full text of the Change License is available at:
+                      https://www.gnu.org/licenses/agpl-3.0.html
+
+For information about commercial licensing or alternative arrangements,
+please contact the Licensor at: https://vezham.com
+or email: license@vezham.com
+
+For formal legal notices or IP-related correspondence,
+please contact: licensor@vezham.com
+
+---
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+For more information on the use of the Business Source License generally,
+please visit the Adopting and Developing Business Source License FAQ at:
+https://mariadb.com/bsl-faq-adopting
+
+---
+
+Business Source License 1.1
+
+---
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work.
+The Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work, and the Change Date may
+vary for each version of the Licensed Work released by the Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or modified
+form from a third party, the terms and conditions set forth in this License
+apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other versions
+of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of the
+Licensor or its affiliates (provided that you may use a trademark or logo of
+the Licensor as expressly required by this License).
+
+---
+
+Disclaimer
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+-----------------------------------------------------------------------------
+
+MariaDB hereby grants you permission to use this License’s text to license your
+works, and to refer to it using the trademark "Business Source License", as long
+as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 3.0 or any later version,
+   or a license that is compatible with GPL Version 3.0 or a later version,
+   where "compatible" means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 3.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

package/README.md

@@ -1 +1,3 @@
 # @vezham/start
+
+App providers, routing, and framework adapters.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAA"}

package/dist/lib/layouts/app/index.d.ts

@@ -0,0 +1,15 @@
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+export type AppShellProps = {
+    children: ReactNode;
+    contentClassName?: string;
+    footer?: ReactNode;
+    footerClassName?: string;
+    header?: ReactNode;
+    headerClassName?: string;
+    mainClassName?: string;
+    sidebar?: ReactNode;
+    sidebarClassName?: string;
+} & Omit<ComponentPropsWithoutRef<'div'>, 'children'>;
+export declare const AppShell: ({ children, className, contentClassName, footer, footerClassName, header, headerClassName, mainClassName, sidebar, sidebarClassName, ...props }: AppShellProps) => import("react").JSX.Element;
+export declare const AppLayout: ({ children, className, contentClassName, footer, footerClassName, header, headerClassName, mainClassName, sidebar, sidebarClassName, ...props }: AppShellProps) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/layouts/app/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/layouts/app/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMhE,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,SAAS,CAAA;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,GAAG,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAA;AAErD,eAAO,MAAM,QAAQ,GAAI,iJAYtB,aAAa,gCAiDf,CAAA;AAED,eAAO,MAAM,SAAS,oJAnDnB,aAAa,gCAmDiB,CAAA"}

package/dist/lib/layouts/app/index.js

@@ -0,0 +1,44 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/lib/layouts/app/index.tsx
+var cx = (...classNames) => {
+	return classNames.filter(Boolean).join(" ");
+};
+var AppShell = ({ children, className, contentClassName, footer, footerClassName, header, headerClassName, mainClassName, sidebar, sidebarClassName, ...props }) => {
+	return /* @__PURE__ */ jsx("div", {
+		"data-slot": "app-shell",
+		className: cx("bg-background text-foreground min-h-svh", className),
+		...props,
+		children: /* @__PURE__ */ jsxs("div", {
+			"data-slot": "app-shell-frame",
+			className: "flex min-h-svh",
+			children: [sidebar ? /* @__PURE__ */ jsx("aside", {
+				"data-slot": "app-sidebar",
+				className: cx("bg-background hidden w-64 shrink-0 border-r md:block", sidebarClassName),
+				children: sidebar
+			}) : null, /* @__PURE__ */ jsxs("div", {
+				"data-slot": "app-main",
+				className: cx("flex min-w-0 flex-1 flex-col", mainClassName),
+				children: [
+					header ? /* @__PURE__ */ jsx("header", {
+						"data-slot": "app-header",
+						className: cx("bg-background shrink-0 border-b", headerClassName),
+						children: header
+					}) : null,
+					/* @__PURE__ */ jsx("main", {
+						"data-slot": "app-content",
+						className: cx("min-w-0 flex-1", contentClassName),
+						children
+					}),
+					footer ? /* @__PURE__ */ jsx("footer", {
+						"data-slot": "app-footer",
+						className: cx("bg-background shrink-0 border-t", footerClassName),
+						children: footer
+					}) : null
+				]
+			})]
+		})
+	});
+};
+var AppLayout = AppShell;
+//#endregion
+export { AppLayout, AppShell };

package/dist/lib/layouts/docs/components.d.ts

@@ -0,0 +1,4 @@
+import { DocsLayoutProps, DocsPageProps } from './types';
+export declare const DocsLayout: ({ shell, ...props }: DocsLayoutProps) => import("react").JSX.Element;
+export declare const DocsPage: ({ full, shell, toc, ...props }: DocsPageProps) => import("react").JSX.Element;
+//# sourceMappingURL=components.d.ts.map

package/dist/lib/layouts/docs/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../../../src/lib/layouts/docs/components.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE7D,eAAO,MAAM,UAAU,GAAI,qBAA8B,eAAe,gCAGvE,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,gCAKtB,aAAa,gCA2Bf,CAAA"}

package/dist/lib/layouts/docs/components.js

@@ -0,0 +1,29 @@
+import { layouts } from "./layouts.js";
+import { DocsPageContent } from "./page-content.js";
+import { getPageComponents } from "./pages.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/lib/layouts/docs/components.tsx
+var DocsLayout = ({ shell = "docs", ...props }) => {
+	const Layout = layouts[shell];
+	return /* @__PURE__ */ jsx(Layout, { ...props });
+};
+var DocsPage = ({ full, shell = "docs", toc, ...props }) => {
+	const { Page, Body, Description, Title } = getPageComponents(shell);
+	const content = full ? /* @__PURE__ */ jsx(Body, { children: props.children }) : /* @__PURE__ */ jsx(DocsPageContent, {
+		...props,
+		Body,
+		Description,
+		Title
+	});
+	if (shell === "home") return /* @__PURE__ */ jsx("article", {
+		className: `mx-auto flex w-full min-w-0 flex-col gap-4 px-6 py-10 ${full ? "max-w-7xl" : "max-w-4xl"}`,
+		children: content
+	});
+	return /* @__PURE__ */ jsx(Page, {
+		full,
+		toc,
+		children: content
+	});
+};
+//#endregion
+export { DocsLayout, DocsPage };

package/dist/lib/layouts/docs/index.d.ts

@@ -0,0 +1,3 @@
+export { DocsLayout, DocsLayout as DocsLayoutShell, DocsPage, DocsPage as DocsPageShell } from './components';
+export type { DocsLayoutProps, DocsPageProps, DocsShell } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/layouts/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/layouts/docs/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,UAAU,IAAI,eAAe,EAC7B,QAAQ,EACR,QAAQ,IAAI,aAAa,EAC1B,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA"}

package/dist/lib/layouts/docs/index.js

@@ -0,0 +1,2 @@
+import { DocsLayout, DocsPage } from "./components.js";
+export { DocsLayout, DocsLayout as DocsLayoutShell, DocsPage, DocsPage as DocsPageShell };

package/dist/lib/layouts/docs/layout-components.d.ts

@@ -0,0 +1,9 @@
+import { DocsLayoutProps } from './types';
+type Props = Omit<DocsLayoutProps, 'shell'>;
+export declare const HomeDocsLayout: (props: Props) => import("react").JSX.Element;
+export declare const GlassDocsLayout: (props: Props) => import("react").JSX.Element;
+export declare const FluxDocsLayout: (props: Props) => import("react").JSX.Element;
+export declare const NotebookDocsLayout: (props: Props) => import("react").JSX.Element;
+export declare const StandardDocsLayout: (props: Props) => import("react").JSX.Element;
+export {};
+//# sourceMappingURL=layout-components.d.ts.map

package/dist/lib/layouts/docs/layout-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-components.d.ts","sourceRoot":"","sources":["../../../../src/lib/layouts/docs/layout-components.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,KAAK,KAAK,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;AAuB3C,eAAO,MAAM,cAAc,GAAI,OAAO,KAAK,gCAG1C,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,gCAO3C,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,OAAO,KAAK,gCAU1C,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,OAAO,KAAK,gCAc9C,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,OAAO,KAAK,gCAuB9C,CAAA"}

package/dist/lib/layouts/docs/layout-components.js

@@ -0,0 +1,81 @@
+import { createElement } from "react";
+import { jsx } from "react/jsx-runtime";
+import { DocsLayout } from "@vezham/docs-react/layouts/docs";
+import { DocsLayout as DocsLayout$1 } from "@vezham/docs-react/layouts/flux";
+import { GlassLayout } from "@vezham/docs-react/layouts/glass";
+import { HomeLayout } from "@vezham/docs-react/layouts/home";
+import { DocsLayout as DocsLayout$2 } from "@vezham/docs-react/layouts/notebook";
+//#region src/lib/layouts/docs/layout-components.tsx
+var getLayoutInputs = (props) => {
+	const { tree, nav, links, githubUrl, i18n, themeSwitch, searchToggle, tabMode, ...layoutProps } = props;
+	return {
+		children: props.children,
+		tree,
+		base: {
+			nav,
+			links,
+			githubUrl,
+			i18n,
+			themeSwitch,
+			searchToggle
+		},
+		layoutProps,
+		tabMode
+	};
+};
+var HomeDocsLayout = (props) => {
+	const { base, children } = getLayoutInputs(props);
+	return /* @__PURE__ */ jsx(HomeLayout, {
+		...base,
+		children
+	});
+};
+var GlassDocsLayout = (props) => {
+	const { base, children, tree } = getLayoutInputs(props);
+	return /* @__PURE__ */ jsx(GlassLayout, {
+		...base,
+		tree,
+		tabs: { transform: (option) => option },
+		children
+	});
+};
+var FluxDocsLayout = (props) => {
+	const { base, children, tree } = getLayoutInputs(props);
+	return /* @__PURE__ */ jsx(DocsLayout$1, {
+		...base,
+		tree,
+		containerProps: { className: "[&>[data-layout-main]]:w-full" },
+		children
+	});
+};
+var NotebookDocsLayout = (props) => {
+	const { base, children, layoutProps, tabMode, tree } = getLayoutInputs(props);
+	const notebookTabMode = tabMode === "top" ? "navbar" : tabMode === "auto" ? "sidebar" : tabMode;
+	return /* @__PURE__ */ jsx(DocsLayout$2, {
+		...base,
+		...layoutProps,
+		tree,
+		tabMode: notebookTabMode,
+		children
+	});
+};
+var StandardDocsLayout = (props) => {
+	const { base, children, layoutProps, tabMode, tree } = getLayoutInputs(props);
+	const { sidebar, ...docsLayoutProps } = layoutProps;
+	const { banner, footer, ...sidebarProps } = sidebar ?? {};
+	const docsTabMode = tabMode === "navbar" ? "top" : tabMode === "sidebar" ? "auto" : tabMode;
+	return /* @__PURE__ */ jsx(DocsLayout, {
+		...base,
+		...docsLayoutProps,
+		sidebar: sidebar && {
+			...sidebarProps,
+			banner: typeof banner === "function" ? createElement(banner) : banner,
+			footer: typeof footer === "function" ? createElement(footer) : footer
+		},
+		tree,
+		tabMode: docsTabMode,
+		children
+	});
+};
+//#endregion
+export { FluxDocsLayout, GlassDocsLayout, HomeDocsLayout, NotebookDocsLayout, StandardDocsLayout };

package/dist/lib/layouts/docs/layouts.d.ts

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react';
+import { DocsLayoutProps, DocsShell } from './types';
+type Props = Omit<DocsLayoutProps, 'shell'>;
+export declare const layouts: Record<DocsShell, (props: Props) => ReactNode>;
+export {};
+//# sourceMappingURL=layouts.d.ts.map

package/dist/lib/layouts/docs/layouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layouts.d.ts","sourceRoot":"","sources":["../../../../src/lib/layouts/docs/layouts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAStC,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEzD,KAAK,KAAK,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;AAE3C,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAMlE,CAAA"}

package/dist/lib/layouts/docs/layouts.js

@@ -0,0 +1,11 @@
+import { FluxDocsLayout, GlassDocsLayout, HomeDocsLayout, NotebookDocsLayout, StandardDocsLayout } from "./layout-components.js";
+//#region src/lib/layouts/docs/layouts.ts
+var layouts = {
+	docs: StandardDocsLayout,
+	flux: FluxDocsLayout,
+	glass: GlassDocsLayout,
+	home: HomeDocsLayout,
+	notebook: NotebookDocsLayout
+};
+//#endregion
+export { layouts };

package/dist/lib/layouts/docs/page-actions.d.ts

@@ -0,0 +1,4 @@
+export declare const PageActions: ({ markdownUrl }: {
+    markdownUrl: string;
+}) => import("react").JSX.Element;
+//# sourceMappingURL=page-actions.d.ts.map

package/dist/lib/layouts/docs/page-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-actions.d.ts","sourceRoot":"","sources":["../../../../src/lib/layouts/docs/page-actions.tsx"],"names":[],"mappings":"AAyEA,eAAO,MAAM,WAAW,GAAI,iBAAiB;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,gCAgHnE,CAAA"}

package/dist/lib/layouts/docs/page-actions.js

@@ -0,0 +1,154 @@
+import { pageActionsVariants } from "./page-actions.variants.js";
+import { useEffect, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Button, ButtonGroup, Dropdown } from "@vezham/react-v3";
+import { writeClipboardText } from "@vezham/docs-react/utils/clipboard";
+import { AltArrowDown, ChatRound, ClipboardCheck, CodeFile, Copy, Cursor, FileText, SquareArrowUp } from "@vezham/icons-react";
+//#region src/lib/layouts/docs/page-actions.tsx
+var styles = pageActionsVariants();
+var getPageActions = (markdownUrl) => {
+	const prompt = `Read ${typeof window === "undefined" ? markdownUrl : new URL(markdownUrl, window.location.origin).href}, I want to ask questions about this page.`;
+	return [
+		{
+			id: "markdown",
+			title: "View as Markdown",
+			description: "View page as Markdown format",
+			href: markdownUrl,
+			icon: FileText
+		},
+		{
+			id: "cursor",
+			title: "Add to Cursor",
+			description: "Install MCP Server on Cursor",
+			href: "cursor://anysphere.cursor-deeplink/mcp/install?name=vezham-react&config=eyJjb21tYW5kIjoibnB4IC15IEBoZXJvdWkvcmVhY3QtbWNwQGxhdGVzdCJ9",
+			icon: Cursor
+		},
+		{
+			id: "vscode",
+			title: "Add to VS Code",
+			description: "Install MCP Server on VS Code",
+			href: "vscode:mcp/install?%7B%22name%22%3A%22vezham-react%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40vezham%2Freact-mcp%40latest%22%5D%7D",
+			icon: CodeFile
+		},
+		{
+			id: "chatgpt",
+			title: "Open in ChatGPT",
+			description: "Ask questions about this page",
+			href: `https://chatgpt.com/?${new URLSearchParams({
+				hints: "search",
+				q: prompt
+			})}`,
+			icon: ChatRound
+		},
+		{
+			id: "claude",
+			title: "Open in Claude",
+			description: "Ask questions about this page",
+			href: `https://claude.ai/new?${new URLSearchParams({ q: prompt })}`,
+			icon: ChatRound
+		}
+	];
+};
+var PageActions = ({ markdownUrl }) => {
+	const [copiedAction, setCopiedAction] = useState();
+	const [isLoading, setLoading] = useState();
+	const [isOpen, setOpen] = useState(false);
+	const [error, setError] = useState();
+	const copiedTimer = useRef(void 0);
+	useEffect(() => () => clearTimeout(copiedTimer.current), []);
+	const actions = getPageActions(markdownUrl);
+	const copy = async (action) => {
+		setLoading(action);
+		setError(void 0);
+		try {
+			let text;
+			if (action === "markdown") {
+				const response = await fetch(markdownUrl);
+				if (!response.ok) throw new Error("Unable to load Markdown");
+				text = await response.text();
+			} else text = `Use this documentation page as context when helping me: ${new URL(markdownUrl, window.location.origin).href}`;
+			await writeClipboardText(text);
+			clearTimeout(copiedTimer.current);
+			setCopiedAction(action);
+			copiedTimer.current = setTimeout(() => setCopiedAction(void 0), 2e3);
+		} catch {
+			setError("Unable to copy. Please try again.");
+		} finally {
+			setLoading(void 0);
+		}
+	};
+	return /* @__PURE__ */ jsxs("div", {
+		className: styles.root(),
+		children: [
+			/* @__PURE__ */ jsxs(Button, {
+				isDisabled: Boolean(isLoading),
+				size: "md",
+				variant: "tertiary",
+				onPress: () => copy("prompt"),
+				children: [copiedAction === "prompt" ? /* @__PURE__ */ jsx(ClipboardCheck, { size: 16 }) : /* @__PURE__ */ jsx(ChatRound, { size: 16 }), copiedAction === "prompt" ? "Copied" : "Copy Prompt"]
+			}),
+			/* @__PURE__ */ jsxs(ButtonGroup, {
+				size: "md",
+				variant: "tertiary",
+				children: [/* @__PURE__ */ jsxs(Button, {
+					isDisabled: Boolean(isLoading),
+					onPress: () => copy("markdown"),
+					children: [copiedAction === "markdown" ? /* @__PURE__ */ jsx(ClipboardCheck, { size: 16 }) : /* @__PURE__ */ jsx(Copy, { size: 16 }), copiedAction === "markdown" ? "Copied" : "Copy Markdown"]
+				}), /* @__PURE__ */ jsxs(Dropdown, {
+					isOpen,
+					onOpenChange: setOpen,
+					children: [/* @__PURE__ */ jsxs(Button, {
+						"aria-label": "More page actions",
+						isIconOnly: true,
+						size: "md",
+						variant: "tertiary",
+						children: [/* @__PURE__ */ jsx(ButtonGroup.Separator, {}), /* @__PURE__ */ jsx(AltArrowDown, {
+							size: 14,
+							className: styles.chevron({ open: isOpen })
+						})]
+					}), /* @__PURE__ */ jsx(Dropdown.Popover, {
+						placement: "bottom end",
+						children: /* @__PURE__ */ jsx(Dropdown.Menu, {
+							"aria-label": "Page actions",
+							children: actions.map((action) => {
+								const Icon = action.icon;
+								const isAI = action.id === "chatgpt" || action.id === "claude";
+								return /* @__PURE__ */ jsxs(Dropdown.Item, {
+									href: action.href,
+									id: action.id,
+									rel: "noreferrer noopener",
+									target: "_blank",
+									textValue: action.title,
+									children: [
+										/* @__PURE__ */ jsx(Icon, {
+											size: 16,
+											className: styles.icon()
+										}),
+										/* @__PURE__ */ jsxs("span", {
+											className: styles.itemContent(),
+											children: [/* @__PURE__ */ jsx("span", { children: action.title }), /* @__PURE__ */ jsx("span", {
+												className: styles.description(),
+												children: action.description
+											})]
+										}),
+										isAI && /* @__PURE__ */ jsx(SquareArrowUp, {
+											size: 14,
+											className: styles.externalIcon()
+										})
+									]
+								}, action.id);
+							})
+						})
+					})]
+				})]
+			}),
+			error && /* @__PURE__ */ jsx("p", {
+				role: "alert",
+				className: styles.error(),
+				children: error
+			})
+		]
+	});
+};
+//#endregion
+export { PageActions };

package/dist/lib/layouts/docs/page-actions.variants.d.ts

@@ -0,0 +1,44 @@
+export declare const pageActionsVariants: import('tailwind-variants').TVReturnType<{
+    open: {
+        true: {
+            chevron: string;
+        };
+    };
+}, {
+    root: string;
+    chevron: string;
+    icon: string;
+    itemContent: string;
+    description: string;
+    externalIcon: string;
+    error: string;
+}, undefined, {
+    open: {
+        true: {
+            chevron: string;
+        };
+    };
+}, {
+    root: string;
+    chevron: string;
+    icon: string;
+    itemContent: string;
+    description: string;
+    externalIcon: string;
+    error: string;
+}, import('tailwind-variants').TVReturnTypeLike<{
+    open: {
+        true: {
+            chevron: string;
+        };
+    };
+}, {
+    root: string;
+    chevron: string;
+    icon: string;
+    itemContent: string;
+    description: string;
+    externalIcon: string;
+    error: string;
+}>>;
+//# sourceMappingURL=page-actions.variants.d.ts.map

package/dist/lib/layouts/docs/page-actions.variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-actions.variants.d.ts","sourceRoot":"","sources":["../../../../src/lib/layouts/docs/page-actions.variants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAY9B,CAAA"}

package/dist/lib/layouts/docs/page-actions.variants.js

@@ -0,0 +1,17 @@
+import { tv } from "@vezham/react-v3";
+//#region src/lib/layouts/docs/page-actions.variants.ts
+var pageActionsVariants = tv({
+	slots: {
+		root: "flex flex-wrap items-center justify-end gap-2",
+		chevron: "text-muted transition-transform",
+		icon: "mt-0.5 shrink-0",
+		itemContent: "flex min-w-0 flex-1 flex-col",
+		description: "text-muted text-xs",
+		externalIcon: "text-muted",
+		error: "text-danger w-full text-sm"
+	},
+	variants: { open: { true: { chevron: "rotate-180" } } },
+	defaultVariants: { open: false }
+});
+//#endregion
+export { pageActionsVariants };