@hanzo/ui 8.4.13 → 8.5.0

package/dist/types.cjs

@@ -0,0 +1,32 @@
+'use client';"use strict";
+// @hanzo/ui/types — the content vocabulary the block renderers read.
+//
+// These are the shapes a SITE authors: a grid, a link, an image, a video. They
+// carry no behaviour and import no component, so content can be written, typed
+// and tested without pulling a renderer in.
+//
+// Flat on purpose. The 5.x line spread these across ten files that each exported
+// one type as `default`, so a consumer wanting three of them wrote three imports
+// of a name the file did not state. One module, named exports, one import.
+//
+// The two that referenced Tailwind are the reason this could not simply be
+// copied: `Breakpoint` was `keyof typeof` a tailwind screens config (under a
+// blanket @ts-nocheck), and `LinkDef` reached `VariantProps<typeof
+// buttonVariants>` from class-variance-authority. Both now name what they
+// actually mean, and neither pulls an engine.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMON_GRID_4_COL = exports.COMMON_GRID_3_COL = exports.COMMON_GRID_2_COL = exports.COMMON_GRID_1_COL = exports.Breakpoints = void 0;
+exports.Breakpoints = ['xs', 'sm', 'md', 'lg', 'xl', '2xl'];
+const grid = (md, lg) => ({
+    at: {
+        xs: { columns: 1, gap: 2 },
+        md: { columns: md, gap: 3 },
+        lg: { columns: lg, gap: 6 },
+    },
+    mobile: { columns: 1, gap: 2 },
+});
+// One column on a phone in every case; the name says where it lands on a desk.
+exports.COMMON_GRID_1_COL = grid(1, 1);
+exports.COMMON_GRID_2_COL = grid(2, 2);
+exports.COMMON_GRID_3_COL = grid(3, 3);
+exports.COMMON_GRID_4_COL = grid(2, 4);

package/dist/types.d.ts

