@nodeblocks/frontend-breadcrumb-block 0.0.2 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,25 @@
1
- import React from 'react';
2
- import { BreadcrumbProps } from './types';
3
- import './breadcrumb.css';
4
- declare const Breadcrumb: React.FC<BreadcrumbProps>;
1
+ import { ComponentProps, ReactNode } from "react";
2
+ import "./breadcrumb.css";
3
+ import { BlocksOverride } from "./lib";
4
+ declare const Breadcrumb: {
5
+ <CustomBlocks extends Record<string, ReactNode>>({ className, children, }: Omit<ComponentProps<"nav">, "children"> & {
6
+ children?: BlocksOverride<typeof defaultBlocks, CustomBlocks>;
7
+ }): import("react/jsx-runtime").JSX.Element;
8
+ BreadcrumbChevron: () => import("react/jsx-runtime").JSX.Element;
9
+ BreadcrumbItem: ({ url, children, }: Omit<ComponentProps<"a">, "children"> & {
10
+ url: string;
11
+ children: ReactNode;
12
+ }) => import("react/jsx-runtime").JSX.Element;
13
+ };
14
+ declare const defaultBlocks: {
15
+ breadcrumbChevron: import("react").ReactElement<unknown, () => import("react/jsx-runtime").JSX.Element>;
16
+ breadcrumbItem: import("react").ReactElement<Omit<import("react").DetailedHTMLProps<import("react").AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "children"> & {
17
+ url: string;
18
+ children: ReactNode;
19
+ }, ({ url, children, }: Omit<ComponentProps<"a">, "children"> & {
20
+ url: string;
21
+ children: ReactNode;
22
+ }) => import("react/jsx-runtime").JSX.Element>;
23
+ };
5
24
  export default Breadcrumb;
6
25
  //# sourceMappingURL=Breadcrumb.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"Breadcrumb.d.ts","sourceRoot":"","sources":["../src/Breadcrumb.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,kBAAkB,CAAC;AAI1B,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAczC,CAAC;AAEF,eAAe,UAAU,CAAC"}
