@blueprintjs/labs 0.16.2 → 6.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.
- package/LICENSE +153 -167
- package/README.md +1 -1
- package/lib/cjs/common/classes.d.ts +6 -0
- package/lib/cjs/common/classes.js +20 -0
- package/lib/cjs/common/classes.js.map +1 -0
- package/lib/cjs/common/index.d.ts +3 -1
- package/lib/cjs/common/index.js +9 -4
- package/lib/cjs/common/index.js.map +1 -1
- package/lib/cjs/common/props.d.ts +1 -0
- package/lib/cjs/common/props.js +10 -0
- package/lib/cjs/common/props.js.map +1 -0
- package/lib/cjs/components/box/box.d.ts +8 -0
- package/lib/cjs/components/box/box.js +25 -0
- package/lib/cjs/components/box/box.js.map +1 -0
- package/lib/cjs/components/box/box.test.d.ts +1 -0
- package/lib/cjs/components/box/box.test.js +80 -0
- package/lib/cjs/components/box/box.test.js.map +1 -0
- package/lib/cjs/components/box/boxProps.d.ts +246 -0
- package/lib/cjs/components/box/boxProps.js +6 -0
- package/lib/cjs/components/box/boxProps.js.map +1 -0
- package/lib/cjs/components/box/buildStyles.d.ts +23 -0
- package/lib/cjs/components/box/buildStyles.js +258 -0
- package/lib/cjs/components/box/buildStyles.js.map +1 -0
- package/lib/cjs/components/flex/flex.d.ts +7 -0
- package/lib/cjs/components/flex/flex.js +18 -0
- package/lib/cjs/components/flex/flex.js.map +1 -0
- package/lib/cjs/components/flex/flex.test.d.ts +1 -0
- package/lib/cjs/components/flex/flex.test.js +59 -0
- package/lib/cjs/components/flex/flex.test.js.map +1 -0
- package/lib/cjs/components/index.d.ts +3 -1
- package/lib/cjs/components/index.js +8 -4
- package/lib/cjs/components/index.js.map +1 -1
- package/lib/cjs/components/slot/slot.d.ts +7 -0
- package/lib/cjs/components/slot/slot.js +31 -0
- package/lib/cjs/components/slot/slot.js.map +1 -0
- package/lib/cjs/components/slot/slot.test.d.ts +1 -0
- package/lib/cjs/components/slot/slot.test.js +47 -0
- package/lib/cjs/components/slot/slot.test.js.map +1 -0
- package/lib/cjs/index.d.ts +0 -7
- package/lib/cjs/index.js +6 -15
- package/lib/cjs/index.js.map +1 -1
- package/lib/css/blueprint-labs.css +1630 -7
- package/lib/css/blueprint-labs.css.map +1 -10
- package/lib/esm/common/classes.d.ts +6 -0
- package/lib/esm/common/classes.js +16 -0
- package/lib/esm/common/classes.js.map +1 -0
- package/lib/esm/common/index.d.ts +3 -1
- package/lib/esm/common/index.js +6 -4
- package/lib/esm/common/index.js.map +1 -1
- package/lib/esm/common/props.d.ts +1 -0
- package/lib/esm/common/props.js +7 -0
- package/lib/esm/common/props.js.map +1 -0
- package/lib/esm/components/box/box.d.ts +8 -0
- package/lib/esm/components/box/box.js +21 -0
- package/lib/esm/components/box/box.js.map +1 -0
- package/lib/esm/components/box/box.test.d.ts +1 -0
- package/lib/esm/components/box/box.test.js +78 -0
- package/lib/esm/components/box/box.test.js.map +1 -0
- package/lib/esm/components/box/boxProps.d.ts +246 -0
- package/lib/esm/components/box/boxProps.js +5 -0
- package/lib/esm/components/box/boxProps.js.map +1 -0
- package/lib/esm/components/box/buildStyles.d.ts +23 -0
- package/lib/esm/components/box/buildStyles.js +254 -0
- package/lib/esm/components/box/buildStyles.js.map +1 -0
- package/lib/esm/components/flex/flex.d.ts +7 -0
- package/lib/esm/components/flex/flex.js +15 -0
- package/lib/esm/components/flex/flex.js.map +1 -0
- package/lib/esm/components/flex/flex.test.d.ts +1 -0
- package/lib/esm/components/flex/flex.test.js +57 -0
- package/lib/esm/components/flex/flex.test.js.map +1 -0
- package/lib/esm/components/index.d.ts +3 -1
- package/lib/esm/components/index.js +5 -4
- package/lib/esm/components/index.js.map +1 -1
- package/lib/esm/components/slot/slot.d.ts +7 -0
- package/lib/esm/components/slot/slot.js +27 -0
- package/lib/esm/components/slot/slot.js.map +1 -0
- package/lib/esm/components/slot/slot.test.d.ts +1 -0
- package/lib/esm/components/slot/slot.test.js +45 -0
- package/lib/esm/components/slot/slot.test.js.map +1 -0
- package/lib/esm/index.d.ts +2 -9
- package/lib/esm/index.js +5 -12
- package/lib/esm/index.js.map +1 -1
- package/lib/esnext/common/classes.d.ts +6 -0
- package/lib/esnext/common/classes.js +16 -0
- package/lib/esnext/common/classes.js.map +1 -0
- package/lib/esnext/common/index.d.ts +3 -0
- package/lib/esnext/common/index.js +8 -0
- package/lib/esnext/common/index.js.map +1 -0
- package/lib/esnext/common/props.d.ts +1 -0
- package/lib/esnext/common/props.js +7 -0
- package/lib/esnext/common/props.js.map +1 -0
- package/lib/esnext/components/box/box.d.ts +8 -0
- package/lib/esnext/components/box/box.js +21 -0
- package/lib/esnext/components/box/box.js.map +1 -0
- package/lib/esnext/components/box/box.test.d.ts +1 -0
- package/lib/esnext/components/box/box.test.js +78 -0
- package/lib/esnext/components/box/box.test.js.map +1 -0
- package/lib/esnext/components/box/boxProps.d.ts +246 -0
- package/lib/esnext/components/box/boxProps.js +5 -0
- package/lib/esnext/components/box/boxProps.js.map +1 -0
- package/lib/esnext/components/box/buildStyles.d.ts +23 -0
- package/lib/esnext/components/box/buildStyles.js +254 -0
- package/lib/esnext/components/box/buildStyles.js.map +1 -0
- package/lib/esnext/components/flex/flex.d.ts +7 -0
- package/lib/esnext/components/flex/flex.js +15 -0
- package/lib/esnext/components/flex/flex.js.map +1 -0
- package/lib/esnext/components/flex/flex.test.d.ts +1 -0
- package/lib/esnext/components/flex/flex.test.js +57 -0
- package/lib/esnext/components/flex/flex.test.js.map +1 -0
- package/lib/esnext/components/index.d.ts +3 -0
- package/lib/esnext/components/index.js +7 -0
- package/lib/esnext/components/index.js.map +1 -0
- package/lib/esnext/components/slot/slot.d.ts +7 -0
- package/lib/esnext/components/slot/slot.js +27 -0
- package/lib/esnext/components/slot/slot.js.map +1 -0
- package/lib/esnext/components/slot/slot.test.d.ts +1 -0
- package/lib/esnext/components/slot/slot.test.js +45 -0
- package/lib/esnext/components/slot/slot.test.js.map +1 -0
- package/lib/esnext/index.d.ts +2 -0
- package/lib/esnext/index.js +7 -0
- package/lib/esnext/index.js.map +1 -0
- package/package.json +59 -44
- package/src/_common.scss +9 -0
- package/src/blueprint-labs.scss +5 -7
- package/src/common/classes.ts +20 -0
- package/src/common/index.ts +7 -6
- package/src/common/props.ts +8 -0
- package/src/components/box/_box.scss +543 -0
- package/src/components/box/box.md +59 -0
- package/src/components/box/box.test.tsx +119 -0
- package/src/components/box/box.tsx +32 -0
- package/src/components/box/boxProps.ts +334 -0
- package/src/components/box/buildStyles.ts +307 -0
- package/src/components/flex/flex.md +52 -0
- package/src/components/flex/flex.test.tsx +93 -0
- package/src/components/flex/flex.tsx +20 -0
- package/src/components/index.ts +6 -6
- package/src/components/slot/slot.test.tsx +73 -0
- package/src/components/slot/slot.tsx +30 -0
- package/src/index.md +16 -5
- package/src/index.ts +3 -20
- package/src/tsconfig.json +5 -3
- package/src/vitest-env.d.ts +6 -0
- package/vitest.config.mts +17 -0
- package/vitest.setup.mts +13 -0
- package/dist/labs.bundle.js +0 -1
- package/src/components/_index.scss +0 -3
- package/src/tsconfig.cjs.json +0 -7
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
tag: new
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
@# Flex
|
|
6
|
+
|
|
7
|
+
**Flex** is a specialized layout component that wraps **Box** with `display="flex"` pre-applied. It simplifies flexbox layouts by providing convenient access to flexbox properties through props.
|
|
8
|
+
|
|
9
|
+
@## Import
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
import { Flex } from "@blueprintjs/labs";
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
@## Usage
|
|
16
|
+
|
|
17
|
+
Use **Flex** to create flexbox layouts with alignment, direction, and spacing props. Flex automatically sets `display: flex`, so you can focus on layout properties.
|
|
18
|
+
|
|
19
|
+
@## Flexbox props
|
|
20
|
+
|
|
21
|
+
Flex supports all Box props except `display`, with common flexbox patterns:
|
|
22
|
+
|
|
23
|
+
- **Direction & Wrap**: `flexDirection`, `flexWrap`
|
|
24
|
+
- **Alignment**: `alignItems`, `alignContent`, `justifyContent`
|
|
25
|
+
- **Gap**: `gap` for spacing between items
|
|
26
|
+
- **Child control**: `flex` for flex grow/shrink behavior
|
|
27
|
+
|
|
28
|
+
Each prop accepts Blueprint token values for consistent spacing and sizing.
|
|
29
|
+
|
|
30
|
+
@## Examples
|
|
31
|
+
|
|
32
|
+
@### Direction
|
|
33
|
+
|
|
34
|
+
Control the main axis and direction of how flex items are placed with the `flexDirection` property.
|
|
35
|
+
|
|
36
|
+
@reactCodeExample FlexDirectionExample
|
|
37
|
+
|
|
38
|
+
@### Alignment
|
|
39
|
+
|
|
40
|
+
Align flex items along the cross axis with `alignItems` and distribute them along the main axis with `justifyContent`.
|
|
41
|
+
|
|
42
|
+
@reactCodeExample FlexAlignExample
|
|
43
|
+
|
|
44
|
+
@### Gap
|
|
45
|
+
|
|
46
|
+
Add even spacing between flex items using the `gap` prop.
|
|
47
|
+
|
|
48
|
+
@reactCodeExample FlexGapExample
|
|
49
|
+
|
|
50
|
+
@## Props interface
|
|
51
|
+
|
|
52
|
+
@interface FlexProps
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
/* !
|
|
2
|
+
* (c) Copyright 2025 Palantir Technologies Inc. All rights reserved.
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
import { render, screen } from "@testing-library/react";
|
|
6
|
+
import { describe, expect, it } from "vitest";
|
|
7
|
+
|
|
8
|
+
import { Button, Classes as CoreClasses } from "@blueprintjs/core";
|
|
9
|
+
|
|
10
|
+
import { Classes } from "../../common";
|
|
11
|
+
|
|
12
|
+
import { Flex } from "./flex";
|
|
13
|
+
|
|
14
|
+
const NS = Classes.getClassNamespace();
|
|
15
|
+
|
|
16
|
+
describe("<Flex>", () => {
|
|
17
|
+
it("should render content", () => {
|
|
18
|
+
render(<Flex>Test</Flex>);
|
|
19
|
+
const flex = screen.getByText<HTMLDivElement>(/test/i);
|
|
20
|
+
|
|
21
|
+
expect(flex).toBeInTheDocument();
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
it("should always set display flex", () => {
|
|
25
|
+
render(<Flex>Test</Flex>);
|
|
26
|
+
const flex = screen.getByText<HTMLDivElement>(/test/i);
|
|
27
|
+
|
|
28
|
+
expect(flex).toHaveClass(`${NS}-flex`);
|
|
29
|
+
});
|
|
30
|
+
|
|
31
|
+
it("should pass through Box props", () => {
|
|
32
|
+
render(
|
|
33
|
+
<Flex gap={2} flexDirection="column" data-testid="flex-test">
|
|
34
|
+
Test
|
|
35
|
+
</Flex>,
|
|
36
|
+
);
|
|
37
|
+
const flex = screen.getByTestId("flex-test");
|
|
38
|
+
|
|
39
|
+
expect(flex).toHaveClass(`${NS}-gap-2`);
|
|
40
|
+
expect(flex).toHaveClass(`${NS}-flex-column`);
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
it("should support className", () => {
|
|
44
|
+
render(<Flex className="custom-class">Test</Flex>);
|
|
45
|
+
const flex = screen.getByText<HTMLDivElement>(/test/i);
|
|
46
|
+
|
|
47
|
+
expect(flex).toHaveClass("custom-class");
|
|
48
|
+
expect(flex).toHaveClass(Classes.BOX);
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
it("should support style prop", () => {
|
|
52
|
+
render(<Flex style={{ fontWeight: 700 }}>Test</Flex>);
|
|
53
|
+
const flex = screen.getByText<HTMLDivElement>(/test/i);
|
|
54
|
+
|
|
55
|
+
expect(flex).toHaveStyle({ fontWeight: 700 });
|
|
56
|
+
});
|
|
57
|
+
|
|
58
|
+
it("should support asChild prop", () => {
|
|
59
|
+
render(
|
|
60
|
+
<Flex asChild={true} gap={2}>
|
|
61
|
+
<Button intent="primary">Test</Button>
|
|
62
|
+
</Flex>,
|
|
63
|
+
);
|
|
64
|
+
const button = screen.getByRole<HTMLButtonElement>("button", { name: /test/i });
|
|
65
|
+
|
|
66
|
+
expect(button).toHaveClass(Classes.BOX);
|
|
67
|
+
expect(button).toHaveClass(CoreClasses.BUTTON);
|
|
68
|
+
expect(button).toHaveClass(`${NS}-flex`);
|
|
69
|
+
expect(button).toHaveClass(`${NS}-gap-2`);
|
|
70
|
+
});
|
|
71
|
+
|
|
72
|
+
it("should support all flex-related props", () => {
|
|
73
|
+
render(
|
|
74
|
+
<Flex
|
|
75
|
+
flexDirection="row"
|
|
76
|
+
flexWrap="wrap"
|
|
77
|
+
justifyContent="center"
|
|
78
|
+
alignItems="center"
|
|
79
|
+
gap={3}
|
|
80
|
+
data-testid="flex-all-props"
|
|
81
|
+
>
|
|
82
|
+
Test
|
|
83
|
+
</Flex>,
|
|
84
|
+
);
|
|
85
|
+
const flex = screen.getByTestId("flex-all-props");
|
|
86
|
+
|
|
87
|
+
expect(flex).toHaveClass(`${NS}-flex-row`);
|
|
88
|
+
expect(flex).toHaveClass(`${NS}-flex-wrap`);
|
|
89
|
+
expect(flex).toHaveClass(`${NS}-justify-center`);
|
|
90
|
+
expect(flex).toHaveClass(`${NS}-items-center`);
|
|
91
|
+
expect(flex).toHaveClass(`${NS}-gap-3`);
|
|
92
|
+
});
|
|
93
|
+
});
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/* !
|
|
2
|
+
* (c) Copyright 2025 Palantir Technologies Inc. All rights reserved.
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
import { forwardRef } from "react";
|
|
6
|
+
|
|
7
|
+
import { DISPLAYNAME_PREFIX } from "../../common";
|
|
8
|
+
import { Box } from "../box/box";
|
|
9
|
+
import type { BoxProps } from "../box/boxProps";
|
|
10
|
+
|
|
11
|
+
export type FlexProps = Omit<BoxProps, "display">;
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* Flex component.
|
|
15
|
+
*/
|
|
16
|
+
export const Flex = forwardRef<HTMLDivElement, FlexProps>(function Flex(props, ref) {
|
|
17
|
+
return <Box {...props} display="flex" ref={ref} />;
|
|
18
|
+
});
|
|
19
|
+
|
|
20
|
+
Flex.displayName = `${DISPLAYNAME_PREFIX}.Flex`;
|
package/src/components/index.ts
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
/*
|
|
2
|
-
* Copyright
|
|
3
|
-
*
|
|
4
|
-
* Licensed under the terms of the LICENSE file distributed with this project.
|
|
1
|
+
/* !
|
|
2
|
+
* (c) Copyright 2025 Palantir Technologies Inc. All rights reserved.
|
|
3
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
4
|
*/
|
|
6
5
|
|
|
7
|
-
|
|
8
|
-
export {};
|
|
6
|
+
export { Box } from "./box/box";
|
|
7
|
+
export type { BoxProps } from "./box/boxProps";
|
|
8
|
+
export { Flex, type FlexProps } from "./flex/flex";
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
/* !
|
|
2
|
+
* (c) Copyright 2025 Palantir Technologies Inc. All rights reserved.
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
import { render, screen } from "@testing-library/react";
|
|
6
|
+
import { createRef } from "react";
|
|
7
|
+
import { describe, expect, it, vi } from "vitest";
|
|
8
|
+
|
|
9
|
+
import { Slot } from "./slot";
|
|
10
|
+
|
|
11
|
+
describe("<Slot>", () => {
|
|
12
|
+
it("merges props into a single child", () => {
|
|
13
|
+
render(
|
|
14
|
+
<Slot data-test="bar">
|
|
15
|
+
<button id="foo">Test</button>
|
|
16
|
+
</Slot>,
|
|
17
|
+
);
|
|
18
|
+
const button = screen.getByRole<HTMLButtonElement>("button", { name: /test/i });
|
|
19
|
+
|
|
20
|
+
expect(button).toHaveAttribute("id", "foo");
|
|
21
|
+
expect(button).toHaveAttribute("data-test", "bar");
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
it("merges className and style", () => {
|
|
25
|
+
render(
|
|
26
|
+
<Slot className="outer" style={{ fontWeight: 700 }}>
|
|
27
|
+
<button className="inner" style={{ fontStyle: "italic" }}>
|
|
28
|
+
Test
|
|
29
|
+
</button>
|
|
30
|
+
</Slot>,
|
|
31
|
+
);
|
|
32
|
+
const button = screen.getByRole<HTMLButtonElement>("button", { name: /test/i });
|
|
33
|
+
|
|
34
|
+
expect(button).toHaveClass("outer");
|
|
35
|
+
expect(button).toHaveClass("inner");
|
|
36
|
+
expect(button).toHaveStyle({ fontWeight: 700 });
|
|
37
|
+
expect(button).toHaveStyle({ fontStyle: "italic" });
|
|
38
|
+
});
|
|
39
|
+
|
|
40
|
+
it("forwards ref to the child", () => {
|
|
41
|
+
const ref = createRef<HTMLButtonElement>();
|
|
42
|
+
render(
|
|
43
|
+
<Slot ref={ref}>
|
|
44
|
+
<button>Test</button>
|
|
45
|
+
</Slot>,
|
|
46
|
+
);
|
|
47
|
+
expect(ref.current).toBeInstanceOf(HTMLButtonElement);
|
|
48
|
+
expect(ref.current).toBeInTheDocument();
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
it("returns null if no children are provided", () => {
|
|
52
|
+
const { container } = render(<Slot />);
|
|
53
|
+
expect(container.firstChild).toBeNull();
|
|
54
|
+
});
|
|
55
|
+
|
|
56
|
+
it("throws an error when multiple children are provided", () => {
|
|
57
|
+
// suppress error logging to keep test output clean
|
|
58
|
+
const stderrWriteSpy = vi.spyOn(process.stderr, "write").mockImplementation(vi.fn());
|
|
59
|
+
const consoleErrorSpy = vi.spyOn(console, "error").mockImplementation(vi.fn());
|
|
60
|
+
|
|
61
|
+
expect(() => {
|
|
62
|
+
render(
|
|
63
|
+
<Slot>
|
|
64
|
+
<button>First</button>
|
|
65
|
+
<button>Second</button>
|
|
66
|
+
</Slot>,
|
|
67
|
+
);
|
|
68
|
+
}).toThrow("Only single element child is allowed in Slot");
|
|
69
|
+
|
|
70
|
+
stderrWriteSpy.mockRestore();
|
|
71
|
+
consoleErrorSpy.mockRestore();
|
|
72
|
+
});
|
|
73
|
+
});
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/* !
|
|
2
|
+
* (c) Copyright 2025 Palantir Technologies Inc. All rights reserved.
|
|
3
|
+
*/
|
|
4
|
+
|
|
5
|
+
import classNames from "classnames";
|
|
6
|
+
import { Children, cloneElement, forwardRef, isValidElement } from "react";
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Slot component.
|
|
10
|
+
*/
|
|
11
|
+
export const Slot = forwardRef<HTMLElement, React.HTMLAttributes<HTMLElement> & { children?: React.ReactNode }>(
|
|
12
|
+
function Slot({ children, ...props }, ref) {
|
|
13
|
+
if (isValidElement(children)) {
|
|
14
|
+
return cloneElement(children, {
|
|
15
|
+
...props,
|
|
16
|
+
...children.props,
|
|
17
|
+
className: classNames(props.className, children.props.className),
|
|
18
|
+
ref,
|
|
19
|
+
style: {
|
|
20
|
+
...props.style,
|
|
21
|
+
...children.props.style,
|
|
22
|
+
},
|
|
23
|
+
});
|
|
24
|
+
}
|
|
25
|
+
if (Children.count(children) > 1) {
|
|
26
|
+
throw new TypeError("Only single element child is allowed in Slot");
|
|
27
|
+
}
|
|
28
|
+
return null;
|
|
29
|
+
},
|
|
30
|
+
);
|
package/src/index.md
CHANGED
|
@@ -4,11 +4,22 @@ reference: labs
|
|
|
4
4
|
|
|
5
5
|
@# Labs
|
|
6
6
|
|
|
7
|
-
<div class="@ns-callout @ns-intent-warning @ns-icon-
|
|
8
|
-
<
|
|
9
|
-
The **[@blueprintjs/labs](https://www.npmjs.com/package/@blueprintjs/labs)** NPM package contains **unstable React components under active development by team members**. It is an incubator and staging area for components as we refine the API design; as such, this package will never reach 1.0.0, and every minor version should be considered breaking.
|
|
7
|
+
<div class="@ns-callout @ns-intent-warning @ns-icon-warning-sign">
|
|
8
|
+
<h5 class="@ns-heading">Under construction</h5>
|
|
10
9
|
</div>
|
|
11
10
|
|
|
12
|
-
|
|
11
|
+
The **[@blueprintjs/labs](https://www.npmjs.com/package/@blueprintjs/labs)** NPM package contains **unstable React components under active development by team members**. We're excited for this space to be used for experimentation of components that can help us augment the current Blueprint offerings, and support a faster iteration cycle with early feedback.
|
|
13
12
|
|
|
14
|
-
|
|
13
|
+
Labs is an incubator and staging area for components as we refine the API design; as such, every minor version should be considered breaking. This has started at version 6.0.0 to signal resurrection of the package after a hiatus, and to align with the current major version of the core Blueprint package. Blueprint Labs will follow the same major versioning as the core Blueprint package moving forward.
|
|
14
|
+
|
|
15
|
+
The goal for the labs package is to eventually graduate components into the core package. The criteria to evaluate promotion into core will be as follows:
|
|
16
|
+
|
|
17
|
+
- It should have a stable and well-designed API
|
|
18
|
+
- It should be well-tested
|
|
19
|
+
- It should have documentation and examples
|
|
20
|
+
- It should match the code quality of the stable components
|
|
21
|
+
|
|
22
|
+
While we make no guarantees with respect to API breaks, we will be communicating changes clearly in the changelog and release notes. Please provide feedback on the components in this package by opening issues or contributing PRs to help us improve them!
|
|
23
|
+
|
|
24
|
+
@page box
|
|
25
|
+
@page flex
|
package/src/index.ts
CHANGED
|
@@ -1,24 +1,7 @@
|
|
|
1
|
-
/*
|
|
2
|
-
* Copyright
|
|
3
|
-
*
|
|
4
|
-
* Licensed under the terms of the LICENSE file distributed with this project.
|
|
1
|
+
/* !
|
|
2
|
+
* (c) Copyright 2025 Palantir Technologies Inc. All rights reserved.
|
|
3
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
4
|
*/
|
|
6
5
|
|
|
7
6
|
export * from "./common";
|
|
8
7
|
export * from "./components";
|
|
9
|
-
|
|
10
|
-
// re-exports for 0.15.x provided as a migration path. these will be removed in 0.16.x
|
|
11
|
-
import { Popover, Tooltip } from "@blueprintjs/core";
|
|
12
|
-
export const Popover2 = Popover;
|
|
13
|
-
export const Tooltip2 = Tooltip;
|
|
14
|
-
|
|
15
|
-
import { Omnibar } from "@blueprintjs/select";
|
|
16
|
-
export const Omnibox = Omnibar;
|
|
17
|
-
export * from "@blueprintjs/select";
|
|
18
|
-
|
|
19
|
-
export {
|
|
20
|
-
ITimezonePickerProps,
|
|
21
|
-
ITimezonePickerState,
|
|
22
|
-
TimezoneDisplayFormat,
|
|
23
|
-
TimezonePicker,
|
|
24
|
-
} from "@blueprintjs/timezone";
|
package/src/tsconfig.json
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
{
|
|
2
|
-
"extends": "../../../config/tsconfig.
|
|
2
|
+
"extends": "../../../config/tsconfig.web",
|
|
3
3
|
"compilerOptions": {
|
|
4
|
-
"outDir": "../lib/esm"
|
|
5
|
-
|
|
4
|
+
"outDir": "../lib/esm",
|
|
5
|
+
"skipLibCheck": true // Avoiding type conflicts with node_modules
|
|
6
|
+
},
|
|
7
|
+
"include": ["**/*.ts", "**/*.tsx", "vitest-env.d.ts"]
|
|
6
8
|
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/* !
|
|
2
|
+
* (c) Copyright 2025 Palantir Technologies Inc. All rights reserved.
|
|
3
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import react from "@vitejs/plugin-react";
|
|
7
|
+
import { defineConfig } from "vitest/config";
|
|
8
|
+
|
|
9
|
+
export default defineConfig({
|
|
10
|
+
plugins: [react()],
|
|
11
|
+
test: {
|
|
12
|
+
environment: "jsdom",
|
|
13
|
+
exclude: ["lib/**", "node_modules/**"],
|
|
14
|
+
include: ["src/**/*.{test,spec}.{ts,tsx}"],
|
|
15
|
+
setupFiles: "./vitest.setup.mts",
|
|
16
|
+
},
|
|
17
|
+
});
|
package/vitest.setup.mts
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/* !
|
|
2
|
+
* (c) Copyright 2025 Palantir Technologies Inc. All rights reserved.
|
|
3
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import "@testing-library/jest-dom/vitest";
|
|
7
|
+
import { cleanup } from "@testing-library/react";
|
|
8
|
+
import { afterEach } from "vitest";
|
|
9
|
+
|
|
10
|
+
// Cleanup after each test
|
|
11
|
+
afterEach(() => {
|
|
12
|
+
cleanup();
|
|
13
|
+
});
|
package/dist/labs.bundle.js
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
!function(e,n){"object"==typeof exports&&"object"==typeof module?module.exports=n(require("@blueprintjs/core"),require("@blueprintjs/select"),require("@blueprintjs/timezone")):"function"==typeof define&&define.amd?define(["@blueprintjs/core","@blueprintjs/select","@blueprintjs/timezone"],n):"object"==typeof exports?exports.Labs=n(require("@blueprintjs/core"),require("@blueprintjs/select"),require("@blueprintjs/timezone")):(e.Blueprint=e.Blueprint||{},e.Blueprint.Labs=n(e.Blueprint.Core,e.Blueprint.Select,e.Blueprint.Timezone))}("undefined"!=typeof self?self:this,function(e,n,r){return function(e){var n={};function r(t){if(n[t])return n[t].exports;var o=n[t]={i:t,l:!1,exports:{}};return e[t].call(o.exports,o,o.exports,r),o.l=!0,o.exports}return r.m=e,r.c=n,r.d=function(e,n,t){r.o(e,n)||Object.defineProperty(e,n,{configurable:!1,enumerable:!0,get:t})},r.n=function(e){var n=e&&e.__esModule?function(){return e.default}:function(){return e};return r.d(n,"a",n),n},r.o=function(e,n){return Object.prototype.hasOwnProperty.call(e,n)},r.p="",r(r.s=1)}([function(e,r){e.exports=n},function(e,n,r){e.exports=r(2)},function(e,n,r){"use strict";Object.defineProperty(n,"__esModule",{value:!0}),r.d(n,"Popover2",function(){return p}),r.d(n,"Tooltip2",function(){return c}),r.d(n,"Omnibox",function(){return l});var t=r(3),o=(r.n(t),r(0));r.n(o);for(var i in o)["Popover2","Tooltip2","Omnibox","TimezoneDisplayFormat","TimezonePicker","default"].indexOf(i)<0&&function(e){r.d(n,e,function(){return o[e]})}(i);var u=r(4);r.n(u);r.o(u,"TimezoneDisplayFormat")&&r.d(n,"TimezoneDisplayFormat",function(){return u.TimezoneDisplayFormat}),r.o(u,"TimezonePicker")&&r.d(n,"TimezonePicker",function(){return u.TimezonePicker});var p=t.Popover,c=t.Tooltip,l=o.Omnibar},function(n,r){n.exports=e},function(e,n){e.exports=r}])});
|