tyrell-react 1.0.0-RC10

package/dist/components/index.js

@@ -0,0 +1,127 @@
+// ===================================================================
+// VERSION
+// ===================================================================
+import { VERSION } from '../version';
+/** Current version of tyrell-react (auto-synced with package.json on build). */
+export { VERSION };
+// One-time load banner so consumers can confirm which version of
+// tyrell-react their page is actually running. Mirrors the banner in
+// tyrell-components. Filter DevTools with "tyrell-react" if noisy.
+if (typeof window !== 'undefined') {
+    window.tyReactVersion = VERSION;
+    console.log(`%c[tyrell-react]%c v${VERSION}`, 'color:#a78bfa;font-weight:600', 'color:inherit;font-weight:400');
+}
+// ===================================================================
+// TYRELL REACT WRAPPER EXPORTS
+// ===================================================================
+// This file provides two export styles for maximum developer flexibility:
+// 1. Ty-prefixed exports (TyButton, TyInput) - explicit and backward compatible
+// 2. Short name exports (Button, Input) - clean and familiar to React developers
+//
+// Choose the style that fits your team's preferences!
+// ===================================================================
+// TY-PREFIXED EXPORTS (Explicit Style - Backward Compatible)
+// ===================================================================
+export { TyButton } from './TyButton';
+export { TyTag } from './TyTag';
+export { TyInput } from './TyInput';
+export { TyTextarea } from './TyTextarea';
+export { TyDropdown } from './TyDropdown';
+export { TyOption } from './TyOption';
+export { TyIcon } from './TyIcon';
+export { TyModal } from './TyModal';
+export { TyTooltip } from './TyTooltip';
+export { TyMultiselect } from './TyMultiselect';
+export { TyCalendar } from './TyCalendar';
+export { TyDatePicker } from './TyDatePicker';
+export { TyPopup } from './TyPopup';
+export { TyCheckbox } from './TyCheckbox';
+export { TySwitch } from './TySwitch';
+export { TyRadio } from './TyRadio';
+export { TyRadioGroup } from './TyRadioGroup';
+export { TyCopy } from './TyCopy';
+export { TyFileUpload } from './TyFileUpload';
+export { TyTabs } from './TyTabs';
+export { TyTab } from './TyTab';
+export { TyCalendarMonth } from './TyCalendarMonth';
+export { TyCalendarNavigation } from './TyCalendarNavigation';
+export { TyWizard } from './TyWizard';
+export { TyStep } from './TyStep';
+export { TyResizeObserver } from './TyResizeObserver';
+export { TyScrollContainer } from './TyScrollContainer';
+// ===================================================================
+// SHORT NAME EXPORTS (Clean Style - Developer Choice)
+// ===================================================================
+export { TyButton as Button } from './TyButton';
+export { TyTag as Tag } from './TyTag';
+export { TyInput as Input } from './TyInput';
+export { TyTextarea as Textarea } from './TyTextarea';
+export { TyDropdown as Dropdown } from './TyDropdown';
+export { TyOption as Option } from './TyOption';
+export { TyIcon as Icon } from './TyIcon';
+export { TyModal as Modal } from './TyModal';
+export { TyTooltip as Tooltip } from './TyTooltip';
+export { TyMultiselect as Multiselect } from './TyMultiselect';
+export { TyCalendar as Calendar } from './TyCalendar';
+export { TyDatePicker as DatePicker } from './TyDatePicker';
+export { TyPopup as Popup } from './TyPopup';
+export { TyCheckbox as Checkbox } from './TyCheckbox';
+export { TySwitch as Switch } from './TySwitch';
+export { TyRadio as Radio } from './TyRadio';
+export { TyRadioGroup as RadioGroup } from './TyRadioGroup';
+export { TyCopy as Copy } from './TyCopy';
+export { TyFileUpload as FileUpload } from './TyFileUpload';
+export { TyTabs as Tabs } from './TyTabs';
+export { TyTab as Tab } from './TyTab';
+export { TyCalendarMonth as CalendarMonth } from './TyCalendarMonth';
+export { TyCalendarNavigation as CalendarNavigation } from './TyCalendarNavigation';
+export { TyWizard as Wizard } from './TyWizard';
+export { TyStep as Step } from './TyStep';
+export { TyResizeObserver as ResizeObserver } from './TyResizeObserver';
+export { TyScrollContainer as ScrollContainer } from './TyScrollContainer';
+// ===================================================================
+// USAGE EXAMPLES
+// ===================================================================
+/*
+
+// STYLE 1: Ty-prefixed (Explicit and backward compatible)
+import { TyButton, TyInput, TyModal } from 'tyrell-react';
+import type { TyButtonProps, TyInputProps } from 'tyrell-react';
+
+function MyComponent() {
+  return (
+    <TyModal>
+      <TyInput placeholder="Enter text..." />
+      <TyButton>Submit</TyButton>
+    </TyModal>
+  );
+}
+
+// STYLE 2: Short names (Clean and familiar)
+import { Button, Input, Modal } from 'tyrell-react';
+import type { ButtonProps, InputProps } from 'tyrell-react';
+
+function MyComponent() {
+  return (
+    <Modal>
+      <Input placeholder="Enter text..." />
+      <Button>Submit</Button>
+    </Modal>
+  );
+}
+
+// STYLE 3: Mixed (Team preferences)
+import { TyModal, Input, Button } from 'tyrell-react';
+import type { TyModalProps, InputProps } from 'tyrell-react';
+
+function MyComponent() {
+  return (
+    <TyModal>
+      <Input placeholder="Enter text..." />
+      <Button>Submit</Button>
+    </TyModal>
+  );
+}
+
+*/
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

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

