@consciousclouds/appearance-experience 0.0.0-stage → 0.1.1

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

@@ -1,3 +1,68 @@
-# Temporary Holding Version
+# Appearance Experience — local 0.1.0 candidate
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Optional React 19 presentation. Import `AppearanceExperience` and its types from
+`@consciousclouds/appearance-experience`, and import
+`@consciousclouds/appearance-experience/styles.css` once in the host CSS entry.
+No Tailwind source scanning is required; the CSS also works in Tailwind 4 hosts.
+
+Provide the existing Universal `Brand`, approved `AccentPreset[]`, all localized
+`AppearanceMessages`, capabilities, an immutable account/scope `contextKey`, and a
+stable `AppearanceAdapter`. Both `embedded` and `standalone` layouts are panels;
+neither owns a route, application shell, global ThemeProvider or persistence.
+
+## Contract
+
+`AppearanceSnapshot` contains saved `overrides`, canonical `effective` values and
+an optional opaque `revision`. Omitted mode/accent means inheritance. `load`,
+`save` and `reset` return a snapshot or `denied | unavailable | failed | conflict`.
+Every operation receives an AbortSignal; writes also receive the saved revision.
+The product's pure `resolve(draft, saved)` function determines preview precedence.
+It must return a supported mode and an approved accent identifier.
+
+Bind an adapter to one immutable account/scope. Change `contextKey` whenever the
+account, scope, permissions policy, allowed catalog or inherited defaults change.
+Keep adapter identity stable within that context. Context/capability changes
+remount the panel, abort outstanding requests, and discard late results even if
+an adapter ignores abort. A remote write already accepted by a server cannot be
+undone by abort: adapters must capture the correct scope and enforce permissions
+server-side. A revision provides conflict protection only when the backend enforces it.
+
+Preview affects only the scoped sample. Apply commits draft overrides. Cancel
+restores the saved draft/sample without persistence. Reset stages removal of the
+selected scope's overrides; Apply then invokes `reset`. Editing after Reset turns
+the operation into a save of the edited overrides. Save failures preserve the draft
+and committed presentation separately. Unexpected load errors show unavailable;
+unexpected write errors show failed. Raw service errors are never rendered.
+
+Capabilities hide unsupported mode/accent controls, disable writes and suppress
+loads when read access is absent. They do not grant authorization. Typography,
+density, schedules, scope pickers and lifecycle/authentication screens are absent.
+
+## Styling and accessibility
+
+Brand 0.1.2 adds isolated HSL CSS generation. The panel shows saved appearance;
+the preview can show a separate draft. Host root classes/tokens are never changed.
+Accents override the product brand's mode values only inside these scopes. Missing
+sample roles use scoped baseline values; every preset's color values must be HSL
+channel triples, not full `hsl()`/`oklch()` expressions. Fonts are inherited from
+the host; product assets and preference precedence remain product-owned.
+
+All messages, option labels and headings are product-provided. Use `locale`,
+`dir` and `headingLevel` for embedding. Native radios/selects support keyboard
+navigation; status is a polite live region. Controls have visible focus and 44px
+minimum targets. The module uses the existing UI reduced-motion hook and introduces
+no animation. It does not change OS preferences or other application animations.
+Pass `nonce` when inline scoped styles require a CSP nonce. Host-wide `!important`
+CSS can override ordinary component CSS; such hosts need their own compatibility test.
+Product palettes must pass contrast checks; syntactic HSL validation is not a contrast certificate.
+
+## Distribution
+
+Dependencies: Brand ^0.1.2, Tokens ^0.1.1, UI ^0.1.1; React/DOM ^19.0.0 peers.
+ShellFrame and OperatorShell are not dependencies. ESM/public exports only.
+Build with `npm run build`; packing invokes build/type-check. Production artifacts
+require no source checkout or workspace links and contain no SDK transport or storage implementation.
+
+See `scripts/appearance-experience/README.md` in the Universal source review for
+artifact-only fixture reproduction, hashes, adapter specifications and limitations.
+Local candidates are not registry-publication or product-adoption proof.

