@rebasepro/app 0.19.1 → 0.19.2-canary.g09316f6

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,10 +1,13 @@
1
1
  /**
2
2
  * UIReferenceView — hidden debug route at /debug/ui
3
3
  *
4
- * This file is a STATIC reference of the real UI patterns used across the app.
5
- * Markup / styles are copied from source files where a section mirrors a real
6
- * screen. DO NOT add invented styles copy from actual source files, or from
7
- * the components in @rebasepro/ui.
4
+ * The design source of truth for the kit, in two halves. The SYSTEM chapters
5
+ * (principles, surfaces, colour, typography, shape and space, depth and icons,
6
+ * cards and data`./ui-reference/SystemSections.tsx`) show the decisions in
7
+ * `theme.css`, `styles.ts` and `DESIGN.md` with the kit's own components. The
8
+ * ELEMENT chapters below mirror real screens: markup and classes are copied
9
+ * from the source files they name. DO NOT add invented styles here — copy from
10
+ * the actual component, or compose kit components.
8
11
  *
9
12
  * Sections named after a component mirror that component. Sections named after
10
13
  * a pattern (e.g. "Management Screen", "Form Dialog") are illustrative
@@ -13,8 +16,9 @@
13
16
  * Do not cite source line numbers here — they rot silently. Name the file only.
14
17
  *
15
18
  * Sources:
19
+ * theme.css, styles.ts, DESIGN.md, docs/design/instatic-distilled.html,
16
20
  * DefaultDrawer.tsx, DefaultAppBar.tsx, DrawerNavigationItem.tsx,
17
- * DrawerNavigationGroup.tsx
21
+ * DrawerNavigationGroup.tsx, FieldBlock.tsx
18
22
  */
19
23
  import React from "react";
20
24
  export declare function UIReferenceView(): React.JSX.Element;
@@ -0,0 +1,30 @@
1
+ import React from "react";
2
+ /**
3
+ * One chapter of the UI reference page.
4
+ *
5
+ * `max-w-5xl` and `border-b` cannot share an element here. Several mocks are
6
+ * app-scale and intrinsically wider than 64rem (the CRM dashboard reaches
7
+ * 1483px), so a section's own rule used to stop at 1264px while its content
8
+ * ran past it, and every such section read as a broken edge.
9
+ *
10
+ * Split instead: the SECTION spans the column, so its rule always reaches its
11
+ * own edges; the CONTENT keeps a measure, so a form column never stretches to
12
+ * 700px on a wide monitor. `wide` opts the app-scale mocks out of the measure;
13
+ * they pair it with `overflow-x-auto` so they scroll inside themselves rather
14
+ * than pushing the page.
15
+ */
16
+ export declare function SectionBlock({ id, title, wide, children }: {
17
+ id: string;
18
+ title: string;
19
+ wide?: boolean;
20
+ children: React.ReactNode;
21
+ }): React.JSX.Element;
22
+ /** The small monospace caption this page uses to name a specimen. */
23
+ export declare function SpecimenLabel({ children, className }: {
24
+ children: React.ReactNode;
25
+ className?: string;
26
+ }): React.JSX.Element;
27
+ /** A 6px hue dot: the product's status vocabulary. `className` carries the hue. */
28
+ export declare function Dot({ className }: {
29
+ className: string;
30
+ }): React.JSX.Element;
@@ -0,0 +1,17 @@
1
+ /**
2
+ * The system chapters of the UI reference: the decisions behind the kit,
3
+ * shown with the kit's own components. Sources: `packages/ui/src/theme.css`,
4
+ * `packages/ui/src/styles.ts`, `packages/ui/DESIGN.md`, and the reference the
5
+ * ladder was measured against, `docs/design/instatic-distilled.html`.
6
+ *
7
+ * Nothing here is invented markup: every specimen is a `@rebasepro/ui`
8
+ * component or a role token from `theme.css`. The Tailwind palette hues
9
+ * (`bg-green-500` and friends) appear only as dots and icons, which is the
10
+ * rule this page exists to show.
11
+ */
12
+ import React from "react";
13
+ export declare function PrinciplesSection(): React.JSX.Element;
14
+ export declare function ColourSection(): React.JSX.Element;
15
+ export declare function ShapeSpaceSection(): React.JSX.Element;
16
+ export declare function DepthIconsSection(): React.JSX.Element;
17
+ export declare function CardsDataSection(): React.JSX.Element;