package/dist/utils/react-version.d.ts

@@ -0,0 +1,2 @@
+export declare const needsPropertyBridge: boolean;
+//# sourceMappingURL=react-version.d.ts.map

package/dist/utils/react-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-version.d.ts","sourceRoot":"","sources":["../../src/utils/react-version.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,mBAAmB,SAAmC,CAAC"}

package/dist/utils/react-version.js

@@ -0,0 +1,8 @@
+import React from 'react';
+// React 19 natively bridges props to custom-element properties (including
+// empty strings, `false` booleans, functions, and objects). On React 18 we
+// must imperatively assign these properties via useEffect. Wrappers gate
+// their bridging effects on this flag so the workaround is dead code on
+// React 19+ and removable when React 18 support is eventually dropped.
+export const needsPropertyBridge = parseInt(React.version, 10) < 19;
+//# sourceMappingURL=react-version.js.map

package/dist/utils/react-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-version.js","sourceRoot":"","sources":["../../src/utils/react-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,0EAA0E;AAC1E,2EAA2E;AAC3E,yEAAyE;AACzE,wEAAwE;AACxE,uEAAuE;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC"}

package/dist/utils/use-boolean-prop.d.ts

@@ -0,0 +1,36 @@
+import { RefObject } from 'react';
+/**
+ * Coerce a value to a boolean using the same rules as the core property
+ * manager (packages/core/src/utils/property-manager.ts:142-152). This matters
+ * because consumers sometimes pass the string "false" through untyped call
+ * sites (JSON config, query params, server-rendered props) — and the JS
+ * `Boolean("false")` is surprisingly `true`.
+ *
+ *   undefined | null | false | "false" | "0"  → false
+ *   ""                                        → true  (HTML boolean-attribute convention)
+ *   any other truthy                          → true
+ */
+export declare function coerceBool(value: unknown): boolean;
+/**
+ * Imperatively keep a boolean property on the underlying custom element in
+ * sync with its React prop.
+ *
+ * Why this exists: React 18 sets boolean attributes as empty strings on the
+ * first render to a custom element but does not reliably *remove* them when
+ * the prop flips back to `false`. Without this bridge, `<TyModal open>` →
+ * `<TyModal open={false}>` leaves the `open` attribute on the element and
+ * the modal stays open. Same class of bug affects `disabled`, `required`,
+ * `clearable`, `loading`, `readonly`, `protected`, etc.
+ *
+ * React 19+ bridges this natively — the effect short-circuits via
+ * `needsPropertyBridge`, so this is dead code on modern React.
+ *
+ * Pass the *camelCase JS property name* on the element (e.g. `externalSearch`
+ * for the `external-search` attribute). The core base class handles the
+ * attribute-side sync once the property changes.
+ *
+ * Returns the coerced boolean so the caller can also drive its conditional
+ * JSX attribute emission with a value that correctly handles "false".
+ */
+export declare function useBooleanProperty(ref: RefObject<HTMLElement | null>, propName: string, value: unknown): boolean;
+//# sourceMappingURL=use-boolean-prop.d.ts.map