1
+ {"version":3,"file":"Breadcrumb.d.ts","sourceRoot":"","sources":["../src/Breadcrumb.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EACL,cAAc,EAIf,MAAM,OAAO,CAAC;AAEf,QAAA,MAAM,UAAU;KAAI,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,4BAG/D,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,GAAG;QAC3C,QAAQ,CAAC,EAAE,cAAc,CAAC,OAAO,aAAa,EAAE,YAAY,CAAC,CAAC;KAC/D;;;;;;CA+BA,CAAC;AAKF,QAAA,MAAM,aAAa;;;;;;;;;CAGjB,CAAC;AAEH,eAAe,UAAU,CAAC"}
package/dist/blocks.d.ts CHANGED
@@ -1,7 +1,7 @@
1
- import React from 'react';
2
- import { BreadcrumbItemProps } from './types';
3
- export declare const defaultBlocks: {
4
- BreadcrumbItem: React.FC<BreadcrumbItemProps>;
5
- BreadcrumbChevron: React.FC<{}>;
6
- };
1
+ import { ComponentProps, ReactNode } from "react";
2
+ export declare const BreadcrumbItem: ({ url, children, }: Omit<ComponentProps<"a">, "children"> & {
3
+ url: string;
4
+ children: ReactNode;
5
+ }) => import("react/jsx-runtime").JSX.Element;
6
+ export declare const BreadcrumbChevron: () => import("react/jsx-runtime").JSX.Element;
7
7
  //# sourceMappingURL=blocks.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../src/blocks.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAc9C,eAAO,MAAM,aAAa;;;CAGzB,CAAC"}
1
+ {"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../src/blocks.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD,eAAO,MAAM,cAAc,GAAI,oBAG5B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,GAAG;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,SAAS,CAAC;CACrB,4CAIA,CAAC;AAEF,eAAO,MAAM,iBAAiB,+CAe7B,CAAC"}
package/dist/index.cjs.js CHANGED
@@ -1,35 +1,10 @@
1
1
  'use strict';
2
2
 
3
3
  var jsxRuntime = require('react/jsx-runtime');
4
+ var react = require('react');
4
5
 
5
- const DefaultBreadcrumbItem = ({ label, url }) => (jsxRuntime.jsx("a", { href: url, className: "nbb-breadcrumb-item", children: label }));
6
- const DefaultBreadcrumbChevron = () => jsxRuntime.jsx("span", { className: "nbb-breadcrumb-chevron", children: jsxRuntime.jsx("svg", { width: "8", height: "12", viewBox: "0 0 8 12", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: jsxRuntime.jsx("path", { d: "M0.294922 10.59L4.87492 6L0.294922 1.41L1.70492 0L7.70492 6L1.70492 12L0.294922 10.59Z", fill: "white" }) }) });
7
- const defaultBlocks = {
8
- BreadcrumbItem: DefaultBreadcrumbItem,
9
- BreadcrumbChevron: DefaultBreadcrumbChevron,
10
- };
11
-
12
- function setBlocks(defaultBlocks, children, settings) {
13
- const { blocks: customBlocks = {}, settings: customSettings = {} } = children ? children({ defaultBlocks, settings }) : { blocks: {}, settings: {} };
14
- return {
15
- blocks: Object.fromEntries(Object.entries(defaultBlocks).map(([key, defaultComponent]) => [
16
- key,
17
- customBlocks[key] || defaultComponent,
18
- ])),
19
- settings: {
20
- ...settings,
21
- ...customSettings,
22
- }
23
- };
24
- }
25
- /**
26
- * Utility function to join class names together, ignoring undefined or nil values.
27
- * @param classes - The class names to join.
28
- * @returns The joined class names.
29
- */
30
- function classNames(...classes) {
31
- return classes.flat().filter(Boolean).join(' ');
32
- }
6
+ const BreadcrumbItem = ({ url, children, }) => (jsxRuntime.jsx("a", { href: url, className: "nbb-breadcrumb-item", children: children }));
7
+ const BreadcrumbChevron = () => (jsxRuntime.jsx("span", { className: "nbb-breadcrumb-chevron", children: jsxRuntime.jsx("svg", { width: "8", height: "12", viewBox: "0 0 8 12", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: jsxRuntime.jsx("path", { d: "M0.294922 10.59L4.87492 6L0.294922 1.41L1.70492 0L7.70492 6L1.70492 12L0.294922 10.59Z", fill: "white" }) }) }));
33
8
 
34
9
  function styleInject(css, ref) {
35
10
  if ( ref === void 0 ) ref = {};
@@ -58,14 +33,87 @@ function styleInject(css, ref) {
58
33
  }
59
34
  }
60
35
 
61
- var css_248z = ".nbb-breadcrumb {\n --color-object-accent-primary: #006EAD;\n --color-text-on-primary: #fff;\n\n display: flex;\n align-items: center;\n padding: 8px 16px;\n background-color: var(--color-object-accent-primary);\n color: var(--color-text-on-primary);\n border-bottom: 1px solid rgba(255, 255, 255, 0.2);\n}\n\n.nbb-breadcrumb-segment {\n display: flex;\n align-items: center;\n}\n\n.nbb-breadcrumb-item {\n color: var(--color-text-on-primary);\n text-decoration: none;\n padding: 0 4px;\n font-size: 12px;\n}\n\n.nbb-breadcrumb-item:hover {\n text-decoration: underline;\n color: var(--color-text-on-primary);\n}\n\n.nbb-breadcrumb-chevron {\n margin: 0 4px;\n min-width: 24px;\n color: var(--color-text-on-primary);\n}\n";
36
+ var css_248z = ".nbb-breadcrumb {\n --color-object-accent-primary: #006EAD;\n --color-text-on-primary: #fff;\n\n display: flex;\n align-items: center;\n padding: 8px 16px;\n background-color: var(--color-object-accent-primary);\n color: var(--color-text-on-primary);\n border-bottom: 1px solid rgba(255, 255, 255, 0.2);\n}\n\n.nbb-breadcrumb .nbb-breadcrumb-segment {\n display: flex;\n align-items: center;\n}\n\n.nbb-breadcrumb .nbb-breadcrumb-item {\n color: var(--color-text-on-primary);\n text-decoration: none;\n padding: 0 4px;\n font-size: 12px;\n}\n\n.nbb-breadcrumb .nbb-breadcrumb-item:hover {\n text-decoration: underline;\n color: var(--color-text-on-primary);\n}\n\n.nbb-breadcrumb .nbb-breadcrumb-chevron {\n margin: 0 4px;\n min-width: 24px;\n color: var(--color-text-on-primary);\n}\n";
62
37
  styleInject(css_248z);
63
38
 
64
- const Breadcrumb = ({ items, className, children }) => {
65
- const { blocks } = setBlocks(defaultBlocks, children);
66
- const { BreadcrumbItem, BreadcrumbChevron } = blocks;
67
- return (jsxRuntime.jsx("nav", { className: classNames('nbb-breadcrumb', className), children: items.map((item, index) => (jsxRuntime.jsxs("span", { className: "nbb-breadcrumb-segment", children: [index > 0 && jsxRuntime.jsx(BreadcrumbChevron, {}), jsxRuntime.jsx(BreadcrumbItem, { label: item.label, url: item.url })] }, `${index}-breadcrumb`))) }));
39
+ /**
40
+ * Creates a strongly typed `defaultBlocks` object, allowing for types to propagate into block override objects.
41
+ *
42
+ * @param components - A map of default block keys to component functions.
43
+ *
44
+ * @example
45
+ * const defaultBlocks = createDefaultBlocks({
46
+ * title: Title,
47
+ * description: Description,
48
+ * form: Form,
49
+ * });
50
+ */
51
+ function createDefaultBlocks(components) {
52
+ return Object.fromEntries(Object.entries(components).map(([key, Component]) => [
53
+ key,
54
+ react.createElement(Component, { key }),
55
+ ]));
56
+ }
57
+ /**
58
+ * A component for rendering {@link BlocksOverride|`BlocksOverride`} results.
59
+ * Exposes the evaluated `blocks` and `blockOrder` as arguments to the `children` function.
60
+ *
61
+ * @param props
62
+ * @param props.blocksOverride - The {@link BlocksOverride|`BlocksOverride`} (i.e. `children` of outer component).
63
+ * @param props.defaultBlocks - The default blocks of outer component.
64
+ * @param props.children - A function returning the JSX to render.
65
+ *
66
+ * @example
67
+ * <BlocksOverrideComponent
68
+ * defaultBlocks={defaultFormBlocks}
69
+ * blocksOverride={children}
70
+ * >
71
+ * {({ blocks, blockOrder }) =>
72
+ * blockOrder.map((key) => (
73
+ * <Fragment key={String(key)}>{blocks[key]}</Fragment>
74
+ * ))
75
+ * }
76
+ * </BlocksOverrideComponent>
77
+ */
78
+ function BlocksOverrideComponent({ blocksOverride, defaultBlocks, defaultBlockOrder, children, }) {
79
+ if (blocksOverride === undefined) {
80
+ return children({
81
+ // TODO: Remove this assertion
82
+ blocks: defaultBlocks,
83
+ blockOrder: defaultBlockOrder,
84
+ });
85
+ }
86
+ if (typeof blocksOverride === "function") {
87
+ const { blocks, blockOrder } = blocksOverride({
88
+ defaultBlocks,
89
+ defaultBlockOrder,
90
+ });
91
+ return children({ blocks, blockOrder });
92
+ }
93
+ return blocksOverride;
94
+ }
95
+ /**
96
+ * Utility function to join class names together, ignoring undefined or nil values.
97
+ * @param classes - The class names to join.
98
+ * @returns The joined class names.
99
+ */
100
+ function classNames(...classes) {
101
+ return classes.flat().filter(Boolean).join(" ");
102
+ }
103
+
104
+ const Breadcrumb = ({ className, children, }) => {
105
+ return (jsxRuntime.jsx("nav", { className: classNames("nbb-breadcrumb", className), children: jsxRuntime.jsx(BlocksOverrideComponent, { defaultBlocks: defaultBlocks, defaultBlockOrder: Object.keys(defaultBlocks), blocksOverride: children, children: ({ blocks: { breadcrumbChevron, breadcrumbItem, ...blocks }, blockOrder, }) => blockOrder
106
+ .filter((key) => key in blocks)
107
+ .map((key, index) => {
108
+ return (jsxRuntime.jsxs("span", { className: "nbb-breadcrumb-segment", children: [index > 0 && breadcrumbChevron, blocks[key]] }, `${index}-breadcrumb`));
109
+ }) }) }));
68
110
  };
111
+ Breadcrumb.BreadcrumbChevron = BreadcrumbChevron;
112
+ Breadcrumb.BreadcrumbItem = BreadcrumbItem;
113
+ const defaultBlocks = createDefaultBlocks({
114
+ breadcrumbChevron: BreadcrumbChevron,
115
+ breadcrumbItem: BreadcrumbItem,
116
+ });
69
117
 
70
118
  exports.Breadcrumbs = Breadcrumb;
71
119
  //# sourceMappingURL=index.cjs.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs.js","sources":["../src/blocks.tsx","../src/lib.ts","../node_modules/style-inject/dist/style-inject.es.js","../src/Breadcrumb.tsx"],"sourcesContent":["import React from 'react';\nimport { BreadcrumbItemProps } from './types';\n\nconst DefaultBreadcrumbItem: React.FC<BreadcrumbItemProps> = ({ label, url }) => (\n <a href={url} className=\"nbb-breadcrumb-item\">\n {label}\n </a>\n);\n\nconst DefaultBreadcrumbChevron: React.FC = () => <span className=\"nbb-breadcrumb-chevron\">\n <svg width=\"8\" height=\"12\" viewBox=\"0 0 8 12\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\">\n <path d=\"M0.294922 10.59L4.87492 6L0.294922 1.41L1.70492 0L7.70492 6L1.70492 12L0.294922 10.59Z\" fill=\"white\" />\n </svg>\n</span>;\n\nexport const defaultBlocks = {\n BreadcrumbItem: DefaultBreadcrumbItem,\n BreadcrumbChevron: DefaultBreadcrumbChevron,\n};","import { DefaultBlocks, DefaultSettings } from './types';\n\n/**\n * Sets the blocks and settings by merging the default blocks with custom blocks and settings.\n *\n * @param defaultBlocks - The default blocks to be used.\n * @param children - An optional function that takes the default blocks and settings and returns custom blocks and settings.\n * @param settings - Optional default settings to be used.\n * @returns An object containing the merged blocks and settings.\n */\n\ntype ChildrenProps = {\n defaultBlocks: DefaultBlocks,\n settings?: DefaultSettings\n}\nexport function setBlocks(\n defaultBlocks: DefaultBlocks,\n children?: (props: ChildrenProps) => {\n blocks: { [x: string]: any };\n settings?: DefaultSettings;\n },\n settings?: DefaultSettings,\n) {\n const { blocks: customBlocks = {}, settings: customSettings = {} } =\n children ? children({ defaultBlocks, settings }) : { blocks: {}, settings: {} };\n\n return {\n blocks: Object.fromEntries(\n Object.entries(defaultBlocks).map(([key, defaultComponent]) => [\n key,\n customBlocks[key] || defaultComponent,\n ])\n ),\n settings: {\n ...settings,\n ...customSettings,\n }\n };\n}\n\ntype ClassName = string | ClassName[] | undefined | null;\n\n/**\n * Utility function to join class names together, ignoring undefined or nil values.\n * @param classes - The class names to join.\n * @returns The joined class names.\n */\nexport function classNames(...classes: ClassName[]): string {\n return classes.flat().filter(Boolean).join(' ');\n}\n","function styleInject(css, ref) {\n if ( ref === void 0 ) ref = {};\n var insertAt = ref.insertAt;\n\n if (!css || typeof document === 'undefined') { return; }\n\n var head = document.head || document.getElementsByTagName('head')[0];\n var style = document.createElement('style');\n style.type = 'text/css';\n\n if (insertAt === 'top') {\n if (head.firstChild) {\n head.insertBefore(style, head.firstChild);\n } else {\n head.appendChild(style);\n }\n } else {\n head.appendChild(style);\n }\n\n if (style.styleSheet) {\n style.styleSheet.cssText = css;\n } else {\n style.appendChild(document.createTextNode(css));\n }\n}\n\nexport default styleInject;\n","import React from 'react';\nimport { defaultBlocks } from './blocks';\nimport { setBlocks, classNames } from './lib';\nimport { BreadcrumbProps } from './types';\nimport './breadcrumb.css';\n\n\n\nconst Breadcrumb: React.FC<BreadcrumbProps> = ({ items, className, children }) => {\n const { blocks } = setBlocks(defaultBlocks, children);\n const { BreadcrumbItem, BreadcrumbChevron } = blocks;\n\n return (\n <nav className={classNames('nbb-breadcrumb', className)}>\n {items.map((item, index) => (\n <span key={`${index}-breadcrumb`} className=\"nbb-breadcrumb-segment\">\n {index > 0 && <BreadcrumbChevron />}\n <BreadcrumbItem label={item.label} url={item.url} />\n </span>\n ))}\n </nav>\n );\n};\n\nexport default Breadcrumb;\n"],"names":["_jsx","_jsxs"],"mappings":"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","x_google_ignoreList":[2]}
1
+ {"version":3,"file":"index.cjs.js","sources":["../src/blocks.tsx","../node_modules/style-inject/dist/style-inject.es.js","../src/lib.ts","../src/Breadcrumb.tsx"],"sourcesContent":["import { ComponentProps, ReactNode } from \"react\";\n\nexport const BreadcrumbItem = ({\n url,\n children,\n}: Omit<ComponentProps<\"a\">, \"children\"> & {\n url: string;\n children: ReactNode;\n}) => (\n <a href={url} className=\"nbb-breadcrumb-item\">\n {children}\n </a>\n);\n\nexport const BreadcrumbChevron = () => (\n <span className=\"nbb-breadcrumb-chevron\">\n <svg\n width=\"8\"\n height=\"12\"\n viewBox=\"0 0 8 12\"\n fill=\"none\"\n xmlns=\"http://www.w3.org/2000/svg\"\n >\n <path\n d=\"M0.294922 10.59L4.87492 6L0.294922 1.41L1.70492 0L7.70492 6L1.70492 12L0.294922 10.59Z\"\n fill=\"white\"\n />\n </svg>\n </span>\n);\n","function styleInject(css, ref) {\n if ( ref === void 0 ) ref = {};\n var insertAt = ref.insertAt;\n\n if (!css || typeof document === 'undefined') { return; }\n\n var head = document.head || document.getElementsByTagName('head')[0];\n var style = document.createElement('style');\n style.type = 'text/css';\n\n if (insertAt === 'top') {\n if (head.firstChild) {\n head.insertBefore(style, head.firstChild);\n } else {\n head.appendChild(style);\n }\n } else {\n head.appendChild(style);\n }\n\n if (style.styleSheet) {\n style.styleSheet.cssText = css;\n } else {\n style.appendChild(document.createTextNode(css));\n }\n}\n\nexport default styleInject;\n","import {\n ComponentProps,\n createElement,\n FunctionComponent,\n ReactElement,\n ReactNode,\n} from \"react\";\n\n/**\n * The function to be passed into a block component as `children` to selectively override default blocks, or just a `ReactNode`.\n *\n * @example\n * <Block>\n * {({header, ...defaultBlocks}) => ({\n * blocks: {\n * ...defaultBlocks,\n * header: {\n * ...header,\n * props: {\n * ...header.props,\n * label: \"Custom Label\"\n * }\n * },\n * subheader: <CustomComponent />\n * },\n * blockOrder: [\"header\", \"subheader\", \"body\", \"footer\"]\n * })}\n * </Block>\n */\nexport type BlocksOverride<DefaultBlocks, CustomBlocks> =\n | (({\n defaultBlocks,\n defaultBlockOrder,\n }: {\n defaultBlocks: DefaultBlocks;\n defaultBlockOrder: readonly (keyof DefaultBlocks)[];\n }) => {\n blocks: Partial<DefaultBlocks> & CustomBlocks;\n // NOTE: This specific combination allows proper autocomplete.\n blockOrder:\n | readonly (keyof DefaultBlocks)[]\n | readonly (keyof CustomBlocks)[];\n })\n | ReactNode;\n\n/**\n * Creates a strongly typed `defaultBlocks` object, allowing for types to propagate into block override objects.\n *\n * @param components - A map of default block keys to component functions.\n *\n * @example\n * const defaultBlocks = createDefaultBlocks({\n * title: Title,\n * description: Description,\n * form: Form,\n * });\n */\nexport function createDefaultBlocks<\n T extends Record<string, FunctionComponent<any>>,\n>(\n components: T\n): {\n [K in keyof T]: ReactElement<ComponentProps<T[K]>, T[K]>;\n} {\n return Object.fromEntries(\n Object.entries(components).map(([key, Component]) => [\n key,\n createElement(Component, { key }),\n ])\n ) as {\n [K in keyof T]: ReactElement<ComponentProps<T[K]>, T[K]>;\n };\n}\n\n/**\n * A component for rendering {@link BlocksOverride|`BlocksOverride`} results.\n * Exposes the evaluated `blocks` and `blockOrder` as arguments to the `children` function.\n *\n * @param props\n * @param props.blocksOverride - The {@link BlocksOverride|`BlocksOverride`} (i.e. `children` of outer component).\n * @param props.defaultBlocks - The default blocks of outer component.\n * @param props.children - A function returning the JSX to render.\n *\n * @example\n * <BlocksOverrideComponent\n * defaultBlocks={defaultFormBlocks}\n * blocksOverride={children}\n * >\n * {({ blocks, blockOrder }) =>\n * blockOrder.map((key) => (\n * <Fragment key={String(key)}>{blocks[key]}</Fragment>\n * ))\n * }\n * </BlocksOverrideComponent>\n */\nexport function BlocksOverrideComponent<\n DefaultBlocks extends Record<string, ReactNode>,\n CustomBlocks extends Record<string, ReactNode>,\n>({\n blocksOverride,\n defaultBlocks,\n defaultBlockOrder,\n children,\n}: {\n blocksOverride: BlocksOverride<DefaultBlocks, CustomBlocks>;\n defaultBlocks: DefaultBlocks;\n defaultBlockOrder: (keyof DefaultBlocks)[];\n children: ({\n blocks,\n blockOrder,\n }: {\n // TODO: Possibly find an alternative to Partial<CustomBlocks>\n blocks: Partial<DefaultBlocks> & Partial<CustomBlocks>;\n blockOrder: readonly (keyof DefaultBlocks | keyof CustomBlocks)[];\n }) => ReactNode;\n}) {\n if (blocksOverride === undefined) {\n return children({\n // TODO: Remove this assertion\n blocks: defaultBlocks as DefaultBlocks & Partial<CustomBlocks>,\n blockOrder: defaultBlockOrder,\n });\n }\n\n if (typeof blocksOverride === \"function\") {\n const { blocks, blockOrder } = blocksOverride({\n defaultBlocks,\n defaultBlockOrder,\n });\n\n return children({ blocks, blockOrder });\n }\n\n return blocksOverride;\n}\n\nexport function deepMerge<\n A extends Record<string, any>,\n B extends Record<string, any>,\n>(obj1: A, obj2: B) {\n const result: Record<string, any> = { ...obj1 };\n\n for (const key in obj2) {\n if (obj2.hasOwnProperty(key)) {\n const val1 = result[key];\n const val2 = obj2[key];\n\n if (Array.isArray(val1) || Array.isArray(val2)) {\n // If either is an array, replace entirely with obj2's value\n result[key] = val2;\n } else if (\n typeof val1 === \"object\" &&\n val1 !== null &&\n typeof val2 === \"object\" &&\n val2 !== null\n ) {\n result[key] = deepMerge(val1, val2);\n } else {\n result[key] = val2;\n }\n }\n }\n\n return result as A & B;\n}\n\ntype ClassName = string | ClassName[] | undefined | null;\n\n/**\n * Utility function to join class names together, ignoring undefined or nil values.\n * @param classes - The class names to join.\n * @returns The joined class names.\n */\nexport function classNames(...classes: ClassName[]): string {\n return classes.flat().filter(Boolean).join(\" \");\n}\n","import { ComponentProps, ReactNode } from \"react\";\nimport { BreadcrumbChevron, BreadcrumbItem } from \"./blocks\";\nimport \"./breadcrumb.css\";\nimport {\n BlocksOverride,\n BlocksOverrideComponent,\n classNames,\n createDefaultBlocks,\n} from \"./lib\";\n\nconst Breadcrumb = <CustomBlocks extends Record<string, ReactNode>>({\n className,\n children,\n}: Omit<ComponentProps<\"nav\">, \"children\"> & {\n children?: BlocksOverride<typeof defaultBlocks, CustomBlocks>;\n}) => {\n return (\n <nav className={classNames(\"nbb-breadcrumb\", className)}>\n <BlocksOverrideComponent\n defaultBlocks={defaultBlocks}\n defaultBlockOrder={\n Object.keys(defaultBlocks) as (keyof typeof defaultBlocks)[]\n }\n blocksOverride={children}\n >\n {({\n blocks: { breadcrumbChevron, breadcrumbItem, ...blocks },\n blockOrder,\n }) =>\n blockOrder\n .filter((key) => key in blocks)\n .map<ReactNode>((key, index) => {\n return (\n <span\n key={`${index}-breadcrumb`}\n className=\"nbb-breadcrumb-segment\"\n >\n {index > 0 && breadcrumbChevron}\n {blocks[key]}\n </span>\n );\n })\n }\n </BlocksOverrideComponent>\n </nav>\n );\n};\n\nBreadcrumb.BreadcrumbChevron = BreadcrumbChevron;\nBreadcrumb.BreadcrumbItem = BreadcrumbItem;\n\nconst defaultBlocks = createDefaultBlocks({\n breadcrumbChevron: BreadcrumbChevron,\n breadcrumbItem: BreadcrumbItem,\n});\n\nexport default Breadcrumb;\n"],"names":["_jsx","createElement","_jsxs"],"mappings":"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","x_google_ignoreList":[1]}
package/dist/index.esm.js CHANGED
@@ -1,33 +1,8 @@
1
1
  import { jsx, jsxs } from 'react/jsx-runtime';
2
+ import { createElement } from 'react';
2
3
 
3
- const DefaultBreadcrumbItem = ({ label, url }) => (jsx("a", { href: url, className: "nbb-breadcrumb-item", children: label }));
4
- const DefaultBreadcrumbChevron = () => jsx("span", { className: "nbb-breadcrumb-chevron", children: jsx("svg", { width: "8", height: "12", viewBox: "0 0 8 12", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: jsx("path", { d: "M0.294922 10.59L4.87492 6L0.294922 1.41L1.70492 0L7.70492 6L1.70492 12L0.294922 10.59Z", fill: "white" }) }) });
5
- const defaultBlocks = {
6
- BreadcrumbItem: DefaultBreadcrumbItem,
7
- BreadcrumbChevron: DefaultBreadcrumbChevron,
8
- };
9
-
10
- function setBlocks(defaultBlocks, children, settings) {
11
- const { blocks: customBlocks = {}, settings: customSettings = {} } = children ? children({ defaultBlocks, settings }) : { blocks: {}, settings: {} };
12
- return {
13
- blocks: Object.fromEntries(Object.entries(defaultBlocks).map(([key, defaultComponent]) => [
14
- key,
15
- customBlocks[key] || defaultComponent,
16
- ])),
17
- settings: {
18
- ...settings,
19
- ...customSettings,
20
- }
21
- };
22
- }
23
- /**
24
- * Utility function to join class names together, ignoring undefined or nil values.
25
- * @param classes - The class names to join.
26
- * @returns The joined class names.
27
- */
28
- function classNames(...classes) {
29
- return classes.flat().filter(Boolean).join(' ');
30
- }
4
+ const BreadcrumbItem = ({ url, children, }) => (jsx("a", { href: url, className: "nbb-breadcrumb-item", children: children }));
5
+ const BreadcrumbChevron = () => (jsx("span", { className: "nbb-breadcrumb-chevron", children: jsx("svg", { width: "8", height: "12", viewBox: "0 0 8 12", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: jsx("path", { d: "M0.294922 10.59L4.87492 6L0.294922 1.41L1.70492 0L7.70492 6L1.70492 12L0.294922 10.59Z", fill: "white" }) }) }));
31
6
 
32
7
  function styleInject(css, ref) {
33
8
  if ( ref === void 0 ) ref = {};
@@ -56,14 +31,87 @@ function styleInject(css, ref) {
56
31
  }
57
32
  }
58
33
 
59
- var css_248z = ".nbb-breadcrumb {\n --color-object-accent-primary: #006EAD;\n --color-text-on-primary: #fff;\n\n display: flex;\n align-items: center;\n padding: 8px 16px;\n background-color: var(--color-object-accent-primary);\n color: var(--color-text-on-primary);\n border-bottom: 1px solid rgba(255, 255, 255, 0.2);\n}\n\n.nbb-breadcrumb-segment {\n display: flex;\n align-items: center;\n}\n\n.nbb-breadcrumb-item {\n color: var(--color-text-on-primary);\n text-decoration: none;\n padding: 0 4px;\n font-size: 12px;\n}\n\n.nbb-breadcrumb-item:hover {\n text-decoration: underline;\n color: var(--color-text-on-primary);\n}\n\n.nbb-breadcrumb-chevron {\n margin: 0 4px;\n min-width: 24px;\n color: var(--color-text-on-primary);\n}\n";
34
+ var css_248z = ".nbb-breadcrumb {\n --color-object-accent-primary: #006EAD;\n --color-text-on-primary: #fff;\n\n display: flex;\n align-items: center;\n padding: 8px 16px;\n background-color: var(--color-object-accent-primary);\n color: var(--color-text-on-primary);\n border-bottom: 1px solid rgba(255, 255, 255, 0.2);\n}\n\n.nbb-breadcrumb .nbb-breadcrumb-segment {\n display: flex;\n align-items: center;\n}\n\n.nbb-breadcrumb .nbb-breadcrumb-item {\n color: var(--color-text-on-primary);\n text-decoration: none;\n padding: 0 4px;\n font-size: 12px;\n}\n\n.nbb-breadcrumb .nbb-breadcrumb-item:hover {\n text-decoration: underline;\n color: var(--color-text-on-primary);\n}\n\n.nbb-breadcrumb .nbb-breadcrumb-chevron {\n margin: 0 4px;\n min-width: 24px;\n color: var(--color-text-on-primary);\n}\n";
60
35
  styleInject(css_248z);
61
36
 
62
- const Breadcrumb = ({ items, className, children }) => {
63
- const { blocks } = setBlocks(defaultBlocks, children);
64
- const { BreadcrumbItem, BreadcrumbChevron } = blocks;
65
- return (jsx("nav", { className: classNames('nbb-breadcrumb', className), children: items.map((item, index) => (jsxs("span", { className: "nbb-breadcrumb-segment", children: [index > 0 && jsx(BreadcrumbChevron, {}), jsx(BreadcrumbItem, { label: item.label, url: item.url })] }, `${index}-breadcrumb`))) }));
37
+ /**
38
+ * Creates a strongly typed `defaultBlocks` object, allowing for types to propagate into block override objects.
39
+ *
40
+ * @param components - A map of default block keys to component functions.
41
+ *
42
+ * @example
43
+ * const defaultBlocks = createDefaultBlocks({
44
+ * title: Title,
45
+ * description: Description,
46
+ * form: Form,
47
+ * });
48
+ */
49
+ function createDefaultBlocks(components) {
50
+ return Object.fromEntries(Object.entries(components).map(([key, Component]) => [
51
+ key,
52
+ createElement(Component, { key }),
53
+ ]));
54
+ }
55
+ /**
56
+ * A component for rendering {@link BlocksOverride|`BlocksOverride`} results.
57
+ * Exposes the evaluated `blocks` and `blockOrder` as arguments to the `children` function.
58
+ *
59
+ * @param props
60
+ * @param props.blocksOverride - The {@link BlocksOverride|`BlocksOverride`} (i.e. `children` of outer component).
61
+ * @param props.defaultBlocks - The default blocks of outer component.
62
+ * @param props.children - A function returning the JSX to render.
63
+ *
64
+ * @example
65
+ * <BlocksOverrideComponent
66
+ * defaultBlocks={defaultFormBlocks}
67
+ * blocksOverride={children}
68
+ * >
69
+ * {({ blocks, blockOrder }) =>
70
+ * blockOrder.map((key) => (
71
+ * <Fragment key={String(key)}>{blocks[key]}</Fragment>
72
+ * ))
73
+ * }
74
+ * </BlocksOverrideComponent>
75
+ */
76
+ function BlocksOverrideComponent({ blocksOverride, defaultBlocks, defaultBlockOrder, children, }) {
77
+ if (blocksOverride === undefined) {
78
+ return children({
79
+ // TODO: Remove this assertion
80
+ blocks: defaultBlocks,
81
+ blockOrder: defaultBlockOrder,
82
+ });
83
+ }
84
+ if (typeof blocksOverride === "function") {
85
+ const { blocks, blockOrder } = blocksOverride({
86
+ defaultBlocks,
87
+ defaultBlockOrder,
88
+ });
89
+ return children({ blocks, blockOrder });
90
+ }
91
+ return blocksOverride;
92
+ }
93
+ /**
94
+ * Utility function to join class names together, ignoring undefined or nil values.
95
+ * @param classes - The class names to join.
96
+ * @returns The joined class names.
97
+ */
98
+ function classNames(...classes) {
99
+ return classes.flat().filter(Boolean).join(" ");
100
+ }
101
+
102
+ const Breadcrumb = ({ className, children, }) => {
103
+ return (jsx("nav", { className: classNames("nbb-breadcrumb", className), children: jsx(BlocksOverrideComponent, { defaultBlocks: defaultBlocks, defaultBlockOrder: Object.keys(defaultBlocks), blocksOverride: children, children: ({ blocks: { breadcrumbChevron, breadcrumbItem, ...blocks }, blockOrder, }) => blockOrder
104
+ .filter((key) => key in blocks)
105
+ .map((key, index) => {
106
+ return (jsxs("span", { className: "nbb-breadcrumb-segment", children: [index > 0 && breadcrumbChevron, blocks[key]] }, `${index}-breadcrumb`));
107
+ }) }) }));
66
108
  };
109
+ Breadcrumb.BreadcrumbChevron = BreadcrumbChevron;
110
+ Breadcrumb.BreadcrumbItem = BreadcrumbItem;
111
+ const defaultBlocks = createDefaultBlocks({
112
+ breadcrumbChevron: BreadcrumbChevron,
113
+ breadcrumbItem: BreadcrumbItem,
114
+ });
67
115
 
68
116
  export { Breadcrumb as Breadcrumbs };
69
117
  //# sourceMappingURL=index.esm.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.esm.js","sources":["../src/blocks.tsx","../src/lib.ts","../node_modules/style-inject/dist/style-inject.es.js","../src/Breadcrumb.tsx"],"sourcesContent":["import React from 'react';\nimport { BreadcrumbItemProps } from './types';\n\nconst DefaultBreadcrumbItem: React.FC<BreadcrumbItemProps> = ({ label, url }) => (\n <a href={url} className=\"nbb-breadcrumb-item\">\n {label}\n </a>\n);\n\nconst DefaultBreadcrumbChevron: React.FC = () => <span className=\"nbb-breadcrumb-chevron\">\n <svg width=\"8\" height=\"12\" viewBox=\"0 0 8 12\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\">\n <path d=\"M0.294922 10.59L4.87492 6L0.294922 1.41L1.70492 0L7.70492 6L1.70492 12L0.294922 10.59Z\" fill=\"white\" />\n </svg>\n</span>;\n\nexport const defaultBlocks = {\n BreadcrumbItem: DefaultBreadcrumbItem,\n BreadcrumbChevron: DefaultBreadcrumbChevron,\n};","import { DefaultBlocks, DefaultSettings } from './types';\n\n/**\n * Sets the blocks and settings by merging the default blocks with custom blocks and settings.\n *\n * @param defaultBlocks - The default blocks to be used.\n * @param children - An optional function that takes the default blocks and settings and returns custom blocks and settings.\n * @param settings - Optional default settings to be used.\n * @returns An object containing the merged blocks and settings.\n */\n\ntype ChildrenProps = {\n defaultBlocks: DefaultBlocks,\n settings?: DefaultSettings\n}\nexport function setBlocks(\n defaultBlocks: DefaultBlocks,\n children?: (props: ChildrenProps) => {\n blocks: { [x: string]: any };\n settings?: DefaultSettings;\n },\n settings?: DefaultSettings,\n) {\n const { blocks: customBlocks = {}, settings: customSettings = {} } =\n children ? children({ defaultBlocks, settings }) : { blocks: {}, settings: {} };\n\n return {\n blocks: Object.fromEntries(\n Object.entries(defaultBlocks).map(([key, defaultComponent]) => [\n key,\n customBlocks[key] || defaultComponent,\n ])\n ),\n settings: {\n ...settings,\n ...customSettings,\n }\n };\n}\n\ntype ClassName = string | ClassName[] | undefined | null;\n\n/**\n * Utility function to join class names together, ignoring undefined or nil values.\n * @param classes - The class names to join.\n * @returns The joined class names.\n */\nexport function classNames(...classes: ClassName[]): string {\n return classes.flat().filter(Boolean).join(' ');\n}\n","function styleInject(css, ref) {\n if ( ref === void 0 ) ref = {};\n var insertAt = ref.insertAt;\n\n if (!css || typeof document === 'undefined') { return; }\n\n var head = document.head || document.getElementsByTagName('head')[0];\n var style = document.createElement('style');\n style.type = 'text/css';\n\n if (insertAt === 'top') {\n if (head.firstChild) {\n head.insertBefore(style, head.firstChild);\n } else {\n head.appendChild(style);\n }\n } else {\n head.appendChild(style);\n }\n\n if (style.styleSheet) {\n style.styleSheet.cssText = css;\n } else {\n style.appendChild(document.createTextNode(css));\n }\n}\n\nexport default styleInject;\n","import React from 'react';\nimport { defaultBlocks } from './blocks';\nimport { setBlocks, classNames } from './lib';\nimport { BreadcrumbProps } from './types';\nimport './breadcrumb.css';\n\n\n\nconst Breadcrumb: React.FC<BreadcrumbProps> = ({ items, className, children }) => {\n const { blocks } = setBlocks(defaultBlocks, children);\n const { BreadcrumbItem, BreadcrumbChevron } = blocks;\n\n return (\n <nav className={classNames('nbb-breadcrumb', className)}>\n {items.map((item, index) => (\n <span key={`${index}-breadcrumb`} className=\"nbb-breadcrumb-segment\">\n {index > 0 && <BreadcrumbChevron />}\n <BreadcrumbItem label={item.label} url={item.url} />\n </span>\n ))}\n </nav>\n );\n};\n\nexport default Breadcrumb;\n"],"names":["_jsx","_jsxs"],"mappings":";;AAGA,MAAM,qBAAqB,GAAkC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MACxEA,WAAG,IAAI,EAAE,GAAG,EAAE,SAAS,EAAC,qBAAqB,EACxC,QAAA,EAAA,KAAK,EACN,CAAA,CACP;AAED,MAAM,wBAAwB,GAAa,MAAMA,GAAA,CAAA,MAAA,EAAA,EAAM,SAAS,EAAC,wBAAwB,YACrFA,GAAK,CAAA,KAAA,EAAA,EAAA,KAAK,EAAC,GAAG,EAAC,MAAM,EAAC,IAAI,EAAC,OAAO,EAAC,UAAU,EAAC,IAAI,EAAC,MAAM,EAAC,KAAK,EAAC,4BAA4B,EACxF,QAAA,EAAAA,GAAA,CAAA,MAAA,EAAA,EAAM,CAAC,EAAC,wFAAwF,EAAC,IAAI,EAAC,OAAO,EAAG,CAAA,EAAA,CAC9G,GACH;AAEA,MAAM,aAAa,GAAG;AACzB,IAAA,cAAc,EAAE,qBAAqB;AACrC,IAAA,iBAAiB,EAAE,wBAAwB;CAC9C;;SCHe,SAAS,CACrB,aAA4B,EAC5B,QAGC,EACD,QAA0B,EAAA;AAE1B,IAAA,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,EAAE,EAAE,QAAQ,EAAE,cAAc,GAAG,EAAE,EAAE,GAC9D,QAAQ,GAAG,QAAQ,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;IAEnF,OAAO;QACH,MAAM,EAAE,MAAM,CAAC,WAAW,CACtB,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,gBAAgB,CAAC,KAAK;YAC3D,GAAG;AACH,YAAA,YAAY,CAAC,GAAG,CAAC,IAAI,gBAAgB;AACxC,SAAA,CAAC,CACL;AACD,QAAA,QAAQ,EAAE;AACN,YAAA,GAAG,QAAQ;AACX,YAAA,GAAG,cAAc;AACpB;KACJ;AACL;AAIA;;;;AAIG;AACa,SAAA,UAAU,CAAC,GAAG,OAAoB,EAAA;AAC9C,IAAA,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;AACnD;;ACjDA,SAAS,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE;AAC/B,EAAE,KAAK,GAAG,KAAK,MAAM,GAAG,GAAG,GAAG,EAAE;AAChC,EAAE,IAAI,QAAQ,GAAG,GAAG,CAAC,QAAQ;;AAE7B,EAAE,IAAY,OAAO,QAAQ,KAAK,WAAW,EAAE,EAAE,OAAO;;AAExD,EAAE,IAAI,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACtE,EAAE,IAAI,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC;AAC7C,EAAE,KAAK,CAAC,IAAI,GAAG,UAAU;;AAEzB,EAAE,IAAI,QAAQ,KAAK,KAAK,EAAE;AAC1B,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE;AACzB,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC;AAC/C,KAAK,MAAM;AACX,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;AAC7B;AACA,GAAG,MAAM;AACT,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;AAC3B;;AAEA,EAAE,IAAI,KAAK,CAAC,UAAU,EAAE;AACxB,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,GAAG,GAAG;AAClC,GAAG,MAAM;AACT,IAAI,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;AACnD;AACA;;;;;ACjBM,MAAA,UAAU,GAA8B,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAI;IAC/E,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,aAAa,EAAE,QAAQ,CAAC;AACrD,IAAA,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,GAAG,MAAM;AAEpD,IAAA,QACEA,GAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAE,UAAU,CAAC,gBAAgB,EAAE,SAAS,CAAC,EACpD,QAAA,EAAA,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,MACrBC,IAAA,CAAA,MAAA,EAAA,EAAkC,SAAS,EAAC,wBAAwB,EAAA,QAAA,EAAA,CACjE,KAAK,GAAG,CAAC,IAAID,GAAC,CAAA,iBAAiB,EAAG,EAAA,CAAA,EACnCA,GAAC,CAAA,cAAc,EAAC,EAAA,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAI,CAAA,CAAA,EAAA,EAF3C,CAAG,EAAA,KAAK,CAAa,WAAA,CAAA,CAGzB,CACR,CAAC,EACE,CAAA;AAEV;;;;","x_google_ignoreList":[2]}
1
+ {"version":3,"file":"index.esm.js","sources":["../src/blocks.tsx","../node_modules/style-inject/dist/style-inject.es.js","../src/lib.ts","../src/Breadcrumb.tsx"],"sourcesContent":["import { ComponentProps, ReactNode } from \"react\";\n\nexport const BreadcrumbItem = ({\n url,\n children,\n}: Omit<ComponentProps<\"a\">, \"children\"> & {\n url: string;\n children: ReactNode;\n}) => (\n <a href={url} className=\"nbb-breadcrumb-item\">\n {children}\n </a>\n);\n\nexport const BreadcrumbChevron = () => (\n <span className=\"nbb-breadcrumb-chevron\">\n <svg\n width=\"8\"\n height=\"12\"\n viewBox=\"0 0 8 12\"\n fill=\"none\"\n xmlns=\"http://www.w3.org/2000/svg\"\n >\n <path\n d=\"M0.294922 10.59L4.87492 6L0.294922 1.41L1.70492 0L7.70492 6L1.70492 12L0.294922 10.59Z\"\n fill=\"white\"\n />\n </svg>\n </span>\n);\n","function styleInject(css, ref) {\n if ( ref === void 0 ) ref = {};\n var insertAt = ref.insertAt;\n\n if (!css || typeof document === 'undefined') { return; }\n\n var head = document.head || document.getElementsByTagName('head')[0];\n var style = document.createElement('style');\n style.type = 'text/css';\n\n if (insertAt === 'top') {\n if (head.firstChild) {\n head.insertBefore(style, head.firstChild);\n } else {\n head.appendChild(style);\n }\n } else {\n head.appendChild(style);\n }\n\n if (style.styleSheet) {\n style.styleSheet.cssText = css;\n } else {\n style.appendChild(document.createTextNode(css));\n }\n}\n\nexport default styleInject;\n","import {\n ComponentProps,\n createElement,\n FunctionComponent,\n ReactElement,\n ReactNode,\n} from \"react\";\n\n/**\n * The function to be passed into a block component as `children` to selectively override default blocks, or just a `ReactNode`.\n *\n * @example\n * <Block>\n * {({header, ...defaultBlocks}) => ({\n * blocks: {\n * ...defaultBlocks,\n * header: {\n * ...header,\n * props: {\n * ...header.props,\n * label: \"Custom Label\"\n * }\n * },\n * subheader: <CustomComponent />\n * },\n * blockOrder: [\"header\", \"subheader\", \"body\", \"footer\"]\n * })}\n * </Block>\n */\nexport type BlocksOverride<DefaultBlocks, CustomBlocks> =\n | (({\n defaultBlocks,\n defaultBlockOrder,\n }: {\n defaultBlocks: DefaultBlocks;\n defaultBlockOrder: readonly (keyof DefaultBlocks)[];\n }) => {\n blocks: Partial<DefaultBlocks> & CustomBlocks;\n // NOTE: This specific combination allows proper autocomplete.\n blockOrder:\n | readonly (keyof DefaultBlocks)[]\n | readonly (keyof CustomBlocks)[];\n })\n | ReactNode;\n\n/**\n * Creates a strongly typed `defaultBlocks` object, allowing for types to propagate into block override objects.\n *\n * @param components - A map of default block keys to component functions.\n *\n * @example\n * const defaultBlocks = createDefaultBlocks({\n * title: Title,\n * description: Description,\n * form: Form,\n * });\n */\nexport function createDefaultBlocks<\n T extends Record<string, FunctionComponent<any>>,\n>(\n components: T\n): {\n [K in keyof T]: ReactElement<ComponentProps<T[K]>, T[K]>;\n} {\n return Object.fromEntries(\n Object.entries(components).map(([key, Component]) => [\n key,\n createElement(Component, { key }),\n ])\n ) as {\n [K in keyof T]: ReactElement<ComponentProps<T[K]>, T[K]>;\n };\n}\n\n/**\n * A component for rendering {@link BlocksOverride|`BlocksOverride`} results.\n * Exposes the evaluated `blocks` and `blockOrder` as arguments to the `children` function.\n *\n * @param props\n * @param props.blocksOverride - The {@link BlocksOverride|`BlocksOverride`} (i.e. `children` of outer component).\n * @param props.defaultBlocks - The default blocks of outer component.\n * @param props.children - A function returning the JSX to render.\n *\n * @example\n * <BlocksOverrideComponent\n * defaultBlocks={defaultFormBlocks}\n * blocksOverride={children}\n * >\n * {({ blocks, blockOrder }) =>\n * blockOrder.map((key) => (\n * <Fragment key={String(key)}>{blocks[key]}</Fragment>\n * ))\n * }\n * </BlocksOverrideComponent>\n */\nexport function BlocksOverrideComponent<\n DefaultBlocks extends Record<string, ReactNode>,\n CustomBlocks extends Record<string, ReactNode>,\n>({\n blocksOverride,\n defaultBlocks,\n defaultBlockOrder,\n children,\n}: {\n blocksOverride: BlocksOverride<DefaultBlocks, CustomBlocks>;\n defaultBlocks: DefaultBlocks;\n defaultBlockOrder: (keyof DefaultBlocks)[];\n children: ({\n blocks,\n blockOrder,\n }: {\n // TODO: Possibly find an alternative to Partial<CustomBlocks>\n blocks: Partial<DefaultBlocks> & Partial<CustomBlocks>;\n blockOrder: readonly (keyof DefaultBlocks | keyof CustomBlocks)[];\n }) => ReactNode;\n}) {\n if (blocksOverride === undefined) {\n return children({\n // TODO: Remove this assertion\n blocks: defaultBlocks as DefaultBlocks & Partial<CustomBlocks>,\n blockOrder: defaultBlockOrder,\n });\n }\n\n if (typeof blocksOverride === \"function\") {\n const { blocks, blockOrder } = blocksOverride({\n defaultBlocks,\n defaultBlockOrder,\n });\n\n return children({ blocks, blockOrder });\n }\n\n return blocksOverride;\n}\n\nexport function deepMerge<\n A extends Record<string, any>,\n B extends Record<string, any>,\n>(obj1: A, obj2: B) {\n const result: Record<string, any> = { ...obj1 };\n\n for (const key in obj2) {\n if (obj2.hasOwnProperty(key)) {\n const val1 = result[key];\n const val2 = obj2[key];\n\n if (Array.isArray(val1) || Array.isArray(val2)) {\n // If either is an array, replace entirely with obj2's value\n result[key] = val2;\n } else if (\n typeof val1 === \"object\" &&\n val1 !== null &&\n typeof val2 === \"object\" &&\n val2 !== null\n ) {\n result[key] = deepMerge(val1, val2);\n } else {\n result[key] = val2;\n }\n }\n }\n\n return result as A & B;\n}\n\ntype ClassName = string | ClassName[] | undefined | null;\n\n/**\n * Utility function to join class names together, ignoring undefined or nil values.\n * @param classes - The class names to join.\n * @returns The joined class names.\n */\nexport function classNames(...classes: ClassName[]): string {\n return classes.flat().filter(Boolean).join(\" \");\n}\n","import { ComponentProps, ReactNode } from \"react\";\nimport { BreadcrumbChevron, BreadcrumbItem } from \"./blocks\";\nimport \"./breadcrumb.css\";\nimport {\n BlocksOverride,\n BlocksOverrideComponent,\n classNames,\n createDefaultBlocks,\n} from \"./lib\";\n\nconst Breadcrumb = <CustomBlocks extends Record<string, ReactNode>>({\n className,\n children,\n}: Omit<ComponentProps<\"nav\">, \"children\"> & {\n children?: BlocksOverride<typeof defaultBlocks, CustomBlocks>;\n}) => {\n return (\n <nav className={classNames(\"nbb-breadcrumb\", className)}>\n <BlocksOverrideComponent\n defaultBlocks={defaultBlocks}\n defaultBlockOrder={\n Object.keys(defaultBlocks) as (keyof typeof defaultBlocks)[]\n }\n blocksOverride={children}\n >\n {({\n blocks: { breadcrumbChevron, breadcrumbItem, ...blocks },\n blockOrder,\n }) =>\n blockOrder\n .filter((key) => key in blocks)\n .map<ReactNode>((key, index) => {\n return (\n <span\n key={`${index}-breadcrumb`}\n className=\"nbb-breadcrumb-segment\"\n >\n {index > 0 && breadcrumbChevron}\n {blocks[key]}\n </span>\n );\n })\n }\n </BlocksOverrideComponent>\n </nav>\n );\n};\n\nBreadcrumb.BreadcrumbChevron = BreadcrumbChevron;\nBreadcrumb.BreadcrumbItem = BreadcrumbItem;\n\nconst defaultBlocks = createDefaultBlocks({\n breadcrumbChevron: BreadcrumbChevron,\n breadcrumbItem: BreadcrumbItem,\n});\n\nexport default Breadcrumb;\n"],"names":["_jsx","_jsxs"],"mappings":"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","x_google_ignoreList":[1]}
package/dist/lib.d.ts CHANGED
@@ -1,27 +1,78 @@
1
- import { DefaultBlocks, DefaultSettings } from './types';
1
+ import { ComponentProps, FunctionComponent, ReactElement, ReactNode } from "react";
2
2
  /**
3
- * Sets the blocks and settings by merging the default blocks with custom blocks and settings.
3
+ * The function to be passed into a block component as `children` to selectively override default blocks, or just a `ReactNode`.
4
4
  *
5
- * @param defaultBlocks - The default blocks to be used.
6
- * @param children - An optional function that takes the default blocks and settings and returns custom blocks and settings.
7
- * @param settings - Optional default settings to be used.
8
- * @returns An object containing the merged blocks and settings.
5
+ * @example
6
+ * <Block>
7
+ * {({header, ...defaultBlocks}) => ({
8
+ * blocks: {
9
+ * ...defaultBlocks,
10
+ * header: {
11
+ * ...header,
12
+ * props: {
13
+ * ...header.props,
14
+ * label: "Custom Label"
15
+ * }
16
+ * },
17
+ * subheader: <CustomComponent />
18
+ * },
19
+ * blockOrder: ["header", "subheader", "body", "footer"]
20
+ * })}
21
+ * </Block>
9
22
  */
10
- type ChildrenProps = {
23
+ export type BlocksOverride<DefaultBlocks, CustomBlocks> = (({ defaultBlocks, defaultBlockOrder, }: {
11
24
  defaultBlocks: DefaultBlocks;
12
- settings?: DefaultSettings;
13
- };
14
- export declare function setBlocks(defaultBlocks: DefaultBlocks, children?: (props: ChildrenProps) => {
15
- blocks: {
16
- [x: string]: any;
17
- };
18
- settings?: DefaultSettings;
19
- }, settings?: DefaultSettings): {
20
- blocks: {
21
- [k: string]: any;
22
- };
23
- settings: {};
25
+ defaultBlockOrder: readonly (keyof DefaultBlocks)[];
26
+ }) => {
27
+ blocks: Partial<DefaultBlocks> & CustomBlocks;
28
+ blockOrder: readonly (keyof DefaultBlocks)[] | readonly (keyof CustomBlocks)[];
29
+ }) | ReactNode;
30
+ /**
31
+ * Creates a strongly typed `defaultBlocks` object, allowing for types to propagate into block override objects.
32
+ *
33
+ * @param components - A map of default block keys to component functions.
34
+ *
35
+ * @example
36
+ * const defaultBlocks = createDefaultBlocks({
37
+ * title: Title,
38
+ * description: Description,
39
+ * form: Form,
40
+ * });
41
+ */
42
+ export declare function createDefaultBlocks<T extends Record<string, FunctionComponent<any>>>(components: T): {
43
+ [K in keyof T]: ReactElement<ComponentProps<T[K]>, T[K]>;
24
44
  };
45
+ /**
46
+ * A component for rendering {@link BlocksOverride|`BlocksOverride`} results.
47
+ * Exposes the evaluated `blocks` and `blockOrder` as arguments to the `children` function.
48
+ *
49
+ * @param props
50
+ * @param props.blocksOverride - The {@link BlocksOverride|`BlocksOverride`} (i.e. `children` of outer component).
51
+ * @param props.defaultBlocks - The default blocks of outer component.
52
+ * @param props.children - A function returning the JSX to render.
53
+ *
54
+ * @example
55
+ * <BlocksOverrideComponent
56
+ * defaultBlocks={defaultFormBlocks}
57
+ * blocksOverride={children}
58
+ * >
59
+ * {({ blocks, blockOrder }) =>
60
+ * blockOrder.map((key) => (
61
+ * <Fragment key={String(key)}>{blocks[key]}</Fragment>
62
+ * ))
63
+ * }
64
+ * </BlocksOverrideComponent>
65
+ */
66
+ export declare function BlocksOverrideComponent<DefaultBlocks extends Record<string, ReactNode>, CustomBlocks extends Record<string, ReactNode>>({ blocksOverride, defaultBlocks, defaultBlockOrder, children, }: {
67
+ blocksOverride: BlocksOverride<DefaultBlocks, CustomBlocks>;
68
+ defaultBlocks: DefaultBlocks;
69
+ defaultBlockOrder: (keyof DefaultBlocks)[];
70
+ children: ({ blocks, blockOrder, }: {
71
+ blocks: Partial<DefaultBlocks> & Partial<CustomBlocks>;
72
+ blockOrder: readonly (keyof DefaultBlocks | keyof CustomBlocks)[];
73
+ }) => ReactNode;
74
+ }): ReactNode;
75
+ export declare function deepMerge<A extends Record<string, any>, B extends Record<string, any>>(obj1: A, obj2: B): A & B;
25
76
  type ClassName = string | ClassName[] | undefined | null;
26
77
  /**
27
78
  * Utility function to join class names together, ignoring undefined or nil values.
package/dist/lib.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEzD;;;;;;;GAOG;AAEH,KAAK,aAAa,GAAG;IACjB,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC7B,CAAA;AACD,wBAAgB,SAAS,CACrB,aAAa,EAAE,aAAa,EAC5B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK;IACjC,MAAM,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC9B,EACD,QAAQ,CAAC,EAAE,eAAe;;;;;EAiB7B;AAED,KAAK,SAAS,GAAG,MAAM,GAAG,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAE1D"}
1
+ {"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACV,MAAM,OAAO,CAAC;AAEf;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,cAAc,CAAC,aAAa,EAAE,YAAY,IAClD,CAAC,CAAC,EACA,aAAa,EACb,iBAAiB,GAClB,EAAE;IACD,aAAa,EAAE,aAAa,CAAC;IAC7B,iBAAiB,EAAE,SAAS,CAAC,MAAM,aAAa,CAAC,EAAE,CAAC;CACrD,KAAK;IACJ,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,YAAY,CAAC;IAE9C,UAAU,EACN,SAAS,CAAC,MAAM,aAAa,CAAC,EAAE,GAChC,SAAS,CAAC,MAAM,YAAY,CAAC,EAAE,CAAC;CACrC,CAAC,GACF,SAAS,CAAC;AAEd;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAEhD,UAAU,EAAE,CAAC,GACZ;KACA,CAAC,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CACzD,CASA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/C,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC9C,EACA,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,QAAQ,GACT,EAAE;IACD,cAAc,EAAE,cAAc,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC5D,aAAa,EAAE,aAAa,CAAC;IAC7B,iBAAiB,EAAE,CAAC,MAAM,aAAa,CAAC,EAAE,CAAC;IAC3C,QAAQ,EAAE,CAAC,EACT,MAAM,EACN,UAAU,GACX,EAAE;QAED,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QACvD,UAAU,EAAE,SAAS,CAAC,MAAM,aAAa,GAAG,MAAM,YAAY,CAAC,EAAE,CAAC;KACnE,KAAK,SAAS,CAAC;CACjB,aAmBA;AAED,wBAAgB,SAAS,CACvB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,GAwBC,CAAC,GAAG,CAAC,CACvB;AAED,KAAK,SAAS,GAAG,MAAM,GAAG,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAE1D"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nodeblocks/frontend-breadcrumb-block",
3
- "version": "0.0.2",
3
+ "version": "0.1.0",
4
4
  "main": "dist/index.cjs.js",
5
5
  "module": "dist/index.esm.js",
6
6
  "browser": "dist/index.iife.js",
package/dist/types.d.ts DELETED
@@ -1,26 +0,0 @@
1
- export type DefaultBlocks = {
2
- BreadcrumbItem: React.FC<BreadcrumbItemProps>;
3
- BreadcrumbChevron: React.FC;
4
- };
5
- export type DefaultSettings = {};
6
- export type BreadcrumbChildren = (props: {
7
- defaultBlocks: DefaultBlocks;
8
- settings?: {
9
- [key: string]: any;
10
- };
11
- }) => {
12
- blocks: Partial<DefaultBlocks>;
13
- settings?: {
14
- [key: string]: any;
15
- };
16
- };
17
- export type BreadcrumbItemProps = {
18
- label: string;
19
- url: string;
20
- };
21
- export type BreadcrumbProps = {
22
- items: BreadcrumbItemProps[];
23
- className?: string;
24
- children?: BreadcrumbChildren;
25
- };
26
- //# sourceMappingURL=types.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IACxB,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC;IAC9C,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC;CAC/B,CAAA;AACD,MAAM,MAAM,eAAe,GAAG,EAAE,CAAA;AAEhC,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE;IACrC,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAA;CACpC,KACI;IACD,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC1B,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,kBAAkB,CAAA;CAChC,CAAC"}