@apliteni/apliteni-ui 0.49.0 → 0.49.2

package/README.md

@@ -224,6 +224,12 @@ the repository root. Start Storybook with `npm run storybook`. For React, use `n
 storybook -w react`. Before opening a PR, run `npm test`, `npm test -w react`, `npm run
 build-storybook`, and `node site/build.mjs`.
 
+Add a general, composable kit component only when all three checks are true:
+(1) the issue names at least two products that use it or have requested it;
+(2) existing components cannot provide it without copying their markup or logic;
+(3) it contains no domain-specific data or rules. Otherwise, build the UI by
+composition and add a Storybook showcase. Keep the vanilla kit’s existing look.
+
 To add a component, put its token-based CSS in `src/styles/`. Include it in
 `src/index.css` and in both the `styles` map and `cssText` in `src/inline.js`. Add the
 HTML factory under `src/components/`, export it from `src/index.js`, and add a

package/guidelines/text-length.md

@@ -0,0 +1,53 @@
+# Text length
+
+## Keep controls short
+
+<!-- rule: short-controls -->
+
+**Rule:** Labels, buttons, badges and status text name the field, action or state in a few words.
+
+**Do:** “Save invoice.”
+
+**Don't:** “Click here to save your invoice.”
+
+## Explain data in captions
+
+<!-- rule: useful-captions -->
+
+**Rule:** Use one sentence for needed units, dates or limits.
+
+**Do:** “March revenue in EUR, excluding refunds.”
+
+**Don't:** “An overview of your revenue.”
+
+## Use introductions only when needed
+
+<!-- rule: useful-introductions -->
+
+**Rule:** Add a short introduction only for a purpose or step the title and controls leave unclear.
+
+**Do:** “Upload a CSV with invoice numbers, dates and amounts.”
+
+**Don't:** “Manage your invoices here.”
+
+## Explain consequences in callouts
+
+<!-- rule: useful-callouts -->
+
+**Rule:** Explain a consequence or next step in one or two sentences.
+
+**Do:** “Deleting this workspace deletes its reports. Export them first.”
+
+**Don't:** “Think carefully before proceeding.”
+
+**Except:** Keep needed safety, consent and legal details visible, however long. Link to optional background.
+
+## Cut filler
+
+<!-- rule: remove-filler -->
+
+**Rule:** Cut text readers can decide and finish without.
+
+**Do:** “Exports include only filtered rows.”
+
+**Don't:** “Export quickly and easily.”

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apliteni/apliteni-ui",
-  "version": "0.49.0",
+  "version": "0.49.2",
   "workspaces": [
     "react"
   ],