package/dist/utils/use-boolean-prop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-boolean-prop.d.ts","sourceRoot":"","sources":["../../src/utils/use-boolean-prop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,SAAS,EAAE,MAAM,OAAO,CAAC;AAG7C;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASlD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAWT"}

package/dist/utils/use-boolean-prop.js

@@ -0,0 +1,62 @@
+import { useEffect } from 'react';
+import { needsPropertyBridge } from './react-version';
+/**
+ * Coerce a value to a boolean using the same rules as the core property
+ * manager (packages/core/src/utils/property-manager.ts:142-152). This matters
+ * because consumers sometimes pass the string "false" through untyped call
+ * sites (JSON config, query params, server-rendered props) — and the JS
+ * `Boolean("false")` is surprisingly `true`.
+ *
+ *   undefined | null | false | "false" | "0"  → false
+ *   ""                                        → true  (HTML boolean-attribute convention)
+ *   any other truthy                          → true
+ */
+export function coerceBool(value) {
+    if (value === undefined || value === null || value === false)
+        return false;
+    if (typeof value === 'string') {
+        if (value === '')
+            return true;
+        const norm = value.toLowerCase().trim();
+        if (norm === 'false' || norm === '0')
+            return false;
+        return true;
+    }
+    return Boolean(value);
+}
+/**
+ * Imperatively keep a boolean property on the underlying custom element in
+ * sync with its React prop.
+ *
+ * Why this exists: React 18 sets boolean attributes as empty strings on the
+ * first render to a custom element but does not reliably *remove* them when
+ * the prop flips back to `false`. Without this bridge, `<TyModal open>` →
+ * `<TyModal open={false}>` leaves the `open` attribute on the element and
+ * the modal stays open. Same class of bug affects `disabled`, `required`,
+ * `clearable`, `loading`, `readonly`, `protected`, etc.
+ *
+ * React 19+ bridges this natively — the effect short-circuits via
+ * `needsPropertyBridge`, so this is dead code on modern React.
+ *
+ * Pass the *camelCase JS property name* on the element (e.g. `externalSearch`
+ * for the `external-search` attribute). The core base class handles the
+ * attribute-side sync once the property changes.
+ *
+ * Returns the coerced boolean so the caller can also drive its conditional
+ * JSX attribute emission with a value that correctly handles "false".
+ */
+export function useBooleanProperty(ref, propName, value) {
+    const coerced = coerceBool(value);
+    useEffect(() => {
+        if (!needsPropertyBridge)
+            return;
+        const el = ref.current;
+        if (!el)
+            return;
+        if (Boolean(el[propName]) !== coerced) {
+            el[propName] = coerced;
+        }
+    }, [coerced, propName, ref]);
+    return coerced;
+}
+//# sourceMappingURL=use-boolean-prop.js.map

package/dist/utils/use-boolean-prop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-boolean-prop.js","sourceRoot":"","sources":["../../src/utils/use-boolean-prop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAa,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAC3E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAkC,EAClC,QAAgB,EAChB,KAAc;IAEd,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,mBAAmB;YAAE,OAAO;QACjC,MAAM,EAAE,GAAG,GAAG,CAAC,OAAc,CAAC;QAC9B,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,IAAI,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;YACtC,EAAE,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;QACzB,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** Current version of tyrell-react. Synced with package.json on build. */
+export declare const VERSION = "1.0.0-RC10";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAIA,0EAA0E;AAC1E,eAAO,MAAM,OAAO,eAAe,CAAA"}

package/dist/version.js

