@lotics/cli 0.144.0 → 0.145.0

package/dist/src/cli.js

@@ -46405,6 +46405,36 @@ import { LoticsLocaleProvider, vi } from "@lotics/ui/locale";
 import { mount } from "@lotics/app-sdk";
 import App from "./App";
 
+// THIS APP LOOKS LIKE LOTICS unless you say otherwise, which is the right
+// default: the kit's own palette and typeface are what every screen in the
+// product wears, and an app that sets nothing belongs with them.
+//
+// If this app carries someone else's brand \u2014 a customer's typeface, their one
+// colour \u2014 \`applyLoticsTheme\` is the escape hatch. Call it ONCE, here, before
+// \`mount\`, so the variables are in place for the first paint:
+//
+//   import { applyLoticsTheme } from "@lotics/ui/theme";
+//   applyLoticsTheme({ primary: "#0F766E" });
+//
+// It is ADDITIVE \u2014 set what you own and every other role keeps the kit's value,
+// rather than resetting to some second set of defaults:
+//
+//   accent      which of these \u2014 a selected row, an active filter
+//   primary     this is on \u2014 the filled button, a checkbox, an active tab's rail
+//   background  the raised surface (Card, Drawer, Modal); leave white unless you
+//               deliberately want a toned surface
+//   border      hairlines \u2014 a register is mostly these, so a small change here is
+//               felt against the whole screen
+//   bodyFont    the typeface for everything (a CSS stack you know RESOLVES, and
+//               that carries Vietnamese diacritics \u2014 a face without them turns
+//               "Th\u1EA9m \u0111\u1ECBnh" into tofu). Declare its @font-face in your own CSS.
+//   displayFont display type only; defaults to bodyFont
+//
+// Prefer it over declaring \`--lotics-*\` in your own stylesheet: two of those
+// values are DERIVED and fail quietly by hand \u2014 the selection wash is the accent
+// at 7%, and one bodyFont has to reach all three weight rungs or medium and
+// semibold stay in the kit's face and the screen reads as a font that half-loaded.
+//
 // PortalHost is the render target for @lotics/ui overlays (Popover, Tooltip,
 // Dialog). Without it, Portal renders nothing \u2014 keep it wrapping the app.
 //

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.144.0",
+  "version": "0.145.0",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {