@consciousclouds/tokens 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog — @consciousclouds/tokens
+
+Versioned on the independent frontend-SDK lifecycle (NOT `contract_version`).
+
+## [0.1.0] — 2026-07-04
+
+### Added
+
+- **Token vocabulary** (Frontend Platform Layer 1): the semantic role names —
+  surface/content/interactive/status roles plus radius, spacing, and typography
+  scales — as TypeScript types and CSS custom properties. Roles are the only
+  vocabulary upper layers may consume; raw values never leak upward.
+- **House theme CSS** (`styles/`): the default light/dark theme expressed as
+  values for the token roles (Tailwind v4 `@theme` compatible).
+- **`ThemeProvider` / mode handling** over `next-themes` — light/dark/system,
+  no flash of wrong mode.
+
+### Notes
+
+- Brands restyle by overriding token *values* (see `@consciousclouds/brand`
+  `tokenOverrides`), never by introducing new role names.
+- Prepared-publishable per the assistant-surface packaging template; publish
+  order when the gate opens: conductor-sdk → conductor-react → operator-shell
+  (tokens/ui/brand have no workspace deps and may go first in any order).

package/LICENSE

@@ -0,0 +1,171 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship made available under
+      the License, as indicated by a copyright notice that is included in
+      or attached to the work (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean, as submitted to the Licensor for inclusion
+      in the Work by the copyright owner or by an individual or Legal Entity
+      authorized to submit on behalf of the copyright owner. For the purposes
+      of this definition, "submitted" means any form of electronic, verbal,
+      or written communication sent to the Licensor or its representatives,
+      including but not limited to communication on electronic mailing lists,
+      source code control systems, and issue tracking systems that are managed
+      by, or on behalf of, the Licensor for the purpose of discussing and
+      improving the Work, but excluding communication that is conspicuously
+      marked or designated in writing by the copyright owner as "Not a
+      Contribution."
+
+      "Contributor" shall mean Licensor and any Legal Entity on behalf of
+      whom a Contribution has been received by the Licensor and included
+      within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by the combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a cross-claim
+      or counterclaim in a lawsuit) alleging that the Work or any
+      Contribution embodied within the Work constitutes direct or contributory
+      patent infringement, then any patent licenses granted to You under
+      this License for that Work shall terminate as of the date such
+      litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative Works
+          a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works that
+          You distribute, all copyright, patent, trademark, and attribution
+          notices from the Source form of the Work, excluding those notices
+          that do not pertain to any part of the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, You must include a readable copy of the attribution
+          notices contained within such NOTICE file, in at least one of the
+          following places: within a NOTICE text provided as part of the
+          Derivative Works; within the Source form or documentation, if
+          provided along with the Derivative Works; or, within a display
+          generated by the Derivative Works, if and wherever such third-party
+          notices normally appear. The contents of the NOTICE file are for
+          informational purposes only and do not modify the License. You may
+          add Your own attribution notices within Derivative Works that You
+          distribute, alongside or in addition to the NOTICE text from the
+          Work, provided that such additional attribution notices cannot be
+          construed as modifying the License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work by
+      You to the Licensor shall be under the terms and conditions of this
+      License, without any additional terms or conditions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any conditions of TITLE,
+      MERCHANTIBILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely
+      responsible for determining the appropriateness of using or
+      redistributing the Work and assume any risks associated with Your
+      exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or exemplary damages of any character arising as a result
+      of this License or out of the use or inability to use the Work
+      (including but not limited to damages for loss of goodwill, work
+      stoppage, computer failure or malfunction, or all other commercial
+      damages or losses), even if such Contributor has been advised of the
+      possibility of such damages.
+
+   9. Accepting Warranty or Liability. While redistributing the Work or
+      Derivative Works thereof, You may choose to offer, and charge a fee
+      for, acceptance of support, warranty, indemnity, or other liability
+      obligations and/or rights consistent with this License. However, in
+      accepting such obligations, You may offer such obligations only on
+      Your own behalf and on Your sole responsibility, not on behalf of any
+      other Contributor, and only if You agree to indemnify, defend, and
+      hold each Contributor harmless for any liability incurred by, or
+      claims asserted against, such Contributor by reason of your accepting
+      any such warranty or additional liability.
+
+   Copyright 2024 Conscious Clouds
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,52 @@
+# @consciousclouds/tokens
+
+The **ConsciousClouds Token System** — Layer 1 of the Frontend Platform. It owns:
+
+- **The vocabulary** (`src/schema.ts`): the 27 color token roles (19 core
+  shadcn roles + the 8-role sidebar set) plus the `radius` role. Every
+  surface, primitive, and Brand speaks these names; a Brand may override
+  *values*, never invent roles.
+- **The house values** (`styles/house.css`): the `:root` / `.dark` blocks and
+  the Tailwind v4 `@theme inline` mapping that resolves utilities to them.
+- **Theme state** (`ThemeProvider` / `useTheme`): a thin next-themes wrapper
+  with the house posture baked in (class attribute, system default, no
+  transition flash). Theme state is token machinery — which mode's values apply.
+
+It carries **no components, no brand meaning, no product** (membrane gate: a token
+holds no logo, no product value, no endpoint — a *Brand* re-values roles through
+`@consciousclouds/brand`, which depends on this package type-only).
+
+Schema exports for machinery that speaks the vocabulary: `TOKEN_ROLES` /
+`COLOR_TOKEN_ROLES` / `RADIUS_TOKEN_ROLE`, `tokenCssVariable(role)`, and the types
+`TokenRole` / `TokenValues` / `TokenMode` / `TokenModeValues` (what a Brand's
+`tokenOverrides` are typed against).
+
+## Usage — step 1 of the second product's path
+
+In the app's Tailwind entry stylesheet, after Tailwind itself:
+
+```css
+@import "tailwindcss";
+@import "@consciousclouds/tokens/styles/house.css";
+```
+
+In the root layout (keep `suppressHydrationWarning` on `<html>` — next-themes
+mutates it pre-hydration):
+
+```tsx
+import { ThemeProvider } from "@consciousclouds/tokens";
+
+<html lang="en" suppressHydrationWarning>
+  <body>
+    <ThemeProvider>{children}</ThemeProvider>
+  </body>
+</html>
+```
+
+Note for shell consumers: `@consciousclouds/operator-shell` takes this package as a
+runtime **peer** — the app mounts ONE `ThemeProvider` (here) and the shell's theme toggle
+reads that same instance through `useTheme`.
+
+Governed by `docs/design/frontend-platform-doctrine.md` and
+`docs/design/operator-platform-contracts.md` (§6 package graph). Platform overview + the
+full adoption path: [`platform/frontend/README.md`](../README.md).

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @consciousclouds/tokens — Token System (Layer 1 of the Frontend Platform).
+ *
+ * The universal design-token vocabulary (the 27 color roles including the
+ * sidebar set, plus radius), typed role/value shapes, the CSS-variable
+ * naming rule (tokenCssVariable), and theme state (ThemeProvider/useTheme
+ * over next-themes). The house theme VALUES ship as CSS
+ * (./styles/house.css) — this module carries vocabulary and behavior only:
+ * no components, no brand meaning, no product.
+ */
+export { COLOR_TOKEN_ROLES, RADIUS_TOKEN_ROLE, TOKEN_ROLES, tokenCssVariable, } from "./schema.js";
+export type { ColorTokenRole, RadiusTokenRole, TokenRole, TokenValues, TokenMode, TokenModeValues, } from "./schema.js";
+export { ThemeProvider, useTheme } from "./theme-provider.js";
+export type { ThemeProviderProps } from "./theme-provider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,cAAc,EACd,eAAe,EACf,SAAS,EACT,WAAW,EACX,SAAS,EACT,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @consciousclouds/tokens — Token System (Layer 1 of the Frontend Platform).
+ *
+ * The universal design-token vocabulary (the 27 color roles including the
+ * sidebar set, plus radius), typed role/value shapes, the CSS-variable
+ * naming rule (tokenCssVariable), and theme state (ThemeProvider/useTheme
+ * over next-themes). The house theme VALUES ship as CSS
+ * (./styles/house.css) — this module carries vocabulary and behavior only:
+ * no components, no brand meaning, no product.
+ */
+export { COLOR_TOKEN_ROLES, RADIUS_TOKEN_ROLE, TOKEN_ROLES, tokenCssVariable, } from "./schema.js";
+export { ThemeProvider, useTheme } from "./theme-provider.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAUrB,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The ConsciousClouds Token System vocabulary.
+ *
+ * Token roles are the universal *names* every surface, primitive, and Brand
+ * speaks. The house values live in `styles/house.css` (`:root` / `.dark`);
+ * a Brand may override *values* (typed against these role names) but never
+ * invents new roles. Color roles hold HSL channel triples (e.g.
+ * `"243 75% 59%"`) so `hsl(var(--role))` composes; the radius role holds a
+ * CSS length (e.g. `"0.625rem"`).
+ */
+/** The 27 color token roles: the 19 core shadcn roles + the 8-role sidebar set. */
+export declare const COLOR_TOKEN_ROLES: readonly ["background", "foreground", "card", "card-foreground", "popover", "popover-foreground", "primary", "primary-foreground", "secondary", "secondary-foreground", "muted", "muted-foreground", "accent", "accent-foreground", "destructive", "destructive-foreground", "border", "input", "ring", "sidebar-background", "sidebar-foreground", "sidebar-primary", "sidebar-primary-foreground", "sidebar-accent", "sidebar-accent-foreground", "sidebar-border", "sidebar-ring"];
+/** A color token role name (CSS variable name without the `--` prefix). */
+export type ColorTokenRole = (typeof COLOR_TOKEN_ROLES)[number];
+/** The radius token role — a CSS length; `sm`/`md`/`lg` derive from it. */
+export declare const RADIUS_TOKEN_ROLE: "radius";
+export type RadiusTokenRole = typeof RADIUS_TOKEN_ROLE;
+/** Every token role a theme (or a Brand override) may assign a value to. */
+export type TokenRole = ColorTokenRole | RadiusTokenRole;
+/** All token roles, in declaration order (colors first, then radius). */
+export declare const TOKEN_ROLES: readonly ["background", "foreground", "card", "card-foreground", "popover", "popover-foreground", "primary", "primary-foreground", "secondary", "secondary-foreground", "muted", "muted-foreground", "accent", "accent-foreground", "destructive", "destructive-foreground", "border", "input", "ring", "sidebar-background", "sidebar-foreground", "sidebar-primary", "sidebar-primary-foreground", "sidebar-accent", "sidebar-accent-foreground", "sidebar-border", "sidebar-ring", "radius"];
+/**
+ * A partial assignment of values to token roles — the shape of a Brand's
+ * token overrides. Color values are HSL channel triples; radius is a length.
+ */
+export type TokenValues = Partial<Record<TokenRole, string>>;
+/** The display modes a theme resolves to (`system` resolves to one of these). */
+export type TokenMode = "light" | "dark";
+/** Token values per mode — a full theme (or override) across light and dark. */
+export type TokenModeValues = Partial<Record<TokenMode, TokenValues>>;
+/** The CSS custom-property name for a token role (e.g. `--sidebar-border`). */
+export declare function tokenCssVariable(role: TokenRole): `--${TokenRole}`;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,udA8BpB,CAAC;AAEX,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,EAAG,QAAiB,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG,OAAO,iBAAiB,CAAC;AAEvD,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,eAAe,CAAC;AAEzD,yEAAyE;AACzE,eAAO,MAAM,WAAW,ieAAqD,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAE7D,iFAAiF;AACjF,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC,gFAAgF;AAChF,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AAEtE,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,SAAS,EAAE,CAElE"}

