@svadmin/ui 0.72.0 → 0.73.0

package/README.md

@@ -4,36 +4,48 @@ Svelte 5 admin components using semantic design tokens and Bits UI primitives.
 
 ## CSS Integration
 
-For a host without Tailwind, import the precompiled stylesheet once:
+Import the precompiled stylesheet once:
 
 ```ts
 import '@svadmin/ui/app.css';
 ```
 
-No Tailwind plugin is required in that host. Both component styles and the
-transitional utility aliases are compiled into the published stylesheet.
+Consumers do not need Tailwind or Panda. Both component styles and the existing
+utility aliases are included in the published native stylesheet. Theme overrides
+continue to use public semantic CSS variables; nested themes use `.svadmin-theme`.
 
-For a Tailwind v4 host that also generates its own utilities:
+`app.theme.css` is retained as a native-CSS alias of `app.css`. It no longer
+emits compiler metadata. Import one UI CSS entry, not both. Old host `@source`
+directives can be removed; styles are pre-generated, not scanned at consumption.
 
-```css
-@import "tailwindcss";
-@import "@svadmin/ui/app.theme.css";
-```
+## Migration Boundary
 
-The theme entry includes the same precompiled component styles, plus the
-semantic `@theme` metadata. Import one SVAdmin CSS entry, not both.
-Theme overrides use semantic CSS variables; nested themes use `.svadmin-theme`.
+Tailwind, its Vite plugin and animation compiler are no longer build dependencies.
+Panda is a development dependency for the new semantic tokens and slot recipes;
+its runtime class helpers and type declarations do not import the compiler.
 
-## Migration Boundary
+Existing `svadmin-u-*` aliases, animation rules and compiled `--tw-*` variables
+remain native compatibility CSS. Do not rename or delete them mechanically.
+New styles should use native CSS or reviewed Panda recipes, not new uncompiled
+Tailwind class strings. This is not a wholesale rewrite of every UI component.
+
+Button, Badge, Input and Textarea now select pre-generated Panda recipes. Their
+public props, bindings, semantic class markers and null-variant semantics remain
+compatible. Migrated instances are excluded from the old primitive defaults at
+CSS publication time; the original compatibility snapshot is not rewritten.
+Primitive recipes stay in the `components` layer so consumer overrides keep their
+priority. Shared theme/focus rules and unmigrated components remain native CSS.
 
-Tailwind and its animation helpers remain build-time tools. The UI package no
-longer declares `tailwind-variants` or `tailwind-merge` as runtime dependencies.
-The source still contains transitional utility aliases; this is not a complete
-rewrite to hand-authored CSS.
+The strict repository check also rejects helper packages (`tailwind-merge`,
+`tailwind-variants`) and the shadcn-svelte generator, including transitive lockfile
+entries. **The current Streamdown dependency still brings `tailwind-merge`; the
+strict check intentionally fails until a behavior-preserving replacement is
+verified. Do not describe this migration as fully complete.**
 
-The public variant helpers return semantic classes for class-only composition.
-Components also expose variant and size data attributes. Primitive defaults
-live in the `components` layer so host utilities can override them.
+The initial `surfaceMetric` and `surfaceTable` recipes pre-generate every public
+variant. Surface applications opt into `styledSurfaceCatalog` and load
+`@svadmin/surface/styles.css`; see the Surface package's `STYLING.md`. Default
+Surface v1 props and the no-variant rendering path stay unchanged.
 
 ## Validation
 
@@ -43,10 +55,13 @@ bun run test
 bun run test:css
 ```
 
-The CSS tests inspect both published entries, require coverage for every
-migrated utility alias referenced by components, compile a Tailwind host, and
-verify that postprocessing is idempotent.
+CSS tests pin the original native compatibility rule tree, declarations and
+cascade order, check every referenced utility alias, verify the declarations for
+all styled recipe slots and variants, and exercise a deliberately missing rule.
+They also check nested layer flattening, isolation of generated CSS variables,
+postbuild idempotence and both public stylesheet entries.
 
-The utility migration script is an explicit maintenance operation, not a build
-step. It validates the full input set before writing and leaves dynamic
-template fragments unchanged for manual review.
+The repository's Panda compatibility workflow additionally checks strict Surface
+types, generated helpers in a dependency-free consumer, and Chromium screenshot
+and computed-style comparisons. Its viewport/theme matrix uses actual Svelte
+components; it is not a claim of full-application or cross-browser coverage.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,52 @@
+# Static CSS compatibility notices
+
+The compatibility CSS was generated once from cf6c4746578176ea773a17ef6f49f353292f7818; no compiler is required by the package. Upstream license notices are retained below.
+
+## tailwindcss
+
+MIT License
+
+Copyright (c) Tailwind Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+## tw-animate-css
+
+MIT License
+
+Copyright (c) 2025 Wombosvideo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.