@gridui/panel 0.0.0-stage → 0.0.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/README.md CHANGED
@@ -1,3 +1,43 @@
1
- # Temporary Holding Version
1
+ # @gridui/panel
2
+
3
+ Layout family. Public API: `ContentPanel`, `ContentPanelProps`, `HeadingPanel`, `HeadingPanelProps`.
4
+
5
+ Import components from `@gridui/panel` and load `@gridui/panel/styles.css` after Theme.
6
+ Load styles for any composed dependency used by this family. Applications own routes, labels, state persistence, and branding.
7
+
8
+ See [component ownership](../../docs/component-ownership.md) and [release history](.changeset/history/).
9
+
10
+ ## Content geometry and native semantics
11
+
12
+ `@gridui/grid` owns local geometry and page frames. `Row` declares gap,
13
+ row gap, wrapping, alignment, and start/between justification. `ActionNavigation` from `@gridui/action-navigation`
14
+ preserves a native navigation landmark for wrapping action links. `ContentPanel`
15
+ accepts responsive block and inline padding and neutral/brand tone. An enclosing
16
+ Grid, Split, or frame owns its structural boundary. `HeadingPanel` composes a
17
+ heading and decorative artwork through Grid's Split;
18
+ `FeatureLink` keeps its required identity and optional category, description,
19
+ and destination slots inside one native anchor. Omitted, empty, or false slots
20
+ add no wrapper, spacing, or separator. FeatureIdentity, FeatureDomain, and
21
+ FeatureAction render identity, domain text, and icon/action content without requiring consumer
22
+ knowledge of their CSS classes. Applications supply the destination and accent seed.
23
+ Controls' `BrandLink` provides compact, standard, and large header sizes.
24
+ Data's `RailProfile` owns vertical
25
+ identity presentation while its caller owns the account state and action.
26
+ `FrameHero` requires only its primary content. `artworkLabel`, `note`, and
27
+ `noteLabel` are optional; omitted content adds no caption or note region. A note
28
+ without a label spans the full width. A note label appears only with a note.
29
+ Data's `Steps` preserves native list semantics. Expandable sections use the shared
30
+ [Controls Disclosure](../../docs/component-ownership.md).
31
+ Public typography classes (`gridui-wordmark`, `gridui-copy`, `gridui-note`,
32
+ `gridui-error`, and `gridui-status`) belong to the theme. Applications may configure theme
33
+ variables and content measures; do not copy their geometry into application CSS.
34
+
35
+ `FrameHeader` exposes `wrap`, `gap`, and `justify`; consumers must not select its internal
36
+ chrome element. `FrameFooter.contentLayout` and `signatureAppearance` control
37
+ footer layout and signature treatment. `FrameSection.paddingInline` and
38
+ `paddingBlock` control inner padding while its edges stay with the frame.
39
+ `PageFrame.mainGutterStart` scopes responsive gutter overrides to
40
+ main without affecting the header or footer. `GridItem.align` aligns contained
41
+ controls. `Stack` supports full width, a maximum content measure, and start
42
+ padding. These props are consumed by the UI library rather than forwarded to DOM.
2
43
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
@@ -0,0 +1,15 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Panel
4
+ * @namespace ContentPanel
5
+ * @description Content Panel
6
+ */
7
+ import { type Responsive, type Space } from "@gridui/style-utils/responsive";
8
+ import type { ComponentPropsWithRef, FC } from "react";
9
+ export type ContentPanelProps = ComponentPropsWithRef<"div"> & {
10
+ readonly padding?: Responsive<Space>;
11
+ readonly paddingInline?: Responsive<Space>;
12
+ readonly paddingBlock?: Responsive<Space>;
13
+ readonly tone?: "neutral" | "brand";
14
+ };
15
+ export declare const ContentPanel: FC<ContentPanelProps>;
@@ -0,0 +1,7 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Panel
4
+ * @namespace ContentPanel
5
+ * @description Style
6
+ */
7
+ export declare const contentPanelStyles: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
@@ -0,0 +1,11 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Panel
4
+ * @namespace HeadingPanel
5
+ * @description Heading Panel
6
+ */
7
+ import type { ComponentPropsWithRef, FC, ReactNode } from "react";
8
+ export type HeadingPanelProps = ComponentPropsWithRef<"div"> & {
9
+ readonly artwork: ReactNode;
10
+ };
11
+ export declare const HeadingPanel: FC<HeadingPanelProps>;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Panel
4
+ * @namespace HeadingPanel
5
+ * @description Style
6
+ */
7
+ export declare const headingPanelStyles: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
8
+ export declare const headingArtworkStyles: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
@@ -0,0 +1,10 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Panel
4
+ * @namespace Root
5
+ * @description Index
6
+ */
7
+ export type { ContentPanelProps } from "./content-panel/content-panel";
8
+ export { ContentPanel } from "./content-panel/content-panel";
9
+ export type { HeadingPanelProps } from "./heading-panel/heading-panel";
10
+ export { HeadingPanel } from "./heading-panel/heading-panel";
package/dist/index.js ADDED
@@ -0,0 +1,97 @@
1
+ // src/content-panel/style.ts
2
+ import { cn } from "@gridui/style-utils";
3
+ import { cva } from "class-variance-authority";
4
+ var contentPanelStyles = cva(cn(
5
+ "gridui-content-panel",
6
+ "data-[tone='brand']:bg-brand-tint"
7
+ ));
8
+
9
+ // src/content-panel/content-panel.tsx
10
+ import { cn as cn2 } from "@gridui/style-utils";
11
+ import { spacingVariables } from "@gridui/style-utils/responsive";
12
+ import { jsx } from "react/jsx-runtime";
13
+ var ContentPanel = (props) => {
14
+ const {
15
+ padding = 24,
16
+ paddingInline = padding,
17
+ paddingBlock = padding,
18
+ tone = "neutral",
19
+ className,
20
+ style,
21
+ ...restProps
22
+ } = props;
23
+ return /* @__PURE__ */ jsx(
24
+ "div",
25
+ {
26
+ ...restProps,
27
+ className: cn2(contentPanelStyles(), className),
28
+ "data-tone": tone,
29
+ style: {
30
+ ...spacingVariables("panel-inline", paddingInline),
31
+ ...spacingVariables("panel-block", paddingBlock),
32
+ ...style
33
+ }
34
+ }
35
+ );
36
+ };
37
+
38
+ // src/heading-panel/style.ts
39
+ import { cn as cn3 } from "@gridui/style-utils";
40
+ import { cva as cva2 } from "class-variance-authority";
41
+ var headingPanelStyles = cva2(cn3(
42
+ "gridui-heading-panel",
43
+ "[&_h1]:flex [&_h1]:items-center [&_h1]:p-gridui-24 [&_h1]:bg-background",
44
+ "min-[40rem]:[&_h1]:py-gridui-32 min-[40rem]:[&_h1]:px-gridui-48"
45
+ ));
46
+ var headingArtworkStyles = cva2(cn3(
47
+ "gridui-heading-artwork",
48
+ "relative isolate grid min-h-28 place-items-center bg-[color-mix(in_srgb,var(--gridui-brand-art)_3%,transparent)]",
49
+ "[&_svg]:w-19 [&_svg]:h-19",
50
+ "min-[40rem]:min-h-40",
51
+ "min-[40rem]:[&_svg]:w-28 min-[40rem]:[&_svg]:h-28"
52
+ ));
53
+
54
+ // src/heading-panel/heading-panel.tsx
55
+ import { FrameTexture, Split } from "@gridui/grid";
56
+ import { cn as cn4 } from "@gridui/style-utils";
57
+ import { jsx as jsx2, jsxs } from "react/jsx-runtime";
58
+ var HeadingPanel = (props) => {
59
+ const { artwork, children, className, ...restProps } = props;
60
+ return /* @__PURE__ */ jsxs(
61
+ Split,
62
+ {
63
+ ...restProps,
64
+ className: cn4(headingPanelStyles(), className),
65
+ children: [
66
+ /* @__PURE__ */ jsx2(
67
+ "div",
68
+ {
69
+ className: "gridui-heading-copy",
70
+ children
71
+ }
72
+ ),
73
+ /* @__PURE__ */ jsxs(
74
+ "div",
75
+ {
76
+ className: cn4(headingArtworkStyles()),
77
+ "aria-hidden": "true",
78
+ children: [
79
+ /* @__PURE__ */ jsx2(
80
+ FrameTexture,
81
+ {
82
+ texture: "grid"
83
+ }
84
+ ),
85
+ artwork
86
+ ]
87
+ }
88
+ )
89
+ ]
90
+ }
91
+ );
92
+ };
93
+ export {
94
+ ContentPanel,
95
+ HeadingPanel
96
+ };
97
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../src/content-panel/style.ts", "../src/content-panel/content-panel.tsx", "../src/heading-panel/style.ts", "../src/heading-panel/heading-panel.tsx"],
4
+ "sourcesContent": ["/**\n * @author WMXPY\n * @package Panel\n * @namespace ContentPanel\n * @description Style\n */\n\nimport { cn } from \"@gridui/style-utils\";\nimport { cva } from \"class-variance-authority\";\n\nexport const contentPanelStyles = cva(cn(\n \"gridui-content-panel\",\n \"data-[tone='brand']:bg-brand-tint\",\n));\n", "/**\n * @author WMXPY\n * @package Panel\n * @namespace ContentPanel\n * @description Content Panel\n */\n\nimport { contentPanelStyles } from \"./style\";\nimport { cn } from \"@gridui/style-utils\";\nimport { type Responsive, type Space, spacingVariables } from \"@gridui/style-utils/responsive\";\nimport type { ComponentPropsWithRef, FC } from \"react\";\n\nexport type ContentPanelProps = ComponentPropsWithRef<\"div\"> & {\n readonly padding?: Responsive<Space>;\n readonly paddingInline?: Responsive<Space>;\n readonly paddingBlock?: Responsive<Space>;\n readonly tone?: \"neutral\" | \"brand\";\n};\n\nexport const ContentPanel: FC<ContentPanelProps> = (props: ContentPanelProps) => {\n const {\n padding = 24,\n paddingInline = padding,\n paddingBlock = padding,\n tone = \"neutral\",\n className,\n style,\n ...restProps\n } = props;\n return (<div\n {...restProps}\n className={cn(contentPanelStyles(), className)}\n data-tone={tone}\n style={{\n ...spacingVariables(\"panel-inline\", paddingInline),\n ...spacingVariables(\"panel-block\", paddingBlock),\n ...style,\n }}\n />);\n};\n", "/**\n * @author WMXPY\n * @package Panel\n * @namespace HeadingPanel\n * @description Style\n */\n\nimport { cn } from \"@gridui/style-utils\";\nimport { cva } from \"class-variance-authority\";\n\nexport const headingPanelStyles = cva(cn(\n \"gridui-heading-panel\",\n \"[&_h1]:flex [&_h1]:items-center [&_h1]:p-gridui-24 [&_h1]:bg-background\",\n \"min-[40rem]:[&_h1]:py-gridui-32 min-[40rem]:[&_h1]:px-gridui-48\",\n));\n\nexport const headingArtworkStyles = cva(cn(\n \"gridui-heading-artwork\",\n \"relative isolate grid min-h-28 place-items-center bg-[color-mix(in_srgb,var(--gridui-brand-art)_3%,transparent)]\",\n \"[&_svg]:w-19 [&_svg]:h-19\",\n \"min-[40rem]:min-h-40\",\n \"min-[40rem]:[&_svg]:w-28 min-[40rem]:[&_svg]:h-28\",\n));\n", "/**\n * @author WMXPY\n * @package Panel\n * @namespace HeadingPanel\n * @description Heading Panel\n */\n\nimport { headingArtworkStyles, headingPanelStyles } from \"./style\";\nimport { FrameTexture, Split } from \"@gridui/grid\";\nimport { cn } from \"@gridui/style-utils\";\nimport type { ComponentPropsWithRef, FC, ReactNode } from \"react\";\n\nexport type HeadingPanelProps = ComponentPropsWithRef<\"div\"> & {\n readonly artwork: ReactNode;\n};\n\nexport const HeadingPanel: FC<HeadingPanelProps> = (props: HeadingPanelProps) => {\n const { artwork, children, className, ...restProps } = props;\n return (<Split\n {...restProps}\n className={cn(headingPanelStyles(), className)}\n >\n <div\n className=\"gridui-heading-copy\"\n >\n {children}\n </div>\n <div\n className={cn(headingArtworkStyles())}\n aria-hidden=\"true\"\n >\n <FrameTexture\n texture=\"grid\"\n />\n {artwork}\n </div>\n </Split>);\n};\n"],
5
+ "mappings": ";AAOA,SAAS,UAAU;AACnB,SAAS,WAAW;AAEb,IAAM,qBAAqB,IAAI;AAAA,EAClC;AAAA,EACA;AACJ,CAAC;;;ACLD,SAAS,MAAAA,WAAU;AACnB,SAAsC,wBAAwB;AAoBlD;AAVL,IAAM,eAAsC,CAAC,UAA6B;AAC7E,QAAM;AAAA,IACF,UAAU;AAAA,IACV,gBAAgB;AAAA,IAChB,eAAe;AAAA,IACf,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA,GAAG;AAAA,EACP,IAAI;AACJ,SAAQ;AAAA,IAAC;AAAA;AAAA,MACJ,GAAG;AAAA,MACJ,WAAWA,IAAG,mBAAmB,GAAG,SAAS;AAAA,MAC7C,aAAW;AAAA,MACX,OAAO;AAAA,QACH,GAAG,iBAAiB,gBAAgB,aAAa;AAAA,QACjD,GAAG,iBAAiB,eAAe,YAAY;AAAA,QAC/C,GAAG;AAAA,MACP;AAAA;AAAA,EACJ;AACJ;;;AChCA,SAAS,MAAAC,WAAU;AACnB,SAAS,OAAAC,YAAW;AAEb,IAAM,qBAAqBA,KAAID;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACJ,CAAC;AAEM,IAAM,uBAAuBC,KAAID;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ,CAAC;;;ACdD,SAAS,cAAc,aAAa;AACpC,SAAS,MAAAE,WAAU;AAaX,gBAAAC,MAKA,YALA;AAND,IAAM,eAAsC,CAAC,UAA6B;AAC7E,QAAM,EAAE,SAAS,UAAU,WAAW,GAAG,UAAU,IAAI;AACvD,SAAQ;AAAA,IAAC;AAAA;AAAA,MACJ,GAAG;AAAA,MACJ,WAAWD,IAAG,mBAAmB,GAAG,SAAS;AAAA,MAE7C;AAAA,wBAAAC;AAAA,UAAC;AAAA;AAAA,YACG,WAAU;AAAA,YAET;AAAA;AAAA,QACL;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACG,WAAWD,IAAG,qBAAqB,CAAC;AAAA,YACpC,eAAY;AAAA,YAEZ;AAAA,8BAAAC;AAAA,gBAAC;AAAA;AAAA,kBACG,SAAQ;AAAA;AAAA,cACZ;AAAA,cACC;AAAA;AAAA;AAAA,QACL;AAAA;AAAA;AAAA,EACJ;AACJ;",
6
+ "names": ["cn", "cn", "cva", "cn", "jsx"]
7
+ }
@@ -0,0 +1,97 @@
1
+ /*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
2
+ @layer theme, base, components, utilities;
3
+ @layer theme {
4
+ :root, :host {
5
+ --spacing: 0.25rem;
6
+ }
7
+ }
8
+ @layer utilities {
9
+ .relative {
10
+ position: relative;
11
+ }
12
+ .isolate {
13
+ isolation: isolate;
14
+ }
15
+ .grid {
16
+ display: grid;
17
+ }
18
+ .min-h-28 {
19
+ min-height: calc(var(--spacing) * 28);
20
+ }
21
+ .place-items-center {
22
+ place-items: center;
23
+ }
24
+ .bg-\[color-mix\(in_srgb\,var\(--gridui-brand-art\)_3\%\,transparent\)\] {
25
+ background-color: var(--gridui-brand-art);
26
+ @supports (color: color-mix(in lab, red, red)) {
27
+ background-color: color-mix(in srgb,var(--gridui-brand-art) 3%,transparent);
28
+ }
29
+ }
30
+ .data-\[tone\=\'brand\'\]\:bg-brand-tint[data-tone='brand'] {
31
+ background-color: var(--gridui-brand-tint);
32
+ }
33
+ @media (width >= 40rem) {
34
+ .min-\[40rem\]\:min-h-40 {
35
+ min-height: calc(var(--spacing) * 40);
36
+ }
37
+ }
38
+ .\[\&_h1\]\:flex h1 {
39
+ display: flex;
40
+ }
41
+ .\[\&_h1\]\:items-center h1 {
42
+ align-items: center;
43
+ }
44
+ .\[\&_h1\]\:bg-background h1 {
45
+ background-color: var(--gridui-background);
46
+ }
47
+ .\[\&_h1\]\:p-gridui-24 h1 {
48
+ padding: var(--gridui-space-24);
49
+ }
50
+ @media (width >= 40rem) {
51
+ .min-\[40rem\]\:\[\&_h1\]\:px-gridui-48 h1 {
52
+ padding-inline: var(--gridui-space-48);
53
+ }
54
+ .min-\[40rem\]\:\[\&_h1\]\:py-gridui-32 h1 {
55
+ padding-block: var(--gridui-space-32);
56
+ }
57
+ }
58
+ .\[\&_svg\]\:h-19 svg {
59
+ height: calc(var(--spacing) * 19);
60
+ }
61
+ .\[\&_svg\]\:w-19 svg {
62
+ width: calc(var(--spacing) * 19);
63
+ }
64
+ @media (width >= 40rem) {
65
+ .min-\[40rem\]\:\[\&_svg\]\:h-28 svg {
66
+ height: calc(var(--spacing) * 28);
67
+ }
68
+ .min-\[40rem\]\:\[\&_svg\]\:w-28 svg {
69
+ width: calc(var(--spacing) * 28);
70
+ }
71
+ }
72
+ }
73
+ @layer components {
74
+ .gridui-heading-copy {
75
+ display: grid;
76
+ flex: 1;
77
+ }
78
+ .gridui-heading-artwork {
79
+ flex: 0 0 100px;
80
+ }
81
+ .gridui-content-panel {
82
+ padding: var(--gridui-panel-block) var(--gridui-panel-inline);
83
+ }
84
+ @media (min-width: 40rem) {
85
+ .gridui-heading-artwork {
86
+ flex-basis: 220px;
87
+ }
88
+ .gridui-content-panel {
89
+ padding: var(--gridui-panel-block-md) var(--gridui-panel-inline-md);
90
+ }
91
+ }
92
+ @media (min-width: 64rem) {
93
+ .gridui-content-panel {
94
+ padding: var(--gridui-panel-block-lg) var(--gridui-panel-inline-lg);
95
+ }
96
+ }
97
+ }
package/package.json CHANGED
@@ -1,6 +1,52 @@
1
1
  {
2
2
  "name": "@gridui/panel",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.0.0",
4
+ "description": "GridUI React panel",
5
+ "license": "UNLICENSED",
6
+ "type": "module",
7
+ "files": [
8
+ "dist",
9
+ "README.md"
10
+ ],
11
+ "sideEffects": [
12
+ "**/*.css"
13
+ ],
14
+ "exports": {
15
+ ".": {
16
+ "types": "./dist/index.d.ts",
17
+ "import": "./dist/index.js"
18
+ },
19
+ "./styles.css": "./dist/styles.css"
20
+ },
21
+ "publishConfig": {
22
+ "access": "public"
23
+ },
24
+ "peerDependencies": {
25
+ "react": "^19.2.0",
26
+ "react-dom": "^19.2.0"
27
+ },
28
+ "dependencies": {
29
+ "@gridui/grid": "^2.1.4",
30
+ "@gridui/style-utils": "^2.1.2",
31
+ "@gridui/theme": "^2.1.2",
32
+ "class-variance-authority": "0.7.1"
33
+ },
34
+ "devDependencies": {
35
+ "@gridui-internal/configuration": "0.0.0",
36
+ "@jest/globals": "30.5.2",
37
+ "@types/jest": "30.0.0",
38
+ "@types/node": "26.6.5",
39
+ "@types/react": "19.3.0",
40
+ "@types/react-dom": "19.3.0",
41
+ "jest": "30.5.2",
42
+ "react": "19.3.1",
43
+ "react-dom": "19.3.1",
44
+ "typescript": "6.0.3"
45
+ },
46
+ "scripts": {
47
+ "build": "node ../../scripts/compilation/package.ts",
48
+ "compile": "tsc --project tsconfig.json",
49
+ "test": "jest",
50
+ "coverage": "jest --coverage"
51
+ }
6
52
  }