package/dist/schema.js

@@ -0,0 +1,51 @@
+/**
+ * The ConsciousClouds Token System vocabulary.
+ *
+ * Token roles are the universal *names* every surface, primitive, and Brand
+ * speaks. The house values live in `styles/house.css` (`:root` / `.dark`);
+ * a Brand may override *values* (typed against these role names) but never
+ * invents new roles. Color roles hold HSL channel triples (e.g.
+ * `"243 75% 59%"`) so `hsl(var(--role))` composes; the radius role holds a
+ * CSS length (e.g. `"0.625rem"`).
+ */
+/** The 27 color token roles: the 19 core shadcn roles + the 8-role sidebar set. */
+export const COLOR_TOKEN_ROLES = [
+    // Core surface + semantic roles.
+    "background",
+    "foreground",
+    "card",
+    "card-foreground",
+    "popover",
+    "popover-foreground",
+    "primary",
+    "primary-foreground",
+    "secondary",
+    "secondary-foreground",
+    "muted",
+    "muted-foreground",
+    "accent",
+    "accent-foreground",
+    "destructive",
+    "destructive-foreground",
+    "border",
+    "input",
+    "ring",
+    // Sidebar set (the operator chrome).
+    "sidebar-background",
+    "sidebar-foreground",
+    "sidebar-primary",
+    "sidebar-primary-foreground",
+    "sidebar-accent",
+    "sidebar-accent-foreground",
+    "sidebar-border",
+    "sidebar-ring",
+];
+/** The radius token role — a CSS length; `sm`/`md`/`lg` derive from it. */
+export const RADIUS_TOKEN_ROLE = "radius";
+/** All token roles, in declaration order (colors first, then radius). */
+export const TOKEN_ROLES = [...COLOR_TOKEN_ROLES, RADIUS_TOKEN_ROLE];
+/** The CSS custom-property name for a token role (e.g. `--sidebar-border`). */
+export function tokenCssVariable(role) {
+    return `--${role}`;
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,iCAAiC;IACjC,YAAY;IACZ,YAAY;IACZ,MAAM;IACN,iBAAiB;IACjB,SAAS;IACT,oBAAoB;IACpB,SAAS;IACT,oBAAoB;IACpB,WAAW;IACX,sBAAsB;IACtB,OAAO;IACP,kBAAkB;IAClB,QAAQ;IACR,mBAAmB;IACnB,aAAa;IACb,wBAAwB;IACxB,QAAQ;IACR,OAAO;IACP,MAAM;IACN,qCAAqC;IACrC,oBAAoB;IACpB,oBAAoB;IACpB,iBAAiB;IACjB,4BAA4B;IAC5B,gBAAgB;IAChB,2BAA2B;IAC3B,gBAAgB;IAChB,cAAc;CACN,CAAC;AAKX,2EAA2E;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAiB,CAAC;AAOnD,yEAAyE;AACzE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAG,iBAAiB,EAAE,iBAAiB,CAAU,CAAC;AAc9E,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,IAAe;IAC9C,OAAO,KAAK,IAAI,EAAE,CAAC;AACrB,CAAC"}

package/dist/theme-provider.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Theme state is token machinery: the Token System owns which mode's values
+ * apply. A thin wrapper over next-themes with the house posture baked in —
+ * class-attribute switching (matches `styles/house.css`'s `.dark` block),
+ * system default, no transition flash. Consumers keep
+ * `suppressHydrationWarning` on `<html>` (next-themes mutates it pre-hydration).
+ */
+import * as React from "react";
+import { ThemeProvider as NextThemesProvider, useTheme } from "next-themes";
+export type ThemeProviderProps = React.ComponentProps<typeof NextThemesProvider>;
+export declare function ThemeProvider({ children, ...props }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+/** Re-exported so consumers never import next-themes directly. */
+export { useTheme };
+//# sourceMappingURL=theme-provider.d.ts.map

package/dist/theme-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-provider.d.ts","sourceRoot":"","sources":["../src/theme-provider.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5E,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,cAAc,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEjF,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,2CAYvE;AAED,kEAAkE;AAClE,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/theme-provider.js

@@ -0,0 +1,9 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ThemeProvider as NextThemesProvider, useTheme } from "next-themes";
+export function ThemeProvider({ children, ...props }) {
+    return (_jsx(NextThemesProvider, { attribute: "class", defaultTheme: "system", enableSystem: true, disableTransitionOnChange: true, ...props, children: children }));
+}
+/** Re-exported so consumers never import next-themes directly. */
+export { useTheme };
+//# sourceMappingURL=theme-provider.js.map

package/dist/theme-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-provider.js","sourceRoot":"","sources":["../src/theme-provider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAWb,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI5E,MAAM,UAAU,aAAa,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAsB;IACtE,OAAO,CACL,KAAC,kBAAkB,IACjB,SAAS,EAAC,OAAO,EACjB,YAAY,EAAC,QAAQ,EACrB,YAAY,QACZ,yBAAyB,WACrB,KAAK,YAER,QAAQ,GACU,CACtB,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@consciousclouds/tokens",
+  "version": "0.1.0",
+  "description": "ConsciousClouds Token System — the universal design-token vocabulary (27 color roles incl. the sidebar set, plus radius), the house theme values, and theme state (ThemeProvider over next-themes). Layer 1 of the Frontend Platform; carries no components, no brand meaning, no product.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles/house.css": "./styles/house.css"
+  },
+  "files": ["dist", "styles", "README.md", "CHANGELOG.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "bun run clean && bun run build && bun run type-check"
+  },
+  "dependencies": {
+    "next-themes": "^0.4.6"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.7",
+    "react": "19.2.4",
+    "typescript": "^5.7.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.0.0",
+    "node": ">=18.0.0"
+  }
+}

