@tenerife.music/ui 3.0.4 → 3.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -3,14 +3,14 @@
3
3
  **Token-driven UI architecture for long-living React products**
4
4
  Predictable. Built for system-level consistency.
5
5
 
6
- ![Release](https://img.shields.io/badge/release-v3.0.0-blue?style=for-the-badge)
7
- ![npm version](https://img.shields.io/badge/npm-v3.0.0-blue?style=for-the-badge)
6
+ ![Release](https://img.shields.io/badge/release-v3.1.0-blue?style=for-the-badge)
7
+ ![npm version](https://img.shields.io/badge/npm-v3.1.0-blue?style=for-the-badge)
8
8
  ![React](https://img.shields.io/badge/React-18+-blue?style=for-the-badge)
9
9
  ![TypeScript](https://img.shields.io/badge/TypeScript-Strict-blue?style=for-the-badge)
10
10
  ![TailwindCSS](https://img.shields.io/badge/TailwindCSS-3.4-38b2ac?style=for-the-badge)
11
11
  ![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)
12
12
 
13
- **Current Release:** [v3.0.0](CHANGELOG.md#300) (npm)
13
+ **Current Release:** [v3.1.0](CHANGELOG.md#310) (npm)
14
14
  **Next Release:** [Unreleased] — See [CHANGELOG](CHANGELOG.md#unreleased)
15
15
 
16
16
  <p align="center">
@@ -24,6 +24,22 @@ Predictable. Built for system-level consistency.
24
24
  </strong>
25
25
  </p>
26
26
 
27
+ > ⚠️ **Work in Progress / Experimental**
28
+ >
29
+ > `@tenerife.music/ui` is under active development and provided **as is**, without any guarantees of stability.
30
+ >
31
+ > - Public API may change without prior notice
32
+ > - Breaking changes may occur even in minor or patch releases
33
+ > - Component behavior, tokens, and internal contracts may change in non-obvious ways
34
+ > - Documentation may temporarily lag behind implementation
35
+ >
36
+ > **Use at your own risk**, especially in production environments.
37
+
38
+ > **Versioning note**
39
+ >
40
+ > Semantic versioning reflects release coordination, **not API stability**.
41
+ > Minor and patch releases may include breaking changes.
42
+
27
43
  ---
28
44
 
29
45
  ## 🧭 Architectural Manifest
@@ -54,6 +70,11 @@ over quick experimentation or visual convenience.
54
70
 
55
71
  If the system feels strict or limiting — that means it is working as intended.
56
72
 
73
+ **Public API contract**
74
+
75
+ Only exports from the root entry `@tenerife.music/ui` are considered public.
76
+ Deep imports are forbidden and may break without notice.
77
+
57
78
  ---
58
79
 
59
80
  > ⚠️ **Status:** The Foundation layer is locked and stable. Extension components may evolve.
@@ -138,6 +159,7 @@ Storybook is used as an internal visual contract and can be run locally.
138
159
  - **Foundation Lock**: [docs/architecture/FOUNDATION_LOCK.md](docs/architecture/FOUNDATION_LOCK.md)
139
160
  - **Architecture Lock**: [docs/architecture/ARCHITECTURE_LOCK.md](docs/architecture/ARCHITECTURE_LOCK.md)
140
161
  - **A11Y Lock**: [docs/architecture/locks/A11Y_LOCK.md](docs/architecture/locks/A11Y_LOCK.md)
162
+ - **Consumer Layout Guide**: [docs/architecture/closed-system/CONSUMER_LAYOUT_GUIDE.md](docs/architecture/closed-system/CONSUMER_LAYOUT_GUIDE.md)
141
163
 
142
164
  ---
143
165
 
@@ -29,7 +29,7 @@ declare const linkVariants: (props?: ({
29
29
  variant?: "primary" | "secondary" | "accent" | "destructive" | "outline" | "link" | "ghost" | "text" | "wrapper" | null | undefined;
30
30
  size?: "sm" | "md" | "lg" | null | undefined;
31
31
  } & class_variance_authority_types.ClassProp) | undefined) => string;
32
- interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "className" | "style"> {
32
+ interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
33
33
  /**
34
34
  * Link variant style
35
35
  * @default "text"
@@ -29,7 +29,7 @@ declare const linkVariants: (props?: ({
29
29
  variant?: "primary" | "secondary" | "accent" | "destructive" | "outline" | "link" | "ghost" | "text" | "wrapper" | null | undefined;
30
30
  size?: "sm" | "md" | "lg" | null | undefined;
31
31
  } & class_variance_authority_types.ClassProp) | undefined) => string;
32
- interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "className" | "style"> {
32
+ interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
33
33
  /**
34
34
  * Link variant style
35
35
  * @default "text"