@craftzbay/ui 0.4.0 → 0.6.0

package/dist-lib/showcase/components/Accordion.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Alert.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Avatar.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Badge.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Breadcrumbs.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Button.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Calendar.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Card.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Carousel.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Chart.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Checkbox.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Combobox.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/CommandPalette.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/ContextMenu.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/DataGrid.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/DatePicker.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Dialog.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Drawer.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/DropdownMenu.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/EmptyState.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/ErrorState.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/FileUpload.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Form.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/IconButton.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Input.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Kbd.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/MultiSelect.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Pagination.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Popover.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Progress.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/RadioGroup.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/ScrollArea.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Select.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Separator.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Sheet.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Sidebar.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Skeleton.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Slider.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Snackbar.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Spinner.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Stepper.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Switch.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Table.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Tabs.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/TagInput.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Textarea.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Timeline.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Toast.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Tooltip.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/TopNav.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/components/Tree.docs.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../registry/types';
+declare const doc: ComponentDoc;
+export default doc;

package/dist-lib/showcase/guides/DarkMode.d.ts

@@ -0,0 +1 @@
+export declare function DarkModeBody(): import("react/jsx-runtime").JSX.Element;

package/dist-lib/showcase/guides/Forms.d.ts

@@ -0,0 +1 @@
+export declare function FormsBody(): import("react/jsx-runtime").JSX.Element;

package/dist-lib/showcase/guides/Responsive.d.ts

@@ -0,0 +1 @@
+export declare function ResponsiveBody(): import("react/jsx-runtime").JSX.Element;

package/dist-lib/showcase/guides/Theming.d.ts

@@ -0,0 +1 @@
+export declare function ThemingBody(): import("react/jsx-runtime").JSX.Element;

package/dist-lib/showcase/layout/DocLayout.d.ts