@@ -0,0 +1,136 @@
+import type { ReactNode } from 'react';
+import type { ButtonProps, ButtonSize, ButtonVariant } from './backends/gui/button.js';
+/**
+ * The responsive vocabulary, and the SAME one `tw()` maps class prefixes onto
+ * (`md:` → the `$md` gui media prop). A second list would be a second answer to
+ * "what is medium".
+ *
+ * `xs` is here and has no prefix in `tw()`: it is the base rung, which content
+ * authored on 5.x names explicitly in `GridDef.at` and `SpaceBlock.sizes`.
+ */
+export type Breakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+export declare const Breakpoints: Breakpoint[];
+export interface Dimensions {
+    w: number;
+    h: number;
+}
+export type TShirtSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/** A size per rung, `md` required — the one every consumer can fall back to. */
+export type TShirtDimensions = {
+    [k in Exclude<TShirtSize, 'md'>]?: Dimensions;
+} & {
+    md: Dimensions;
+};
+/** Columns alone, or columns with the gap between them. */
+export type GridColumnSpec = number | {
+    columns: number;
+    gap: number;
+};
+export interface GridDef {
+    /** Must be given in ASCENDING order. */
+    at: {
+        [k in Breakpoint]?: GridColumnSpec;
+    };
+    mobile?: GridColumnSpec;
+}
+export declare const COMMON_GRID_1_COL: GridDef;
+export declare const COMMON_GRID_2_COL: GridDef;
+export declare const COMMON_GRID_3_COL: GridDef;
+export declare const COMMON_GRID_4_COL: GridDef;
+/** @see https://nextjs.org/docs/app/api-reference/components/image */
+export interface ImageDef {
+    /** Image url. */
+    src: string;
+    /** Defaults to the short filename. */
+    alt?: string;
+    sizes?: string;
+    /**
+     * A colour class for an svg. Every `fill` in the file must be
+     * `currentColor` for it to have any effect.
+     */
+    svgFillClass?: string;
+    /**
+     * Rendered dimensions, unless a style prop overrides them — in which case
+     * give the file's own resolution so both the server and the browser can work
+     * out the aspect ratio before the bytes arrive.
+     */
+    dim: Dimensions;
+    rounded?: string;
+}
+export interface VideoDef {
+    /**
+     * Passed through to `<video>`. Valueless HTML attributes are booleans here,
+     * and React's camelCase spelling is the one that reaches the element
+     * (`playsinline` → `playsInline`):
+     *
+     *   videoProps: { autoPlay: true, loop: true, muted: true, playsInline: true }
+     */
+    videoProps?: Record<string, unknown>;
+    poster?: string;
+    sources?: string[];
+    dim: TShirtDimensions;
+    /** e.g. `{ vh: 60, mobile: { vw: 70 } }` */
+    sizing?: Record<string, unknown>;
+}
+export interface BulletItem {
+    text: string;
+    /** An icon is any node, so a string is a legal icon. */
+    icon?: ReactNode;
+}
+/**
+ * A link that renders with a button's clothes.
+ *
+ * `variant` and `size` were `VariantProps<typeof buttonVariants>` — a type
+ * class-variance-authority derives from a style table. Naming the two unions
+ * directly says the same thing, is readable at the call site, and drops a
+ * Tailwind-ecosystem dependency from a file that holds no styles.
+ */
+export interface LinkDef {
+    variant?: ButtonVariant | null;
+    size?: ButtonSize | null;
+    /** Ignored when the element is rendered directly WITH children. */
+    title?: string;
+    /** Ignored when the element is rendered directly WITH children. */
+    icon?: ReactNode;
+    /** Ignored when the element is rendered directly WITH children. */
+    iconAfter?: boolean;
+    href: string;
+    /**
+     * External links open in a new tab, internal ones in the same tab.
+     * `newTab` overrides both. ('external' means the url starts with `http`.)
+     */
+    newTab?: boolean;
+    /** Renders disabled: default cursor, and pointer events stop here. */
+    disabled?: boolean;
+    contents?: string;
+    childMenu?: LinkDef[];
+    groupName?: string;
+}
+export type SubmitServerAction = (data: unknown, enclosure?: unknown) => Promise<unknown>;
+export interface ButtonModalProps {
+    open: boolean;
+    onOpenChange: (b: boolean) => void;
+    buttonText: string;
+    buttonProps: ButtonProps;
+    title: string;
+    byline?: string;
+    action: SubmitServerAction;
+    actionEnclosure?: unknown;
+}
+export interface ButtonModalDef {
+    Comp: React.ComponentType<ButtonModalProps>;
+    title: string;
+    props?: Record<string, unknown>;
+    byline?: string;
+    action?: SubmitServerAction;
+    actionEnclosure?: unknown;
+}
+export interface ButtonDef {
+    text: string;
+    props: ButtonProps;
+    action: {
+        type: 'modal';
+        def: ButtonModalDef;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,30 @@
+'use client';// @hanzo/ui/types — the content vocabulary the block renderers read.
+//
+// These are the shapes a SITE authors: a grid, a link, an image, a video. They
+// carry no behaviour and import no component, so content can be written, typed
+// and tested without pulling a renderer in.
+//
+// Flat on purpose. The 5.x line spread these across ten files that each exported
+// one type as `default`, so a consumer wanting three of them wrote three imports
+// of a name the file did not state. One module, named exports, one import.
+//
+// The two that referenced Tailwind are the reason this could not simply be
+// copied: `Breakpoint` was `keyof typeof` a tailwind screens config (under a
+// blanket @ts-nocheck), and `LinkDef` reached `VariantProps<typeof
+// buttonVariants>` from class-variance-authority. Both now name what they
+// actually mean, and neither pulls an engine.
+export const Breakpoints = ['xs', 'sm', 'md', 'lg', 'xl', '2xl'];
+const grid = (md, lg) => ({
+    at: {
+        xs: { columns: 1, gap: 2 },
+        md: { columns: md, gap: 3 },
+        lg: { columns: lg, gap: 6 },
+    },
+    mobile: { columns: 1, gap: 2 },
+});
+// One column on a phone in every case; the name says where it lands on a desk.
+export const COMMON_GRID_1_COL = grid(1, 1);
+export const COMMON_GRID_2_COL = grid(2, 2);
+export const COMMON_GRID_3_COL = grid(3, 3);
+export const COMMON_GRID_4_COL = grid(2, 4);
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,4CAA4C;AAC5C,EAAE;AACF,iFAAiF;AACjF,iFAAiF;AACjF,2EAA2E;AAC3E,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,mEAAmE;AACnE,0EAA0E;AAC1E,8CAA8C;AAiB9C,MAAM,CAAC,MAAM,WAAW,GAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;AA2B9E,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,EAAU,EAAW,EAAE,CAAC,CAAC;IACjD,EAAE,EAAE;QACF,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;QAC1B,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE;QAC3B,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE;KAC5B;IACD,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;CAC/B,CAAC,CAAA;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzo/ui",
-  "version": "8.4.13",
+  "version": "8.5.0",
   "type": "module",
   "description": "Hanzo UI — the one canonical Hanzo component library, on @hanzo/gui + @hanzo/design. ONE substrate: every component renders through @hanzo/gui primitives, so the same import works on web, native (expo) and desktop (Tauri). Self-contained (theme.css), presentational, host-agnostic, clean-room.",
   "exports": {
@@ -11,6 +11,12 @@
       "require": "./dist/index.cjs",
       "default": "./dist/index.js"
     },
+    "./blocks": {
+      "types": "./dist/blocks/index.d.ts",
+      "import": "./dist/blocks/index.js",
+      "require": "./dist/blocks/index.cjs",
+      "default": "./dist/blocks/index.js"
+    },
     "./gallery": {
       "types": "./dist/gallery.d.ts",
       "import": "./dist/gallery.js",
@@ -194,6 +200,12 @@
       "types": "./dist/grid.d.ts",
       "import": "./dist/grid.js",
       "require": "./dist/grid.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "require": "./dist/types.cjs",
+      "default": "./dist/types.js"
     }
   },
   "main": "./dist/index.cjs",