@@ -0,0 +1,6 @@
+// AUTO-GENERATED FILE - DO NOT EDIT
+// Generated from package.json by scripts/generate-version.js
+// Run 'npm run generate:version' to regenerate.
+/** Current version of tyrell-react. Synced with package.json on build. */
+export const VERSION = '1.0.0-RC10';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,6DAA6D;AAC7D,gDAAgD;AAEhD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,OAAO,GAAG,YAAY,CAAA"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "tyrell-react",
+  "version": "1.0.0-RC10",
+  "description": "React wrappers for Tyrell Components",
+  "type": "module",
+  "main": "./dist/components/index.js",
+  "types": "./dist/components/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "src/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "generate:version": "node scripts/generate-version.js",
+    "build": "npm run generate:version && tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.66",
+    "@types/react-dom": "^18.2.22",
+    "typescript": "^5.7.0"
+  },
+  "keywords": [
+    "react",
+    "web-components",
+    "typescript",
+    "ui-components",
+    "tyrell",
+    "wrapper",
+    "clojurescript",
+    "reagent",
+    "uix"
+  ],
+  "author": "Gersak <dev@gersak.io>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gersak/tyrell.git",
+    "directory": "packages/react"
+  }
+}

package/src/components/EventConventionTest.tsx

@@ -0,0 +1,155 @@
+/**
+ * Test Example: React Event Convention
+ * 
+ * This file demonstrates the new event handling convention
+ * for tyrell-react components.
+ *
+ * To test:
+ * 1. Create a new React project or use existing
+ * 2. npm install tyrell-react
+ * 3. Add this component to your app
+ * 4. Observe console logs and state updates
+ */
+
+import React, { useState } from 'react';
+import { TyInput } from './TyInput';
+import { TyTextarea } from './TyTextarea';
+import { TyCheckbox } from './TyCheckbox';
+import type { TyInputEventDetail } from './TyInput';
+import type { TyTextareaEventDetail } from './TyTextarea';
+import type { TyCheckboxEventDetail } from './TyCheckbox';
+
+export function EventConventionTest() {
+  const [inputValue, setInputValue] = useState('');
+  const [textareaValue, setTextareaValue] = useState('');
+  const [checked, setChecked] = useState(false);
+  const [logs, setLogs] = useState<string[]>([]);
+
+  const addLog = (message: string) => {
+    setLogs(prev => [...prev, `${new Date().toLocaleTimeString()}: ${message}`]);
+  };
+
+  return (
+    <div className="p-8 space-y-6 max-w-2xl">
+      <h1 className="text-2xl font-bold">React Event Convention Test</h1>
+      
+      {/* Input Test */}
+      <div className="space-y-2">
+        <h2 className="text-lg font-semibold">TyInput Test</h2>
+        <TyInput
+          label="Email"
+          placeholder="Type to test onChange..."
+          value={inputValue}
+          onChange={(e: CustomEvent<TyInputEventDetail>) => {
+            setInputValue(e.detail.value);
+            addLog(`onChange: "${e.detail.value}" (fires on keystroke)`);
+          }}
+          onChangeCommit={(e: CustomEvent<TyInputEventDetail>) => {
+            addLog(`onChangeCommit: "${e.detail.value}" (fires on blur)`);
+          }}
+          onFocus={() => addLog('onFocus')}
+          onBlur={() => addLog('onBlur')}
+        />
+        <p className="text-sm text-gray-600">
+          Current value: <strong>{inputValue}</strong>
+        </p>
+      </div>
+
+      {/* Textarea Test */}
+      <div className="space-y-2">
+        <h2 className="text-lg font-semibold">TyTextarea Test</h2>
+        <TyTextarea
+          label="Comments"
+          placeholder="Type to test onChange..."
+          value={textareaValue}
+          rows={3}
+          onChange={(e: CustomEvent<TyTextareaEventDetail>) => {
+            setTextareaValue(e.detail.value);
+            addLog(`Textarea onChange: "${e.detail.value}"`);
+          }}
+          onChangeCommit={(e: CustomEvent<TyTextareaEventDetail>) => {
+            addLog(`Textarea onChangeCommit: "${e.detail.value}"`);
+          }}
+        />
+        <p className="text-sm text-gray-600">
+          Current value: <strong>{textareaValue}</strong>
+        </p>
+      </div>
+
+      {/* Checkbox Test */}
+      <div className="space-y-2">
+        <h2 className="text-lg font-semibold">TyCheckbox Test</h2>
+        <TyCheckbox
+          checked={checked}
+          onChange={(e: CustomEvent<TyCheckboxEventDetail>) => {
+            setChecked(e.detail.checked);
+            addLog(`Checkbox onChange: ${e.detail.checked} (fires immediately)`);
+          }}
+          onChangeCommit={(e: CustomEvent<TyCheckboxEventDetail>) => {
+            addLog(`Checkbox onChangeCommit: ${e.detail.checked} (fires on blur)`);
+          }}
+        >
+          Subscribe to newsletter
+        </TyCheckbox>
+        <p className="text-sm text-gray-600">
+          Current state: <strong>{checked ? 'Checked' : 'Unchecked'}</strong>
+        </p>
+      </div>
+
+      {/* Event Log */}
+      <div className="space-y-2">
+        <h2 className="text-lg font-semibold">Event Log</h2>
+        <div className="bg-gray-100 p-4 rounded max-h-64 overflow-y-auto font-mono text-xs">
+          {logs.length === 0 ? (
+            <p className="text-gray-500">No events yet. Start typing or checking boxes!</p>
+          ) : (
+            logs.map((log, i) => (
+              <div key={i} className="text-gray-800">
+                {log}
+              </div>
+            ))
+          )}
+        </div>
+        <button
+          onClick={() => setLogs([])}
+          className="px-4 py-2 bg-gray-200 rounded hover:bg-gray-300"
+        >
+          Clear Log
+        </button>
+      </div>
+
+      {/* Expected Behavior */}
+      <div className="bg-blue-50 p-4 rounded">
+        <h3 className="font-semibold mb-2">Expected Behavior:</h3>
+        <ul className="list-disc list-inside space-y-1 text-sm">
+          <li>
+            <strong>onChange</strong> - Fires on every keystroke/state change (React convention)
+          </li>
+          <li>
+            <strong>onChangeCommit</strong> - Fires on blur if value changed (optional)
+          </li>
+          <li>
+            <strong>onFocus</strong> - Fires when element gains focus
+          </li>
+          <li>
+            <strong>onBlur</strong> - Fires when element loses focus
+          </li>
+        </ul>
+      </div>
+
+      {/* Verification */}
+      <div className="bg-green-50 p-4 rounded">
+        <h3 className="font-semibold mb-2">Verification Checklist:</h3>
+        <ul className="list-disc list-inside space-y-1 text-sm">
+          <li>✅ onChange fires on EVERY keystroke (not just on blur)</li>
+          <li>✅ State updates in real-time as you type</li>
+          <li>✅ onChangeCommit fires ONLY on blur (if value changed)</li>
+          <li>✅ Event order: onChange → onBlur → onChangeCommit</li>
+          <li>✅ Checkbox onChange fires immediately on click</li>
+        </ul>
+      </div>
+    </div>
+  );
+}
+
+export default EventConventionTest;

