@estiva-app/ui 0.19.0 → 0.20.0

package/dist/eslint/no-restyled-part.d.ts

@@ -0,0 +1,81 @@
+import type { Rule, Scope } from 'eslint';
+/**
+ * A part of the package is placed from outside, never restyled (UIG-9; Katerina's
+ * ruling B8 of 13 September, "only position and spacing pass into our
+ * components").
+ *
+ * Every part takes `className`, and some take a second class prop for an inner
+ * box (`contentClassName`, `bodyClassName`…). Through either, an app could push
+ * a colour, a text size or a border into a part and quietly undo it: the token
+ * lint only asks whether a class is a real token, never whether the part should
+ * take it. This rule reads every class passed into a part and lets through only
+ * placement — where the part sits and how much room it takes.
+ *
+ * **Which elements are parts: by where they come from, never by name.** No list
+ * of names is kept, so a part added to the package later is covered the day it
+ * is added.
+ *
+ * - In an app: anything imported from `@estiva-app/ui`, and anything imported
+ *   from the app's own files that is one of those — a re-export (Peek's
+ *   `components/ui/Button.tsx`), a wrapper that hands its props on to a part
+ *   (`{...rest}`), or a component that hands its own `className` on to a part
+ *   (Peek's `ConversationCard` into `Card`). Relative imports and the apps' `@/`
+ *   alias are followed; `@/` is the `src` folder beside the nearest
+ *   `package.json`.
+ * - Inside the package (Katerina, 17 September): a name `src/index.ts` exports,
+ *   imported from a sibling file or declared in the same file.
+ *
+ * **What it reads:** a string, a template, `cn()`/`clsx()` and their arguments,
+ * both sides of a condition, a `const` in the same file and the values of a
+ * class map read from one. A class the code works out while it runs passes: the
+ * rule cannot read it.
+ *
+ * `EmptyState` takes no padding either (Katerina's ruling 6 of 14 September):
+ * its room comes from the box its rows live in.
+ */
+/** Where a part sits and how much room it takes. Read on the utility, after its variants. */
+export declare const PLACEMENT: {
+    what: string;
+    pattern: RegExp;
+}[];
+/** A class list's variants and its utility: `sm:[&>*]:shrink-0` → `['sm', '[&>*]']`, `shrink-0`. */
+export declare function splitClass(token: string): {
+    variants: string[];
+    utility: string;
+};
+/** Whether a class only places the part. */
+export declare function isPlacement(token: string): boolean;
+/**
+ * The props a part has for how it looks, named in the message. Held to the
+ * package's source by `no-restyled-part.test.ts`: every prop here exists, and
+ * every look prop an exported part has is here. A part missing from this table
+ * has none, and the message says to ask for one.
+ */
+export declare const PART_LOOK_PROPS: Record<string, string[]>;
+interface Node {
+    type: string;
+    range: [number, number];
+    loc?: NonNullable<Rule.Node['loc']>;
+    parent?: Node;
+    [key: string]: unknown;
+}
+/**
+ * What a name is to this rule: the part it draws, and which of the caller's
+ * class props reach which of the part's (`all` for a part, a re-export or a
+ * wrapper; a map for a component that hands on its own `className`). `via` is
+ * the app's own component in between, for the message.
+ */
+export interface PartBinding {
+    part: string;
+    props: 'all' | Record<string, string>;
+    via?: string;
+}
+/**
+ * Every class the code spells out for a value, as far as it can be read in this
+ * file. `asMap` reads an object as a class map (its values) rather than as a
+ * `clsx` object (its keys).
+ */
+export declare function classesOf(value: Node | null | undefined, scopeOf: (node: Node) => Scope.Scope | null, asMap?: boolean, seen?: Set<Node>): string[];
+export declare const noRestyledPart: Rule.RuleModule;
+export {};
+//# sourceMappingURL=no-restyled-part.d.ts.map

package/dist/eslint/no-restyled-part.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-restyled-part.d.ts","sourceRoot":"","sources":["../../src/eslint/no-restyled-part.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAGzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,6FAA6F;AAC7F,eAAO,MAAM,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAUxD,CAAA;AASD,oGAAoG;AACpG,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAajF;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAIlD;AAOD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAgCpD,CAAA;AAOD,UAAU,IAAI;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvB,GAAG,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IACnC,MAAM,CAAC,EAAE,IAAI,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAwBD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AA8UD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,UAAQ,EAAE,IAAI,YAAkB,GAAG,MAAM,EAAE,CAqDtJ;AAOD,eAAO,MAAM,cAAc,EAAE,IAAI,CAAC,UAwEjC,CAAA"}