@@ -0,0 +1,22 @@
+import { ReactNode } from 'react';
+import { DocSidebarSection } from './DocSidebar';
+import { Route } from '../routing';
+interface DocLayoutProps {
+    sidebar: DocSidebarSection[];
+    topLinks?: {
+        label: string;
+        route: Route;
+    }[];
+    current: {
+        kind: Route['kind'];
+        slug?: string;
+    };
+    children: ReactNode;
+}
+/**
+ * Two-column doc shell: left sidebar (sticky), right scrollable content.
+ * The sticky ShowcaseTopBar sits above this in App.tsx, so the sidebar
+ * top offset is 3.5rem (h-14).
+ */
+export declare function DocLayout({ sidebar, topLinks, current, children }: DocLayoutProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/showcase/layout/DocSidebar.d.ts

@@ -0,0 +1,27 @@
+import { Route } from '../routing';
+export interface DocSidebarEntry {
+    slug: string;
+    label: string;
+    group: string;
+}
+export interface DocSidebarSection {
+    /** Heading rendered above the section. Use 'top' for the "Get started" links. */
+    title: string;
+    /** kind = 'component' | 'template' | 'guide' — used to build the URL. */
+    kind: 'component' | 'template' | 'guide';
+    entries: DocSidebarEntry[];
+}
+interface DocSidebarProps {
+    sections: DocSidebarSection[];
+    current?: {
+        kind: Route['kind'];
+        slug?: string;
+    };
+    /** Top links: Overview / Components index / Templates index / Guides index. */
+    topLinks?: {
+        label: string;
+        route: Route;
+    }[];
+}
+export declare function DocSidebar({ sections, current, topLinks }: DocSidebarProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/showcase/layout/ShowcaseTopBar.d.ts

@@ -0,0 +1,13 @@
+import { Route } from '../routing';
+interface ShowcaseTopBarProps {
+    theme: 'light' | 'dark';
+    onToggleTheme: () => void;
+    onOpenPalette: () => void;
+    current: Route;
+}
+/**
+ * Persistent top bar shared by Home + docs pages. Hidden in full-bleed
+ * preview routes (templates rendered for screenshot / live use).
+ */
+export declare function ShowcaseTopBar({ theme, onToggleTheme, onOpenPalette, current, }: ShowcaseTopBarProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/showcase/layout/sidebars.d.ts

@@ -0,0 +1,14 @@
+import { Route } from '../routing';
+import { DocSidebarSection } from './DocSidebar';
+/**
+ * Build the sidebar sections + top links for each page kind.
+ * Same sidebar shape across components / templates / guides — only the
+ * active highlight differs.
+ */
+export declare function buildComponentSidebar(): DocSidebarSection[];
+export declare function buildTemplateSidebar(): DocSidebarSection[];
+export declare function buildGuideSidebar(): DocSidebarSection[];
+export declare const docTopLinks: {
+    label: string;
+    route: Route;
+}[];

package/dist-lib/showcase/pages/ComponentDocPage.d.ts

@@ -0,0 +1,6 @@
+import { ComponentDoc } from '../registry/types';
+interface ComponentDocPageProps {
+    doc: ComponentDoc;
+}
+export declare function ComponentDocPage({ doc }: ComponentDocPageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/showcase/pages/ComponentsIndexPage.d.ts

@@ -0,0 +1 @@
+export declare function ComponentsIndexPage(): import("react/jsx-runtime").JSX.Element;

package/dist-lib/showcase/pages/GuidePage.d.ts

@@ -0,0 +1,6 @@
+import { GuideDoc } from '../registry/types';
+interface GuidePageProps {
+    doc: GuideDoc;
+}
+export declare function GuidePage({ doc }: GuidePageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/showcase/pages/GuidesIndexPage.d.ts

@@ -0,0 +1 @@
+export declare function GuidesIndexPage(): import("react/jsx-runtime").JSX.Element;

package/dist-lib/showcase/pages/HomePage.d.ts

@@ -0,0 +1 @@
+export declare function HomePage(): import("react/jsx-runtime").JSX.Element;

package/dist-lib/showcase/pages/TemplateDocPage.d.ts

@@ -0,0 +1,6 @@
+import { TemplateDoc } from '../registry/types';
+interface TemplateDocPageProps {
+    doc: TemplateDoc;
+}
+export declare function TemplateDocPage({ doc }: TemplateDocPageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/showcase/pages/TemplatesIndexPage.d.ts

@@ -0,0 +1 @@
+export declare function TemplatesIndexPage(): import("react/jsx-runtime").JSX.Element;

package/dist-lib/showcase/registry/components.d.ts

@@ -0,0 +1,4 @@
+import { ComponentDoc } from './types';
+export declare const componentDocs: ComponentDoc[];
+export declare function getComponentDoc(slug: string): ComponentDoc | undefined;
+export declare function getRelatedDocs(slugs: string[]): ComponentDoc[];

package/dist-lib/showcase/registry/guides.d.ts

@@ -0,0 +1,3 @@
+import { GuideDoc } from './types';
+export declare const guideDocs: GuideDoc[];
+export declare function getGuideDoc(slug: string): GuideDoc | undefined;

package/dist-lib/showcase/registry/templates.d.ts

@@ -0,0 +1,3 @@
+import { TemplateDoc } from './types';
+export declare const templateDocs: TemplateDoc[];
+export declare function getTemplateDoc(slug: string): TemplateDoc | undefined;

package/dist-lib/showcase/registry/types.d.ts

@@ -0,0 +1,69 @@
+import { ReactNode } from 'react';
+export interface PropRow {
+    name: string;
+    type: string;
+    default?: string;
+    required?: boolean;
+    description: string;
+}
+export interface PropGroup {
+    title?: string;
+    rows: PropRow[];
+}
+export interface Example {
+    /** Short title used as the section heading on the doc page. */
+    title: string;
+    /** Optional 1–2 sentence explainer rendered above the demo. */
+    description?: string;
+    /** Live, fully interactive React node rendered in the Preview tab. */
+    preview: ReactNode;
+    /** Verbatim source code shown in the Code tab + Copy button. */
+    code: string;
+    /** Optional override for the preview surface (e.g. add height / padding). */
+    surfaceClassName?: string;
+}
+export type ComponentGroup = 'Buttons' | 'Inputs' | 'Feedback' | 'Overlays' | 'Navigation' | 'Layout' | 'Data Display' | 'Typography';
+export interface ComponentDoc {
+    /** URL slug — e.g. 'button'. */
+    slug: string;
+    /** Display name — e.g. 'Button'. */
+    name: string;
+    group: ComponentGroup;
+    /** One-line tagline shown under the title and in lists. */
+    description: string;
+    /** Names re-exported from `@craftzbay/ui` for this component. */
+    exports: string[];
+    /** Path under src/components/ui/ — used for the GitHub source link. */
+    sourceFile: string;
+    examples: Example[];
+    /** Each table is rendered with its own optional title. */
+    api?: PropGroup[];
+    accessibility?: string[];
+    /** Cross-links rendered at the bottom of the page. */
+    related?: {
+        slug: string;
+        reason: string;
+    }[];
+}
+export interface TemplateDoc {
+    slug: string;
+    name: string;
+    /** One-line tagline. */
+    description: string;
+    /** Names re-exported from `@craftzbay/ui` (or component path). */
+    exports: string[];
+    sourceFile: string;
+    /** Full-bleed preview slug (#preview/<slug>). */
+    previewSlug?: string;
+    examples: Example[];
+    api?: PropGroup[];
+    /** What flows / pages this template is intended for. */
+    useCases?: string[];
+}
+export interface GuideDoc {
+    slug: string;
+    title: string;
+    description: string;
+    /** Rendered as the body of the guide page. */
+    body: ReactNode;
+}

package/dist-lib/showcase/routing.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Showcase routing — hash-based, two-segment.
+ *
+ *   #                       → home
+ *   #components             → components index
+ *   #components/button      → individual component doc
+ *   #templates              → templates index
+ *   #templates/auth-signin  → individual template page
+ *   #guides                 → guides index
+ *   #guides/theming         → individual guide
+ *   #catalog                → legacy: full mini-demo wall
+ *   #preview/auth-signin    → full-bleed live preview of a template
+ */
+export type Route = {
+    kind: 'home';
+} | {
+    kind: 'catalog';
+} | {
+    kind: 'components-index';
+} | {
+    kind: 'component';
+    slug: string;
+} | {
+    kind: 'templates-index';
+} | {
+    kind: 'template';
+    slug: string;
+} | {
+    kind: 'guides-index';
+} | {
+    kind: 'guide';
+    slug: string;
+} | {
+    kind: 'preview';
+    slug: string;
+};
+export declare function parseHash(hash: string): Route;
+export declare function routeToHash(route: Route): string;
+export declare function isFullBleedRoute(route: Route): boolean;

package/dist-lib/showcase/templates/AuthForgot.template.d.ts

@@ -0,0 +1,3 @@
+import { TemplateDoc } from '../registry/types';
+declare const doc: TemplateDoc;
+export default doc;

package/dist-lib/showcase/templates/AuthMagic.template.d.ts

@@ -0,0 +1,3 @@
+import { TemplateDoc } from '../registry/types';
+declare const doc: TemplateDoc;
+export default doc;

package/dist-lib/showcase/templates/AuthSignIn.template.d.ts

@@ -0,0 +1,3 @@
+import { TemplateDoc } from '../registry/types';
+declare const doc: TemplateDoc;
+export default doc;

package/dist-lib/showcase/templates/AuthSignUp.template.d.ts

@@ -0,0 +1,3 @@
+import { TemplateDoc } from '../registry/types';
+declare const doc: TemplateDoc;
+export default doc;

package/dist-lib/showcase/templates/Dashboard.template.d.ts

@@ -0,0 +1,3 @@
+import { TemplateDoc } from '../registry/types';
+declare const doc: TemplateDoc;
+export default doc;

package/dist-lib/showcase/templates/DataTable.template.d.ts

@@ -0,0 +1,3 @@
+import { TemplateDoc } from '../registry/types';
+declare const doc: TemplateDoc;
+export default doc;

package/dist-lib/showcase/templates/FirstRunEmpty.template.d.ts

@@ -0,0 +1,3 @@
+import { TemplateDoc } from '../registry/types';
+declare const doc: TemplateDoc;
+export default doc;

package/dist-lib/showcase/templates/Onboarding.template.d.ts

@@ -0,0 +1,3 @@
+import { TemplateDoc } from '../registry/types';
+declare const doc: TemplateDoc;
+export default doc;

package/dist-lib/showcase/templates/Pricing.template.d.ts

@@ -0,0 +1,3 @@
+import { TemplateDoc } from '../registry/types';
+declare const doc: TemplateDoc;
+export default doc;

package/dist-lib/showcase/templates/RecordDetail.template.d.ts

@@ -0,0 +1,3 @@
+import { TemplateDoc } from '../registry/types';
+declare const doc: TemplateDoc;
+export default doc;

package/dist-lib/showcase/templates/Settings.template.d.ts

@@ -0,0 +1,3 @@
+import { TemplateDoc } from '../registry/types';
+declare const doc: TemplateDoc;
+export default doc;

package/dist-lib/showcase/widgets/CodeBlock.d.ts

@@ -0,0 +1,12 @@
+interface CodeBlockProps {
+    code: string;
+    /** Display language label (tsx, css, bash, …) shown in the top-right. */
+    language?: string;
+    className?: string;
+}
+/**
+ * Minimal pre/code block with a copy-to-clipboard button.
+ * No syntax highlighting — keeps the showcase bundle small.
+ */
+export declare function CodeBlock({ code, language, className }: CodeBlockProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/showcase/widgets/CodePreview.d.ts

@@ -0,0 +1,14 @@
+import { ReactNode } from 'react';
+interface CodePreviewProps {
+    preview: ReactNode;
+    code: string;
+    language?: string;
+    /** Tweak the preview surface — e.g. add min-height for overlays. */
+    surfaceClassName?: string;
+}
+/**
+ * shadcn-style "Preview / Code" tab widget. Tabs hold their own state per
+ * instance so a page can flip individual examples without affecting others.
+ */
+export declare function CodePreview({ preview, code, language, surfaceClassName, }: CodePreviewProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-lib/showcase/widgets/PropsTable.d.ts

@@ -0,0 +1,10 @@
+import { PropGroup } from '../registry/types';
+interface PropsTableProps {
+    groups: PropGroup[];
+}
+/**
+ * Renders one or more prop-reference tables. Types are shown as inline
+ * `code` so long unions wrap cleanly.
+ */
+export declare function PropsTable({ groups }: PropsTableProps): import("react/jsx-runtime").JSX.Element;
+export {};