@marktiderman/genesis-cli 1.25.0 → 1.26.1
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 +8 -2
- package/dist/cli.js +146 -10
- package/dist/cli.js.map +1 -1
- package/dist/{config-CR4kqSCp.d.ts → config-ARs2YQ60.d.ts} +7 -0
- package/dist/doctor.d.ts +3 -3
- package/dist/doctor.js +136 -8
- package/dist/doctor.js.map +1 -1
- package/dist/expo.d.ts +2 -2
- package/dist/genesis-catalog.json +16 -16
- package/dist/index.d.ts +4 -1
- package/dist/index.js +137 -9
- package/dist/index.js.map +1 -1
- package/dist/starter/package.json +5 -5
- package/dist/vite.js +136 -8
- package/dist/vite.js.map +1 -1
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -806,7 +806,7 @@ Exit codes: `0` pass, `1` findings, `2` the doctor couldn't run (bad config, Gen
|
|
|
806
806
|
|
|
807
807
|
| Rule | Level | What it flags |
|
|
808
808
|
| --- | --- | --- |
|
|
809
|
-
| `local-primitives` | error | A local primitive folder (`src/components/ui` by default; `localPrimitiveDirs`). |
|
|
809
|
+
| `local-primitives` | error | A local primitive folder (`src/components/ui` by default; `localPrimitiveDirs`): where a shadcn starter copies the primitives Genesis already has. The app's own components live in any other folder. |
|
|
810
810
|
| `starter-leftover` | warn | `components.json` or `src/lib/utils.ts` from a shadcn starter. |
|
|
811
811
|
| `forbidden-import` | error | `@radix-ui/*`, local `components/ui/*` (alias or relative), `@/lib/utils`, plus your `forbiddenImports`. |
|
|
812
812
|
| `raw-tag` | error | A raw JSX tag Genesis has a component for: any of `button input textarea select label table dialog progress details summary` with a same-named Genesis export, plus `hr` → `Separator`. JSX files only; `rawTags` adds or removes mappings. |
|
|
@@ -826,6 +826,9 @@ Exit codes: `0` pass, `1` findings, `2` the doctor couldn't run (bad config, Gen
|
|
|
826
826
|
| `resource-view-tree` | error | A `<ResourceView>` or `<ResourcePage>` with `tree` and `pagination="server"` or `"cursor"` (bare or in braces). A tree is built from every row on the client, so the screen throws when it renders. Leave `pagination` unset. Only the tag's own attributes count, not a `tree` inside an expression. ([Tree mode](../../docs/RESOURCE-VIEW.md#tree-mode)) |
|
|
827
827
|
| `studio-server-auth-import` | warn | An import of a studio-server file the package doesn't export (`@marktiderman/genesis-studio-server/dist/…`, `/src/…`, `/lib/…`), or a CommonJS `require("@marktiderman/genesis-studio-server")` of the ESM-only root. Besides the doctor's scan it reads the app's `.cjs` and `.mjs` files (tests skipped), where a `require` usually is. Both fail at run time with `ERR_PACKAGE_PATH_NOT_EXPORTED`. Use `@marktiderman/genesis-studio-server/auth`: the token checks and `switchToUser`, for `import` and `require`. An ESM import of the root is fine. |
|
|
828
828
|
| `removed-scope-name` | error | A "practice" name genesis-core 2 removed, in a file that imports a Genesis package: a view field's `timeZone: "practice"` (a string value in a view definition), NativeResourceView's `practiceTimeZone`, `resolveZone("practice", …)`, or DisplayTimeZones' `practice`. `defineView` refuses the first when the view loads and the rest are type errors; this lists them in CI. `genesis codemod genesis-core-2-scope-names` rewrites every one. It reads only Genesis API usage, the same shapes the codemod rewrites (see its row above); comments and an app's own `practice` settings, props and `resolveZone` are skipped. |
|
|
829
|
+
| `app-part-name` | warn | An app element's own `data-slot` that doesn't start `app-`. An app style reaches an app's own part by name, so it is `app-<name>` and never matches a Genesis part; a name the installed design system's `THEME_PARTS` already uses is called out, since every app style's rules for that part would hit the app's element. Files inside an overlay of the component package are skipped (ADR 0018). |
|
|
830
|
+
| `app-part-colors` | warn | In a custom view (a file that renders `<CustomView>` or calls `useCustomView`) or a file with an app part (`data-slot="app-…"`): a colour property (`color`, `backgroundColor`, `borderColor`, `fill`, …) or a Tailwind colour utility with an arbitrary value (`bg-[var(--x)]`) that reads a custom property the theme stylesheets don't declare as a colour role. Take colours from roles (`hsl(var(--primary))`, `bg-primary`), so the app brand and dark mode reach the view. Literal colours stay `raw-color`'s (ADR 0019). |
|
|
831
|
+
| `custom-view-states` | warn | A custom view that draws its own loading, empty or error state: a `status === "loading"`, `"empty"` or `"error"` check in a file that renders `<CustomView>` or calls `useCustomView`. `<CustomView>` draws the three states in the app's style; its `loading`, `empty` and `error` props replace one (ADR 0019). |
|
|
829
832
|
| `deprecated-import` | warn | A named import of a Genesis export tagged `@deprecated` (or `@stability Deprecated`) in its published declarations. It goes at the next major; the message carries the tag's advice. Ratcheted by default: under `--base`, files that didn't change report it as `info`, so an upgrade never fails strict CI on untouched files. |
|
|
830
833
|
| `beta-import` | info | A named import of an export tagged `@stability Beta` or `Experimental`, which may still change in a minor. Info by default since most of Genesis is beta; set it to `warn` in `rules` to see it in CI. |
|
|
831
834
|
| `figma-routes` | info | Runs only when genesis.config.json has a `figma` block: [genesis figma:routes](#genesis-figmaroutes) as findings. A configured page the file doesn't have, a route with no frame, navigation with no hotspot and a `// figma:` id that isn't the route's frame are `info`, `warn` under `--strict`; frames with no route, hotspots to them and navigation that isn't a string literal are always `info`, by design. Never `error`. Invalid JSON or a bad `figma` block in genesis.config.json is one `warn` naming the file. Without `FIGMA_ACCESS_TOKEN`, or when the API can't be read or doesn't answer within 30 seconds, one `info` notice. The Vite plugin and `genesis upgrade` skip it (it reads the network). |
|
|
@@ -1093,7 +1096,7 @@ its import, the rule that enforces it and the docs: a short static core plus eve
|
|
|
1093
1096
|
package's declarations. `genesis agents` writes the same catalog as
|
|
1094
1097
|
`.claude/skills/genesis/SKILL.md` and a `<!-- genesis-primitives:start -->` block in the app's
|
|
1095
1098
|
AGENTS.md (the rest of the file is the app's), telling agents to use the primitives first, never
|
|
1096
|
-
copy an older screen, and
|
|
1099
|
+
copy an older screen, extend a close Genesis piece rather than build beside it, and invent in the app when nothing fits. `genesis agents --check`
|
|
1097
1100
|
writes nothing and fails when either is out of date, and the doctor's `agent-guide-stale` warns.
|
|
1098
1101
|
Both commands, and `genesis catalog`, exit 1 when a package's declaration doesn't validate,
|
|
1099
1102
|
since the catalog would leave it out. Run `genesis agents` after each Genesis upgrade.
|
|
@@ -1461,6 +1464,9 @@ What an app needed from Genesis and didn't find goes in `docs/genesis-upstream.m
|
|
|
1461
1464
|
| --- | --- | --- | --- | --- | --- | --- |
|
|
1462
1465
|
| kanban-swimlanes | extension | candidate | data-views | @marktiderman/genesis-ui | src/components/lanes.tsx | Swimlanes on KanbanBoard |
|
|
1463
1466
|
|
|
1467
|
+
An entry is a recommendation, never a request for permission: the app builds what it needs first
|
|
1468
|
+
(FRAMEWORK G3) and adds an entry when it thinks Genesis should have it.
|
|
1469
|
+
|
|
1464
1470
|
`kind` is `gap` (nothing in Genesis), `extension` (a part with no prop, variant or slot for it)
|
|
1465
1471
|
or `invention` (the app built it). `status` is `candidate`, `proposed`, `promoted` or `declined`.
|
|
1466
1472
|
`local` is the app's own code for it: repo-relative paths, separated by `, ` (a comma and a space)
|
package/dist/cli.js
CHANGED
|
@@ -1583,7 +1583,9 @@ function loadGenesis(root, config) {
|
|
|
1583
1583
|
const { dir: uiDir, exports: exportNames, values, components } = pkg;
|
|
1584
1584
|
const tokens = /* @__PURE__ */ new Set();
|
|
1585
1585
|
const themeFiles = resolveThemeFiles(root, config, uiDir);
|
|
1586
|
-
|
|
1586
|
+
const themeCss = themeFiles.map((file) => readFileSync(file, "utf8"));
|
|
1587
|
+
for (const css of themeCss) for (const t of declaredTokens(css)) tokens.add(t);
|
|
1588
|
+
const colorTokens = colorRoles(themeCss);
|
|
1587
1589
|
const byLower = new Map(components.map((c) => [c.toLowerCase(), c]));
|
|
1588
1590
|
const rawTags = /* @__PURE__ */ new Map();
|
|
1589
1591
|
for (const tag of TAGS) if (byLower.has(tag)) rawTags.set(tag, byLower.get(tag));
|
|
@@ -1599,6 +1601,8 @@ function loadGenesis(root, config) {
|
|
|
1599
1601
|
values,
|
|
1600
1602
|
components,
|
|
1601
1603
|
tokens,
|
|
1604
|
+
colorTokens,
|
|
1605
|
+
...themeParts(root) ? { themeParts: themeParts(root) } : {},
|
|
1602
1606
|
rawTags,
|
|
1603
1607
|
palette: loadPalette(root),
|
|
1604
1608
|
companions: loadCompanions(root, config, uiPackage)
|
|
@@ -1698,6 +1702,47 @@ function parseExportNames(dts) {
|
|
|
1698
1702
|
}
|
|
1699
1703
|
return names;
|
|
1700
1704
|
}
|
|
1705
|
+
function colorRoles(sheets) {
|
|
1706
|
+
const declared = /* @__PURE__ */ new Map();
|
|
1707
|
+
for (const css of sheets) {
|
|
1708
|
+
for (const m of css.matchAll(/(--[A-Za-z0-9_-]+)\s*:\s*([^;{}]+);/g)) {
|
|
1709
|
+
const list = declared.get(m[1]) ?? [];
|
|
1710
|
+
list.push(m[2].trim());
|
|
1711
|
+
declared.set(m[1], list);
|
|
1712
|
+
}
|
|
1713
|
+
}
|
|
1714
|
+
const roles = /* @__PURE__ */ new Set();
|
|
1715
|
+
for (const [name, values] of declared) if (values.some((v) => COLOUR_VALUE.test(v))) roles.add(name);
|
|
1716
|
+
for (let pass = 0; pass < 4; pass++) {
|
|
1717
|
+
for (const [name, values] of declared) {
|
|
1718
|
+
if (roles.has(name)) continue;
|
|
1719
|
+
if (values.some((v) => [...v.matchAll(/var\(\s*(--[A-Za-z0-9_-]+)/g)].some((r) => roles.has(r[1])))) roles.add(name);
|
|
1720
|
+
}
|
|
1721
|
+
}
|
|
1722
|
+
return roles;
|
|
1723
|
+
}
|
|
1724
|
+
function themeParts(root) {
|
|
1725
|
+
const ds = findPackageDir(root, DESIGN_SYSTEM_PACKAGE);
|
|
1726
|
+
if (!ds) return null;
|
|
1727
|
+
if (partsCache.has(ds)) return partsCache.get(ds);
|
|
1728
|
+
let found = null;
|
|
1729
|
+
const dist = path30.join(ds, "dist");
|
|
1730
|
+
try {
|
|
1731
|
+
for (const name of existsSync(dist) ? readdirSync(dist) : []) {
|
|
1732
|
+
if (!name.endsWith(".js")) continue;
|
|
1733
|
+
const code = readFileSync(path30.join(dist, name), "utf8");
|
|
1734
|
+
const at = code.indexOf("THEME_PARTS = Object.freeze([");
|
|
1735
|
+
if (at === -1) continue;
|
|
1736
|
+
const body = code.slice(at, code.indexOf("]);", at));
|
|
1737
|
+
found = [...body.matchAll(/\bp\(\s*"([a-z][a-z0-9-]*)"/g)].map((m) => m[1]);
|
|
1738
|
+
break;
|
|
1739
|
+
}
|
|
1740
|
+
} catch {
|
|
1741
|
+
found = null;
|
|
1742
|
+
}
|
|
1743
|
+
partsCache.set(ds, found);
|
|
1744
|
+
return found;
|
|
1745
|
+
}
|
|
1701
1746
|
function declaredTokens(css) {
|
|
1702
1747
|
return [...css.matchAll(/(--[A-Za-z0-9_-]+)\s*:/g)].map((m) => m[1]);
|
|
1703
1748
|
}
|
|
@@ -1837,7 +1882,7 @@ function loadPalette(root) {
|
|
|
1837
1882
|
}
|
|
1838
1883
|
return [...names].sort();
|
|
1839
1884
|
}
|
|
1840
|
-
var DEFAULT_UI_PACKAGE, NATIVE_UI_PACKAGE, DESIGN_SYSTEM_PACKAGE, DEFAULT_COMPONENT_PACKAGES, TAGS, TAG_ALIASES, NON_COMPONENT_SUFFIX, TAILWIND_PALETTE, TS_SOURCE, isTsSource;
|
|
1885
|
+
var DEFAULT_UI_PACKAGE, NATIVE_UI_PACKAGE, DESIGN_SYSTEM_PACKAGE, DEFAULT_COMPONENT_PACKAGES, TAGS, TAG_ALIASES, NON_COMPONENT_SUFFIX, TAILWIND_PALETTE, COLOUR_VALUE, partsCache, TS_SOURCE, isTsSource;
|
|
1841
1886
|
var init_genesis = __esm({
|
|
1842
1887
|
"src/doctor/genesis.ts"() {
|
|
1843
1888
|
init_pm();
|
|
@@ -1879,6 +1924,8 @@ var init_genesis = __esm({
|
|
|
1879
1924
|
"mist",
|
|
1880
1925
|
"olive"
|
|
1881
1926
|
];
|
|
1927
|
+
COLOUR_VALUE = /^(?:-?[\d.]+(?:deg)?\s+[\d.]+%\s+[\d.]+%(?:\s*\/\s*[\d.]+%?)?|#[0-9a-f]{3,8}|(?:hsla?|rgba?|oklch|oklab|lab|lch|color)\(.*\))$/i;
|
|
1928
|
+
partsCache = /* @__PURE__ */ new Map();
|
|
1882
1929
|
TS_SOURCE = /\.(?:[cm]?tsx?)$/;
|
|
1883
1930
|
isTsSource = (v) => typeof v === "string" && TS_SOURCE.test(v) && !/\.d\.[cm]?ts$/.test(v);
|
|
1884
1931
|
}
|
|
@@ -3288,7 +3335,7 @@ var init_comments = __esm({
|
|
|
3288
3335
|
"src/introspect/comments.ts"() {
|
|
3289
3336
|
MARKER = "@genesis";
|
|
3290
3337
|
TABLE_KEYS = { label: "string", labelField: "string", description: "string", noun: "string", nounPlural: "string", key: "key" };
|
|
3291
|
-
FIELD_KEYS = { label: "string", description: "string", widget: "string", readonly: "boolean", sensitive: "boolean" };
|
|
3338
|
+
FIELD_KEYS = { label: "string", description: "string", control: "string", widget: "string", readonly: "boolean", sensitive: "boolean" };
|
|
3292
3339
|
CommentSettingsError = class extends Error {
|
|
3293
3340
|
};
|
|
3294
3341
|
}
|
|
@@ -3647,7 +3694,8 @@ function field(column, indent) {
|
|
|
3647
3694
|
const description = column.settings?.description ?? column.description;
|
|
3648
3695
|
if (label) parts.push(`label: ${quote(label)}`);
|
|
3649
3696
|
if (description) parts.push(`description: ${quote(description)}`);
|
|
3650
|
-
if (column.settings?.
|
|
3697
|
+
if (column.settings?.control) parts.push(`control: ${quote(column.settings.control)}`);
|
|
3698
|
+
else if (column.settings?.widget) parts.push(`widget: ${quote(column.settings.widget)}`);
|
|
3651
3699
|
if (column.settings?.readonly) parts.push("readOnly: true");
|
|
3652
3700
|
if (column.settings?.sensitive) parts.push("sensitive: true");
|
|
3653
3701
|
return `${indent}{ ${parts.join(", ")} },`;
|
|
@@ -4069,7 +4117,7 @@ function checkProjectLayout(ctx) {
|
|
|
4069
4117
|
rule: "local-primitives",
|
|
4070
4118
|
file: dir,
|
|
4071
4119
|
subject: dir,
|
|
4072
|
-
message: `is a local design-system primitive folder; use ${ctx.genesis.uiPackage}
|
|
4120
|
+
message: `is a local design-system primitive folder; use ${ctx.genesis.uiPackage} for those, and keep the app's own components in another folder`
|
|
4073
4121
|
});
|
|
4074
4122
|
}
|
|
4075
4123
|
}
|
|
@@ -4295,7 +4343,11 @@ var init_rules = __esm({
|
|
|
4295
4343
|
// an app whose database files live in another app (database.ts)
|
|
4296
4344
|
"database-elsewhere",
|
|
4297
4345
|
// the app's eslint config loads Genesis's lint rules (eslint-config.ts)
|
|
4298
|
-
"genesis-eslint-config"
|
|
4346
|
+
"genesis-eslint-config",
|
|
4347
|
+
// custom views and app parts (custom-views.ts)
|
|
4348
|
+
"app-part-colors",
|
|
4349
|
+
"app-part-name",
|
|
4350
|
+
"custom-view-states"
|
|
4299
4351
|
];
|
|
4300
4352
|
DEFAULT_LOCAL_PRIMITIVE_DIRS = ["src/components/ui"];
|
|
4301
4353
|
STARTER_LEFTOVERS = ["components.json", "src/lib/utils.ts"];
|
|
@@ -8055,6 +8107,80 @@ var init_api_usage = __esm({
|
|
|
8055
8107
|
};
|
|
8056
8108
|
}
|
|
8057
8109
|
});
|
|
8110
|
+
|
|
8111
|
+
// src/doctor/custom-views.ts
|
|
8112
|
+
function checkAppParts(ctx) {
|
|
8113
|
+
const roles = ctx.genesis.colorTokens;
|
|
8114
|
+
const genesisParts = new Set(ctx.genesis.themeParts ?? []);
|
|
8115
|
+
const overlays = markedOverlays(ctx);
|
|
8116
|
+
for (const file of ctx.files) {
|
|
8117
|
+
if (!JSX_EXTS4.has(file.ext) && file.ext !== ".ts" && file.ext !== ".js") continue;
|
|
8118
|
+
if (insideOverlayOf(overlays, file, ctx.genesis.uiPackage)) continue;
|
|
8119
|
+
const code = file.code;
|
|
8120
|
+
if (JSX_EXTS4.has(file.ext)) {
|
|
8121
|
+
for (const m of code.matchAll(/\bdata-slot\s*=\s*(?:\{\s*)?["'`]([^"'`$]+)["'`]/g)) {
|
|
8122
|
+
const name = m[1];
|
|
8123
|
+
if (name.startsWith("app-")) continue;
|
|
8124
|
+
const clash = genesisParts.has(name);
|
|
8125
|
+
ctx.report({
|
|
8126
|
+
rule: "app-part-name",
|
|
8127
|
+
level: "warn",
|
|
8128
|
+
file: file.path,
|
|
8129
|
+
line: lineAt(code, m.index ?? 0),
|
|
8130
|
+
subject: name,
|
|
8131
|
+
message: clash ? `marks an app element data-slot="${name}", which is a Genesis part (THEME_PARTS): every app style's rules for it would hit this element too. Name the app's own part "app-${name}"` : `marks an app element data-slot="${name}"; name the app's own part "app-${name}", so it never collides with a Genesis part (docs/adr/0018-app-brands-styles-themes.md)`
|
|
8132
|
+
});
|
|
8133
|
+
}
|
|
8134
|
+
}
|
|
8135
|
+
if (roles && roles.size && (CUSTOM_VIEW.test(code) || APP_PART.test(code))) {
|
|
8136
|
+
const seen = /* @__PURE__ */ new Set();
|
|
8137
|
+
const check = (value, at) => {
|
|
8138
|
+
for (const v of value.matchAll(VARIABLE)) {
|
|
8139
|
+
const name = v[1];
|
|
8140
|
+
if (roles.has(name)) continue;
|
|
8141
|
+
const line = lineAt(code, at);
|
|
8142
|
+
if (seen.has(`${line}:${name}`)) continue;
|
|
8143
|
+
seen.add(`${line}:${name}`);
|
|
8144
|
+
ctx.report({
|
|
8145
|
+
rule: "app-part-colors",
|
|
8146
|
+
level: "warn",
|
|
8147
|
+
file: file.path,
|
|
8148
|
+
line,
|
|
8149
|
+
subject: name,
|
|
8150
|
+
message: `colours a custom view or app part with ${name}, which isn't a colour role; take colours from roles only (hsl(var(--primary)), bg-primary, text-muted-foreground) so the app brand and dark mode reach it`
|
|
8151
|
+
});
|
|
8152
|
+
}
|
|
8153
|
+
};
|
|
8154
|
+
for (const m of code.matchAll(COLOUR_KEY)) check(m[3], m.index ?? 0);
|
|
8155
|
+
for (const m of code.matchAll(COLOUR_UTILITY)) check(m[1], m.index ?? 0);
|
|
8156
|
+
}
|
|
8157
|
+
if (JSX_EXTS4.has(file.ext) && CUSTOM_VIEW.test(code)) {
|
|
8158
|
+
for (const m of code.matchAll(/\bstatus\s*[!=]={1,2}\s*["'`](loading|empty|error)["'`]/g)) {
|
|
8159
|
+
ctx.report({
|
|
8160
|
+
rule: "custom-view-states",
|
|
8161
|
+
level: "warn",
|
|
8162
|
+
file: file.path,
|
|
8163
|
+
line: lineAt(code, m.index ?? 0),
|
|
8164
|
+
subject: m[1],
|
|
8165
|
+
message: `draws a custom view's own ${m[1]} state; <CustomView> draws loading, empty and error in the app's style (pass its loading, empty or error prop to replace one) (docs/adr/0019-custom-views.md)`
|
|
8166
|
+
});
|
|
8167
|
+
}
|
|
8168
|
+
}
|
|
8169
|
+
}
|
|
8170
|
+
}
|
|
8171
|
+
var JSX_EXTS4, CUSTOM_VIEW, APP_PART, COLOUR_KEY, COLOUR_UTILITY, VARIABLE;
|
|
8172
|
+
var init_custom_views = __esm({
|
|
8173
|
+
"src/doctor/custom-views.ts"() {
|
|
8174
|
+
init_scan();
|
|
8175
|
+
init_overlays();
|
|
8176
|
+
JSX_EXTS4 = /* @__PURE__ */ new Set([".tsx", ".jsx"]);
|
|
8177
|
+
CUSTOM_VIEW = /<CustomView\b|\buseCustomView\s*[<(]/;
|
|
8178
|
+
APP_PART = /data-slot\s*=\s*\{?\s*["'`]app-/;
|
|
8179
|
+
COLOUR_KEY = /\b(color|background(?:Color)?|border(?:Top|Right|Bottom|Left|Block|Inline)?(?:Color)?|outline(?:Color)?|textDecorationColor|caretColor|accentColor|fill|stroke|columnRuleColor|boxShadow)\s*:\s*(["'`])([^"'`]*)\2/g;
|
|
8180
|
+
COLOUR_UTILITY = /(?<![\w-])(?:bg|text|border(?:-[xytrbls])?|ring|ring-offset|fill|stroke|from|to|via|outline|divide|decoration|shadow|accent|caret|placeholder)-\[([^\]]*var\(--[^\]]*)\]/g;
|
|
8181
|
+
VARIABLE = /var\(\s*(--[A-Za-z0-9_-]+)/g;
|
|
8182
|
+
}
|
|
8183
|
+
});
|
|
8058
8184
|
function specifierParts(spec) {
|
|
8059
8185
|
return spec.trim().replace(/^type\s+/, "").split(/\s+as\s+/).map((part) => part.trim());
|
|
8060
8186
|
}
|
|
@@ -8753,7 +8879,7 @@ var init_primitives = __esm({
|
|
|
8753
8879
|
CORE = [
|
|
8754
8880
|
{
|
|
8755
8881
|
need: "anything, before building it",
|
|
8756
|
-
use: 'search what exists: `genesis features find <term>`, this catalog, and the "Available but unused" list in `genesis doctor --verbose`',
|
|
8882
|
+
use: 'search what exists: `genesis features find <term>`, this catalog, and the "Available but unused" list in `genesis doctor --verbose`. Check the install is current first (`genesis upgrade --dry-run`): an old one hides pieces that exist',
|
|
8757
8883
|
docs: `${GENESIS_DOCS}/FRAMEWORK.md`,
|
|
8758
8884
|
from: "genesis-cli"
|
|
8759
8885
|
},
|
|
@@ -8778,9 +8904,15 @@ var init_primitives = __esm({
|
|
|
8778
8904
|
rule: "raw-color",
|
|
8779
8905
|
from: "genesis-cli"
|
|
8780
8906
|
},
|
|
8907
|
+
{
|
|
8908
|
+
need: "a Genesis piece that is close but doesn't quite fit",
|
|
8909
|
+
use: "extend it: a prop, a variant, a slot, or your own component that wraps it; never a parallel copy beside it",
|
|
8910
|
+
docs: `${GENESIS_DOCS}/FRAMEWORK.md`,
|
|
8911
|
+
from: "genesis-cli"
|
|
8912
|
+
},
|
|
8781
8913
|
{
|
|
8782
8914
|
need: "something no primitive covers",
|
|
8783
|
-
use: "
|
|
8915
|
+
use: "invent it in the app, on Genesis tokens and primitives; Genesis asks for no write-up first. You may add it to `docs/genesis-upstream.md` (`genesis upstream`) if you think Genesis should have it",
|
|
8784
8916
|
docs: `${GENESIS_DOCS}/FRAMEWORK.md`,
|
|
8785
8917
|
from: "genesis-cli"
|
|
8786
8918
|
}
|
|
@@ -8792,10 +8924,12 @@ var init_primitives = __esm({
|
|
|
8792
8924
|
AGENTS_END = "<!-- genesis-primitives:end -->";
|
|
8793
8925
|
RULES = [
|
|
8794
8926
|
`Use the Genesis primitive for the need first: reuse, then extend, then invent (G1 to G6 in ${GENESIS_DOCS}/FRAMEWORK.md).`,
|
|
8927
|
+
"Before deciding Genesis lacks a piece, look at all of it (the catalog below, `genesis features find <term>`) and check the installed packages are current (`genesis upgrade --dry-run`). An old install hides pieces that exist; upgrade before building around a gap that is already closed.",
|
|
8795
8928
|
"Never copy an older screen as a template. Old screens predate the primitives; the doctor flags what they did.",
|
|
8796
8929
|
"A list screen is a view (`defineView`) rendered by `ResourceView`; a record view is `RecordView`; on the phone, `NativeResourceView`.",
|
|
8797
8930
|
"Screens never call the database client (`supabase.from`, `.rpc`) directly: reads go through a view or a named data function, writes through the resource's provider rules.",
|
|
8798
|
-
"When
|
|
8931
|
+
"When a Genesis piece is close and does the same job, extend it: a prop, a variant, a slot, or your own component that wraps it. Never build a parallel copy beside it.",
|
|
8932
|
+
"When no Genesis piece does the job, invent it in the app: your own screens and components, on Genesis tokens and primitives. Genesis asks for no write-up or approval first (your app's own design review still applies); you may add it to `docs/genesis-upstream.md` if you think Genesis should have it.",
|
|
8799
8933
|
"Run `genesis doctor` before you finish; it enforces these rules."
|
|
8800
8934
|
];
|
|
8801
8935
|
GUIDE_SEARCH_LEVELS = 4;
|
|
@@ -10052,6 +10186,7 @@ function builtinChecks(config, options = {}) {
|
|
|
10052
10186
|
{ name: "resource-view-trees", check: checkTreeViews },
|
|
10053
10187
|
{ name: "studio-server-imports", check: checkStudioServerImports },
|
|
10054
10188
|
{ name: "removed-scope-names", check: checkRemovedScopeNames },
|
|
10189
|
+
{ name: "app-parts", check: checkAppParts },
|
|
10055
10190
|
{ name: "stability-imports", check: checkStabilityImports },
|
|
10056
10191
|
{ name: "agent-guide", check: (ctx) => {
|
|
10057
10192
|
checkAgentGuide(ctx);
|
|
@@ -10175,6 +10310,7 @@ var init_doctor = __esm({
|
|
|
10175
10310
|
init_structure();
|
|
10176
10311
|
init_dates();
|
|
10177
10312
|
init_api_usage();
|
|
10313
|
+
init_custom_views();
|
|
10178
10314
|
init_stability();
|
|
10179
10315
|
init_package_rules();
|
|
10180
10316
|
init_ratchet();
|
|
@@ -10996,7 +11132,7 @@ var init_init = __esm({
|
|
|
10996
11132
|
"@tanstack/react-virtual@^3.14",
|
|
10997
11133
|
"react-hook-form@^7",
|
|
10998
11134
|
"zod@^4",
|
|
10999
|
-
"@hookform/resolvers@>=5.1.0 <
|
|
11135
|
+
"@hookform/resolvers@>=5.1.0 <8"
|
|
11000
11136
|
];
|
|
11001
11137
|
ROLE = /^[a-z_][a-z0-9_]{0,62}$/;
|
|
11002
11138
|
LOVABLE_CLIENT = "src/integrations/supabase/client.ts";
|