package/dist/appearance-experience.d.ts

@@ -0,0 +1,3 @@
+import type { AppearanceExperienceProps } from "./contracts.js";
+/** Pure presentation boundary; context changes synchronously remove the previous account's view. */
+export declare function AppearanceExperience(props: AppearanceExperienceProps): import("react/jsx-runtime").JSX.Element;

package/dist/appearance-experience.js

@@ -0,0 +1,136 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import * as React from "react";
+import { scopedBrandTokenOverridesCss } from "@consciousclouds/brand";
+import { Button, useReducedMotion } from "@consciousclouds/ui";
+const modes = ["light", "dark", "system"];
+const initial = () => ({ draft: {}, pending: true, preview: false, reset: false, applied: false });
+const same = (a, b) => a.mode === b.mode && a.accent === b.accent;
+/** Pure presentation boundary; context changes synchronously remove the previous account's view. */
+export function AppearanceExperience(props) {
+    const c = props.capabilities;
+    return _jsx(Panel, { ...props }, JSON.stringify([props.contextKey, c.read, c.write, c.reset, c.mode, c.accent]));
+}
+function Panel({ adapter, capabilities: caps, brand, accents, messages: m, layout = "embedded", headingLevel = 2, locale, dir, nonce }) {
+    const uid = `appearance-${React.useId().replace(/[^a-zA-Z0-9_-]/g, "")}`;
+    const [state, setState] = React.useState(initial);
+    const [reload, setReload] = React.useState(0);
+    const generation = React.useRef(0);
+    const active = React.useRef(null);
+    // Ref prevents duplicate calls in the same event batch, before React disables controls.
+    const busy = React.useRef(true);
+    const reduced = useReducedMotion();
+    const Heading = `h${headingLevel}`;
+    const ids = new Set(accents.map(a => a.id));
+    if (!accents.length || ids.size !== accents.length || accents.some(a => !a.id))
+        throw new TypeError("Appearance requires unique approved accent presets");
+    // Validate ALL preset configurations, including options not yet selected.
+    for (const a of accents)
+        scopedBrandTokenOverridesCss(a.tokens, uid);
+    scopedBrandTokenOverridesCss(brand.tokenOverrides, uid);
+    function validateValues(value) {
+        if (!value || !modes.includes(value.mode) || !ids.has(value.accent))
+            throw new TypeError("Unsupported effective appearance");
+    }
+    function validateSnapshot(value) {
+        validateValues(value.effective);
+        const o = value.overrides;
+        if (!o || Object.keys(o).some(k => k !== "mode" && k !== "accent") ||
+            (o.mode !== undefined && !modes.includes(o.mode)) || (o.accent !== undefined && !ids.has(o.accent))) {
+            throw new TypeError("Unsupported appearance overrides");
+        }
+    }
+    React.useEffect(() => {
+        const ticket = ++generation.current;
+        const controller = new AbortController();
+        active.current = controller;
+        busy.current = true;
+        setState(initial());
+        if (!caps.read) {
+            busy.current = false;
+            setState({ ...initial(), pending: false, failure: "denied" });
+            return () => { generation.current++; controller.abort(); };
+        }
+        async function load() {
+            try {
+                const result = await adapter.load({ signal: controller.signal });
+                if (ticket !== generation.current || controller.signal.aborted)
+                    return;
+                if (result.ok) {
+                    validateSnapshot(result.snapshot);
+                    setState({ ...initial(), pending: false, snapshot: result.snapshot, draft: { ...result.snapshot.overrides } });
+                }
+                else
+                    setState({ ...initial(), pending: false, failure: result.reason });
+            }
+            catch {
+                if (ticket === generation.current && !controller.signal.aborted)
+                    setState({ ...initial(), pending: false, failure: "unavailable" });
+            }
+            finally {
+                if (ticket === generation.current)
+                    busy.current = false;
+            }
+        }
+        void load();
+        return () => { generation.current++; controller.abort(); active.current?.abort(); };
+        // Brand/catalog/policy revisions belong in contextKey; keep adapter identity stable.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [adapter, reload, caps.read]);
+    const dirty = !!state.snapshot && (state.reset || !same(state.draft, state.snapshot.overrides));
+    const locked = state.pending || !caps.write || !state.snapshot;
+    const selected = state.snapshot && (state.preview ? adapter.resolve(state.draft, state.snapshot) : state.snapshot.effective);
+    if (selected)
+        validateValues(selected);
+    const preset = selected && accents.find(a => a.id === selected.accent);
+    const overrides = {
+        light: { ...brand.tokenOverrides?.light, ...preset?.tokens.light },
+        dark: { ...brand.tokenOverrides?.dark, ...preset?.tokens.dark },
+    };
+    const savedPreset = state.snapshot && accents.find(a => a.id === state.snapshot.effective.accent);
+    const panelCss = scopedBrandTokenOverridesCss({
+        light: { ...brand.tokenOverrides?.light, ...savedPreset?.tokens.light },
+        dark: { ...brand.tokenOverrides?.dark, ...savedPreset?.tokens.dark },
+    }, `${uid}-panel`);
+    const css = panelCss + "\n" + scopedBrandTokenOverridesCss(overrides, uid);
+    function edit(patch) {
+        if (locked || busy.current)
+            return;
+        setState(s => ({ ...s, draft: { ...s.draft, ...patch }, reset: false, failure: undefined, applied: false }));
+    }
+    async function apply() {
+        if (locked || busy.current || !dirty || !state.snapshot)
+            return;
+        busy.current = true;
+        const ticket = ++generation.current;
+        active.current?.abort();
+        const controller = new AbortController();
+        active.current = controller;
+        const request = { signal: controller.signal, revision: state.snapshot.revision };
+        setState(s => ({ ...s, pending: true, failure: undefined, applied: false }));
+        try {
+            const result = state.reset ? await adapter.reset(request) : await adapter.save({ ...state.draft }, request);
+            if (ticket !== generation.current || controller.signal.aborted)
+                return;
+            if (result.ok) {
+                validateSnapshot(result.snapshot);
+                setState({ ...initial(), pending: false, snapshot: result.snapshot, draft: { ...result.snapshot.overrides }, applied: true });
+            }
+            else
+                setState(s => ({ ...s, pending: false, failure: result.reason }));
+        }
+        catch {
+            if (ticket === generation.current && !controller.signal.aborted)
+                setState(s => ({ ...s, pending: false, failure: "failed" }));
+        }
+        finally {
+            if (ticket === generation.current)
+                busy.current = false;
+        }
+    }
+    const status = state.pending ? (state.snapshot ? m.saving : m.loading)
+        : state.failure ? m[state.failure] : !caps.write ? m.readOnly
+            : state.reset ? m.resetPending : dirty ? m.unsaved : state.applied ? m.saved : "";
+    return _jsxs("section", { className: "cc-appearance", "data-layout": layout, "data-cc-brand-scope": `${uid}-panel`, "data-cc-mode": state.snapshot?.effective.mode ?? "system", "data-reduced-motion": reduced, lang: locale, dir: dir, "aria-labelledby": `${uid}-title`, children: [_jsx(Heading, { id: `${uid}-title`, className: "cc-a-title", children: m.title }), _jsx("p", { className: "cc-a-description", children: m.description }), _jsx("p", { className: "cc-a-status", role: "status", "aria-live": "polite", "aria-atomic": "true", children: status }), !state.snapshot && !state.pending && caps.read && _jsx(Button, { className: "cc-a-button", onClick: () => setReload(n => n + 1), children: m.retry }), state.snapshot && _jsxs(_Fragment, { children: [_jsxs("div", { className: "cc-a-controls", "aria-busy": state.pending, children: [caps.mode && _jsxs("fieldset", { disabled: locked, className: "cc-a-fieldset", children: [_jsx("legend", { children: m.mode }), _jsx("div", { className: "cc-a-options", children: [undefined, ...modes].map(mode => _jsxs("label", { className: "cc-a-option", children: [_jsx("input", { type: "radio", name: `${uid}-mode`, value: mode ?? "inherit", checked: state.draft.mode === mode, onChange: () => edit({ mode }) }), _jsx("span", { children: mode ? m[mode] : m.inherit })] }, mode ?? "inherit")) })] }), caps.accent && _jsxs("label", { className: "cc-a-accent", htmlFor: `${uid}-accent`, children: [_jsx("span", { children: m.accent }), _jsxs("select", { id: `${uid}-accent`, disabled: locked, value: state.draft.accent ?? "", onChange: e => edit({ accent: e.target.value || undefined }), children: [_jsx("option", { value: "", children: m.inherit }), accents.map(a => _jsx("option", { value: a.id, children: a.label }, a.id))] })] })] }), _jsxs("div", { className: "cc-a-actions", children: [_jsx(Button, { className: "cc-a-button", "aria-pressed": state.preview, disabled: state.pending, onClick: () => setState(s => ({ ...s, preview: !s.preview })), children: m.preview }), _jsx(Button, { className: "cc-a-button", disabled: locked || !dirty, onClick: () => void apply(), children: m.apply }), _jsx(Button, { className: "cc-a-button", disabled: state.pending || (!dirty && !state.preview), onClick: () => setState(s => ({ ...s, draft: { ...s.snapshot.overrides }, reset: false, preview: false, failure: undefined, applied: false })), children: m.cancel }), caps.reset && _jsx(Button, { className: "cc-a-button", disabled: locked, onClick: () => setState(s => ({ ...s, draft: {}, reset: true, preview: true, failure: undefined, applied: false })), children: m.reset })] }), _jsx("style", { nonce: nonce, children: css }), _jsxs("div", { className: "cc-a-preview", "data-cc-brand-scope": uid, "data-cc-mode": selected?.mode, role: "region", "aria-label": m.previewTitle, children: [_jsx("strong", { children: m.previewTitle }), _jsx("p", { children: m.previewText }), _jsx("span", { className: "cc-a-preview-action", children: m.previewAction })] })] })] });
+}
+//# sourceMappingURL=appearance-experience.js.map

package/dist/appearance-experience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appearance-experience.js","sourceRoot":"","sources":["../src/appearance-experience.tsx"],"names":[],"mappings":"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"}

package/dist/contracts.d.ts

@@ -0,0 +1,90 @@
+import type { Brand } from "@consciousclouds/brand";
+import type { TokenModeValues } from "@consciousclouds/tokens";
+export type AppearanceMode = "light" | "dark" | "system";
+export interface AppearanceValues {
+    mode: AppearanceMode;
+    accent: string;
+}
+/** Omitted properties mean inheritance, never a fabricated Universal default. */
+export type AppearanceOverrides = Partial<AppearanceValues>;
+export interface AppearanceSnapshot {
+    overrides: AppearanceOverrides;
+    effective: AppearanceValues;
+    /** Opaque product revision; the module makes no concurrency guarantee without it. */
+    revision?: string;
+}
+export type AppearanceFailure = "denied" | "unavailable" | "failed" | "conflict";
+export type AppearanceResult = {
+    ok: true;
+    snapshot: AppearanceSnapshot;
+} | {
+    ok: false;
+    reason: AppearanceFailure;
+};
+export interface AppearanceRequest {
+    signal: AbortSignal;
+    revision?: string;
+}
+/** Bind each adapter to ONE account/scope. Never look up a mutable current account inside an async action. */
+export interface AppearanceAdapter {
+    load(request: AppearanceRequest): Promise<AppearanceResult>;
+    save(overrides: AppearanceOverrides, request: AppearanceRequest): Promise<AppearanceResult>;
+    reset(request: AppearanceRequest): Promise<AppearanceResult>;
+    /** Pure product-owned precedence. No I/O or persistence during preview. */
+    resolve(overrides: AppearanceOverrides, saved: AppearanceSnapshot): AppearanceValues;
+}
+export interface AppearanceCapabilities {
+    read: boolean;
+    write: boolean;
+    reset: boolean;
+    mode: boolean;
+    accent: boolean;
+}
+export interface AccentPreset {
+    id: string;
+    label: string;
+    tokens: TokenModeValues;
+}
+export interface AppearanceMessages {
+    title: string;
+    description: string;
+    mode: string;
+    accent: string;
+    light: string;
+    dark: string;
+    system: string;
+    inherit: string;
+    preview: string;
+    previewTitle: string;
+    previewText: string;
+    previewAction: string;
+    apply: string;
+    cancel: string;
+    reset: string;
+    retry: string;
+    loading: string;
+    saving: string;
+    saved: string;
+    unsaved: string;
+    resetPending: string;
+    denied: string;
+    unavailable: string;
+    failed: string;
+    conflict: string;
+    readOnly: string;
+}
+export interface AppearanceExperienceProps {
+    /** Change on account, scope, policy or inherited-preference revision changes. Remounts/aborts stale work. */
+    contextKey: string;
+    adapter: AppearanceAdapter;
+    capabilities: AppearanceCapabilities;
+    brand: Brand;
+    accents: readonly AccentPreset[];
+    messages: AppearanceMessages;
+    layout?: "embedded" | "standalone";
+    headingLevel?: 1 | 2 | 3;
+    locale?: string;
+    dir?: "ltr" | "rtl";
+    /** CSP nonce for generated scoped brand CSS, if required by the host. */
+    nonce?: string;
+}

package/dist/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { AppearanceExperience } from "./appearance-experience.js";
+export type * from "./contracts.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { AppearanceExperience } from "./appearance-experience.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,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@consciousclouds/appearance-experience",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Optional React Appearance experience with product-owned persistence and preference resolution",
+  "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.css": "./styles/appearance.css"
+  },
+  "files": [
+    "dist",
+    "styles",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "type-check": "tsc --noEmit",
+    "prepack": "npm run build && npm run type-check"
+  },
+  "dependencies": {
+    "@consciousclouds/brand": "^0.1.2",
+    "@consciousclouds/tokens": "^0.1.1",
+    "@consciousclouds/ui": "^0.2.0"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "react": "19.2.4",
+    "react-dom": "19.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/styles/appearance.css

@@ -0,0 +1,31 @@
+/* Baseline semantic values are scoped; they never inherit incompatible host colors. */
+.cc-appearance { --background: 0 0% 100%; --foreground: 240 10% 3.9%; --primary: 243 75% 59%; --primary-foreground: 0 0% 98%; --border: 240 5.9% 45%; }
+.cc-appearance:where([data-cc-mode="dark"]) { --background: 240 10% 3.9%; --foreground: 0 0% 98%; --primary: 243 75% 70%; --border: 240 3.7% 60%; }
+@media (prefers-color-scheme: dark) { .cc-appearance:where([data-cc-mode="system"]) { --background: 240 10% 3.9%; --foreground: 0 0% 98%; --primary: 243 75% 70%; --border: 240 3.7% 60%; } }
+/* Self-contained module styles; no Tailwind scan, preflight or document-root writes.
+   Neutral editor chrome intentionally stays separate from the draft preview. */
+.cc-appearance { box-sizing: border-box; color: hsl(var(--foreground)); background: hsl(var(--background)); font-family: inherit; font-size: 1rem; line-height: 1.5; padding: 1.25rem; border: 1px solid hsl(var(--border)); border-radius: .75rem; max-width: 48rem; width: 100%; text-align: start; }
+.cc-appearance *, .cc-appearance *::before, .cc-appearance *::after { box-sizing: border-box; }
+.cc-appearance[data-layout="standalone"] { margin-inline: auto; padding: clamp(1rem, 4vw, 2rem); }
+.cc-appearance .cc-a-title { margin: 0; font-size: 1.35rem; font-weight: 650; line-height: 1.3; }
+.cc-appearance .cc-a-description { margin: .5rem 0; }
+.cc-appearance .cc-a-status { min-height: 1.5em; margin: .75rem 0; }
+.cc-appearance .cc-a-controls { display: grid; gap: 1.25rem; }
+.cc-appearance .cc-a-fieldset { border: 0; margin: 0; padding: 0; min-width: 0; }
+.cc-appearance legend, .cc-appearance .cc-a-accent > span { display: block; font-weight: 600; margin-block-end: .5rem; }
+.cc-appearance .cc-a-options { display: flex; flex-wrap: wrap; gap: .5rem; }
+.cc-appearance .cc-a-option { display: flex; gap: .5rem; align-items: center; padding: .65rem; min-height: 44px; border: 1px solid hsl(var(--border)); border-radius: .35rem; }
+.cc-appearance input[type="radio"] { appearance: auto; inline-size: 1rem; block-size: 1rem; margin: 0; accent-color: hsl(var(--foreground)); }
+.cc-appearance select { appearance: auto; font: inherit; color: hsl(var(--foreground)); background: hsl(var(--background)); border: 1px solid hsl(var(--border)); border-radius: .35rem; min-height: 44px; padding: .5rem; max-width: 100%; width: 100%; }
+.cc-appearance .cc-a-actions { display: flex; flex-wrap: wrap; gap: .5rem; margin-block: 1.25rem; }
+.cc-appearance button.cc-a-button { display: inline-flex; justify-content: center; align-items: center; font: inherit; color: hsl(var(--foreground)); background: hsl(var(--background)); border: 1px solid hsl(var(--foreground)); border-radius: .35rem; min-height: 44px; height: auto; padding: .5rem 1rem; box-shadow: none; white-space: normal; transition: none; cursor: pointer; }
+.cc-appearance button.cc-a-button[aria-pressed="true"] { box-shadow: inset 0 0 0 2px hsl(var(--primary)); }
+.cc-appearance button.cc-a-button:disabled, .cc-appearance fieldset:disabled { opacity: .65; cursor: default; }
+.cc-appearance :is(button, input, select):focus-visible { outline: 3px solid hsl(var(--primary)); outline-offset: 3px; }
+ :where(.cc-appearance) .cc-a-preview { --background: 0 0% 100%; --foreground: 240 10% 3.9%; --primary: 243 75% 59%; --primary-foreground: 0 0% 98%; --border: 240 5.9% 90%; color: hsl(var(--foreground)); background: hsl(var(--background)); border: 1px solid hsl(var(--border)); padding: 1rem; border-radius: .5rem; color-scheme: light; }
+:where(.cc-appearance) .cc-a-preview:where([data-cc-mode="dark"]) { --background: 240 10% 3.9%; --foreground: 0 0% 98%; --primary: 243 75% 59%; --primary-foreground: 0 0% 98%; --border: 240 3.7% 15.9%; color-scheme: dark; }
+@media (prefers-color-scheme: dark) { :where(.cc-appearance) .cc-a-preview:where([data-cc-mode="system"]) { --background: 240 10% 3.9%; --foreground: 0 0% 98%; --primary: 243 75% 59%; --primary-foreground: 0 0% 98%; --border: 240 3.7% 15.9%; color-scheme: dark; } }
+.cc-appearance .cc-a-preview-action { display: inline-block; background: hsl(var(--primary)); color: hsl(var(--primary-foreground)); padding: .5rem 1rem; border-radius: .25rem; }
+.cc-appearance[data-reduced-motion="true"] *, .cc-appearance * { animation: none; transition: none; }
+@media (max-width: 420px) { .cc-appearance .cc-a-actions { display: grid; grid-template-columns: 1fr 1fr; } }
+@media (forced-colors: active) { .cc-appearance, .cc-appearance .cc-a-preview, .cc-appearance .cc-a-option { border-color: CanvasText; } }