package/styles/house.css

@@ -0,0 +1,154 @@
+/*
+ * @consciousclouds/tokens — the house theme.
+ *
+ * The universal token roles (see src/schema.ts) with the ConsciousClouds
+ * house values, plus the Tailwind v4 `@theme inline` mapping that resolves
+ * utilities to them. Import from an app's Tailwind entry stylesheet, after
+ * Tailwind itself:
+ *
+ *   @import "tailwindcss";
+ *   @import "@consciousclouds/tokens/styles/house.css";
+ *
+ * Dark mode is class-driven (`.dark` on <html>), toggled by this package's
+ * ThemeProvider. Vars stay HSL channel triples so hsl(var(--role)) composes.
+ */
+
+@custom-variant dark (&:is(.dark *));
+
+/* Tailwind v4 theme mapping — utilities resolve to the token variables below. */
+@theme inline {
+  --color-background: hsl(var(--background));
+  --color-foreground: hsl(var(--foreground));
+  --color-card: hsl(var(--card));
+  --color-card-foreground: hsl(var(--card-foreground));
+  --color-popover: hsl(var(--popover));
+  --color-popover-foreground: hsl(var(--popover-foreground));
+  --color-primary: hsl(var(--primary));
+  --color-primary-foreground: hsl(var(--primary-foreground));
+  --color-secondary: hsl(var(--secondary));
+  --color-secondary-foreground: hsl(var(--secondary-foreground));
+  --color-muted: hsl(var(--muted));
+  --color-muted-foreground: hsl(var(--muted-foreground));
+  --color-accent: hsl(var(--accent));
+  --color-accent-foreground: hsl(var(--accent-foreground));
+  --color-destructive: hsl(var(--destructive));
+  --color-destructive-foreground: hsl(var(--destructive-foreground));
+  --color-border: hsl(var(--border));
+  --color-input: hsl(var(--input));
+  --color-ring: hsl(var(--ring));
+
+  --color-sidebar: hsl(var(--sidebar-background));
+  --color-sidebar-foreground: hsl(var(--sidebar-foreground));
+  --color-sidebar-primary: hsl(var(--sidebar-primary));
+  --color-sidebar-primary-foreground: hsl(var(--sidebar-primary-foreground));
+  --color-sidebar-accent: hsl(var(--sidebar-accent));
+  --color-sidebar-accent-foreground: hsl(var(--sidebar-accent-foreground));
+  --color-sidebar-border: hsl(var(--sidebar-border));
+  --color-sidebar-ring: hsl(var(--sidebar-ring));
+
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+
+  --animate-accordion-down: accordion-down 0.2s ease-out;
+  --animate-accordion-up: accordion-up 0.2s ease-out;
+
+  @keyframes accordion-down {
+    from {
+      height: 0;
+    }
+    to {
+      height: var(--radix-accordion-content-height);
+    }
+  }
+  @keyframes accordion-up {
+    from {
+      height: var(--radix-accordion-content-height);
+    }
+    to {
+      height: 0;
+    }
+  }
+}
+
+/* ConsciousClouds house theme tokens (shadcn HSL variables). The platform owns
+ * theming; products own content. House accent: indigo/violet (the factory). */
+:root {
+  --background: 0 0% 100%;
+  --foreground: 240 10% 3.9%;
+  --card: 0 0% 100%;
+  --card-foreground: 240 10% 3.9%;
+  --popover: 0 0% 100%;
+  --popover-foreground: 240 10% 3.9%;
+  --primary: 243 75% 59%;
+  --primary-foreground: 0 0% 98%;
+  --secondary: 240 4.8% 95.9%;
+  --secondary-foreground: 240 5.9% 10%;
+  --muted: 240 4.8% 95.9%;
+  --muted-foreground: 240 3.8% 46.1%;
+  --accent: 243 30% 96%;
+  --accent-foreground: 243 75% 45%;
+  --destructive: 0 84.2% 60.2%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 240 5.9% 90%;
+  --input: 240 5.9% 90%;
+  --ring: 243 75% 59%;
+  --radius: 0.625rem;
+
+  --sidebar-background: 240 5% 98%;
+  --sidebar-foreground: 240 5.3% 26.1%;
+  --sidebar-primary: 243 75% 59%;
+  --sidebar-primary-foreground: 0 0% 98%;
+  --sidebar-accent: 243 30% 96%;
+  --sidebar-accent-foreground: 243 75% 45%;
+  --sidebar-border: 240 5.9% 90%;
+  --sidebar-ring: 243 75% 59%;
+}
+
+.dark {
+  --background: 240 10% 5%;
+  --foreground: 0 0% 98%;
+  --card: 240 10% 7%;
+  --card-foreground: 0 0% 98%;
+  --popover: 240 10% 7%;
+  --popover-foreground: 0 0% 98%;
+  --primary: 243 75% 64%;
+  --primary-foreground: 0 0% 100%;
+  --secondary: 240 6% 14%;
+  --secondary-foreground: 0 0% 98%;
+  --muted: 240 6% 14%;
+  --muted-foreground: 240 5% 64.9%;
+  --accent: 243 25% 16%;
+  --accent-foreground: 243 80% 78%;
+  --destructive: 0 62.8% 45%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 240 6% 18%;
+  --input: 240 6% 18%;
+  --ring: 243 75% 64%;
+
+  --sidebar-background: 240 8% 9%;
+  --sidebar-foreground: 240 4.8% 90%;
+  --sidebar-primary: 243 75% 64%;
+  --sidebar-primary-foreground: 0 0% 100%;
+  --sidebar-accent: 243 25% 16%;
+  --sidebar-accent-foreground: 243 80% 78%;
+  --sidebar-border: 240 6% 18%;
+  --sidebar-ring: 243 75% 64%;
+}
+
+@layer base {
+  /* Tailwind v4 defaults border-color to currentColor; keep the v3/shadcn
+   * behavior of theming every border explicitly. */
+  *,
+  ::after,
+  ::before,
+  ::backdrop,
+  ::file-selector-button {
+    border-color: hsl(var(--border));
+  }
+  body {
+    background-color: hsl(var(--background));
+    color: hsl(var(--foreground));
+    font-feature-settings: "rlig" 1, "calt" 1;
+  }
+}