package/src/components/TyButton.tsx

@@ -0,0 +1,157 @@
+import React, { useEffect, useRef } from 'react';
+import { useBooleanProperty } from '../utils/use-boolean-prop';
+
+type BuiltinFlavor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'neutral';
+type ShadedFlavor = BuiltinFlavor | `${BuiltinFlavor}+` | `${BuiltinFlavor}-`;
+type ButtonAppearance = 'solid' | 'outlined' | 'ghost';
+
+export interface TyButtonCSSProperties extends React.CSSProperties {
+  '--ty-button-bg'?: string;
+  '--ty-button-bg-hover'?: string;
+  '--ty-button-color'?: string;
+  '--ty-button-border'?: string;
+}
+
+export interface TyButtonProps extends Omit<React.HTMLAttributes<HTMLElement>, 'style'> {
+  style?: TyButtonCSSProperties;
+  /**
+   * Semantic styling variant. Built-in flavors get themed styles; append `+`
+   * for a stronger shade or `-` for a softer one (e.g. `"primary+"`,
+   * `"danger-"`). Any other string is passed through as-is — theme it via
+   * `--ty-button-*` CSS variables.
+   */
+  flavor?: ShadedFlavor | (string & {});
+
+  /**
+   * Visual appearance:
+   * - `"solid"` (default) — saturated brand fill with paired text color
+   * - `"outlined"` — transparent background, text === border
+   * - `"ghost"` — text only with hover background
+   */
+  appearance?: ButtonAppearance;
+
+  /** Button size */
+  size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+
+  /** Button type for form submission */
+  type?: 'button' | 'submit' | 'reset';
+
+  /** Disable the button */
+  disabled?: boolean;
+
+  /** Loading state — shows a centered spinner, blocks click, preserves width */
+  loading?: boolean;
+
+  /** Pill-shaped button (rounded ends) */
+  pill?: boolean;
+
+  /** Action (icon-only square) */
+  action?: boolean;
+
+  /** Accessible label for screen readers */
+  label?: string;
+
+  /** Form field name for form submission */
+  name?: string;
+
+  /** Form field value for form submission */
+  value?: string;
+
+  /** Full-width button */
+  wide?: boolean;
+
+  /** Button content */
+  children?: React.ReactNode;
+}
+
+export const TyButton = React.forwardRef<HTMLElement, TyButtonProps>(
+  ({
+    children,
+    type,
+    appearance,
+    disabled,
+    loading,
+    pill,
+    action,
+    wide,
+    label,
+    name,
+    value,
+    onClick,
+    ...props
+  }, ref) => {
+    const elementRef = useRef<HTMLElement>(null);
+
+    // Imperatively attach the click listener so onClick reliably fires for the
+    // CustomEvent('click') that <ty-button> re-dispatches on its host (the
+    // inner <button> calls stopPropagation, so React's delegated onClick can
+    // miss it). Also handles type=submit by dispatching a synthetic submit.
+    useEffect(() => {
+      const element = elementRef.current;
+      if (!element) return;
+
+      const handler = (event: Event) => {
+        if (type === 'submit') {
+          const form = element.closest('form');
+          if (form) {
+            event.preventDefault();
+            event.stopPropagation();
+            form.dispatchEvent(new Event('submit', {
+              bubbles: true,
+              cancelable: true,
+            }));
+          }
+        }
+        if (onClick) {
+          onClick(event as unknown as React.MouseEvent<HTMLElement>);
+        }
+      };
+
+      element.addEventListener('click', handler);
+      return () => {
+        element.removeEventListener('click', handler);
+      };
+    }, [type, onClick]);
+
+    useEffect(() => {
+      if (ref && elementRef.current) {
+        if (typeof ref === 'function') {
+          ref(elementRef.current);
+        } else {
+          ref.current = elementRef.current;
+        }
+      }
+    }, [ref]);
+
+    const isDisabled = useBooleanProperty(elementRef, 'disabled', disabled);
+    const isLoading = useBooleanProperty(elementRef, 'loading', loading);
+    const isPill = useBooleanProperty(elementRef, 'pill', pill);
+    const isAction = useBooleanProperty(elementRef, 'action', action);
+    const isWide = useBooleanProperty(elementRef, 'wide', wide);
+
+    const webComponentProps: Record<string, any> = {
+      ...props,
+      ref: elementRef,
+    };
+
+    if (isDisabled) webComponentProps.disabled = '';
+    if (isLoading) webComponentProps.loading = '';
+    if (isPill) webComponentProps.pill = '';
+    if (isAction) webComponentProps.action = '';
+    if (isWide) webComponentProps.wide = '';
+
+    if (appearance) webComponentProps.appearance = appearance;
+    if (type) webComponentProps.type = type;
+    if (label) webComponentProps.label = label;
+    if (name) webComponentProps.name = name;
+    if (value) webComponentProps.value = value;
+
+    return React.createElement(
+      'ty-button',
+      webComponentProps,
+      children
+    );
+  }
+);
+
+TyButton.displayName = 'TyButton';