@pieai/swimmer-ui-kit 2.13.0 → 3.0.0-rc.1

package/dist/tailwind.css

@@ -19,16 +19,18 @@
   --font-sans: var(--game-ui-font-body);
   --color-background: var(--game-ui-bg);
   --color-foreground: var(--game-ui-text);
-  --color-card: var(--game-ui-panel);
+  --color-card: var(--game-ui-surface);
+  --color-popover: var(--game-ui-surface-raised);
+  --color-popover-foreground: var(--game-ui-text);
   --color-card-foreground: var(--game-ui-text);
-  --color-muted: var(--game-ui-surface);
+  --color-muted: var(--game-ui-surface-sunken);
   --color-muted-foreground: var(--game-ui-text-muted);
   --color-primary: var(--game-ui-accent);
   --color-primary-foreground: var(--game-ui-accent-contrast);
   --color-secondary: var(--game-ui-secondary);
   --color-secondary-foreground: var(--game-ui-accent-contrast);
   --color-border: var(--game-ui-border-subtle);
-  --color-input: var(--game-ui-surface-raised);
+  --color-input: var(--game-ui-surface-sunken);
   --color-ring: var(--game-ui-focus-ring);
   --radius-sm: var(--game-ui-radius-control);
   --radius-md: var(--game-ui-radius-card);

package/donors-individual.md

@@ -26,7 +26,7 @@ never a checkout from `_Donors-Individual/for_SwimmerUIKit/`.
 The current SwimmerUIKit implementation is local code; no upstream files are
 vendored or imported at runtime. The reviewed scope is the donor
 package's `README.md`, `package.json`, `LICENSE`, and `src/**` so the kit can
-trace the retained implementation in `src/LiquidGroup.tsx` and its supporting
+trace the retained implementation in `src/liquid/LiquidGroup/LiquidGroup.tsx` and its supporting
 modules.
 
 Patterns retained in the local implementation are the SVG
@@ -48,7 +48,7 @@ blur. The silhouette also sets `will-change: filter, transform` so WebKit
 promotes the CSS-filtered layer.
 
 SwimmerUIKit also adapts the donor's pairwise image-melt engine into
-`src/liquidGooeyImageMelt.tsx`. That module carries the first two
+`src/liquid-effects/melt/`. That module carries the first two
 `effect="melt"` images, the two-palette colour/marbling pass, and the
 image-only contact `dissolve` layer. The dissolve math is a scoped adaptation
 of the donor's contact-observer behavior; it is not a transplant of the
@@ -140,6 +140,10 @@ data instead. That is a divergence from the donor, not a defect in it — the
 donor's own demos use waviness on large, merging bodies where a pixel of
 contour noise is invisible.
 
+### 3.0 package boundaries
+
+The adopted Bend math lives in `src/liquid-effects/bend/`; image melt and dissolve live in `src/liquid-effects/melt/`. Only `./liquid-effects` exposes them. The core engine supplies a typed internal deformation seam and continues to own measurement, clocks and budgets. This is a local ownership split, not an upstream pin update. The default package and presence leaf do not contain optional effect implementations.
+
 ### Update policy
 
 This donor is pinned for manual review and provenance only. It must not be
@@ -155,3 +159,18 @@ runtime.
 4. If the reviewed scope or adopted patterns change, update this file,
    `donors-individual-lock.json`, and `NOTICE` in the same change, then run the normal
    package verification ladder.
+
+## Inline icon geometry
+
+The 48 semantic GameIcon shapes come from Lucide 1.51.0 (ISC and Feather-derived MIT).
+Exact archive and per-icon source hashes are owned by `scripts/game-icons-source.json`;
+`generate-game-icons.py` rejects any changed source. The temporary source download is
+not packaged. Only reviewed path data is shipped, with the complete license in NOTICE.
+
+## Default Chinese font
+
+Resource Han Rounded CN v0.990 is redistributed as deterministic Unicode-range
+subsets named Swimmer Rounded CN, with original copyright and OFL1.1 intact.
+The upstream Reserved Font Name is Source. Machine-readable source and tool pins
+live only in scripts/zh-font-source.json; output hashes live with fonts/zh.
+Normal builds use committed WOFF2 files; they never fetch or recut a font.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pieai/swimmer-ui-kit",
-  "version": "2.13.0",
+  "version": "3.0.0-rc.1",
   "description": "Token-driven React game UI kit for web and wrapped PieAI game surfaces.",
   "keywords": [
     "design-system",
@@ -20,7 +20,6 @@
     "url": "git+https://github.com/PieAIStudio/SwimmerUIKit.git"
   },
   "bin": {
-    "swimmer-ui-assets": "./bin/swimmer-ui-assets.mjs",
     "swimmer-ui-check": "./bin/swimmer-ui-check.mjs"
   },
   "files": [
@@ -47,12 +46,23 @@
       "default": "./dist/liquid-presence.js"
     },
     "./liquid-presence.css": "./dist/liquid-presence.css",
-    "./assets/*": "./dist/assets/*",
+    "./liquid-effects": {
+      "types": "./dist/liquid-effects.d.ts",
+      "default": "./dist/liquid-effects.js"
+    },
+    "./preview": {
+      "types": "./dist/preview.d.ts",
+      "default": "./dist/preview.js"
+    },
     "./styles.css": "./dist/styles.css",
     "./preview.css": "./dist/preview.css",
     "./fonts.css": "./dist/fonts.css",
     "./tailwind.css": "./dist/tailwind.css",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./icon-paths": {
+      "types": "./dist/icon-paths.d.ts",
+      "default": "./dist/icon-paths.js"
+    }
   },
   "publishConfig": {
     "access": "public",
@@ -82,6 +92,7 @@
     "oxfmt": "0.58.0",
     "oxlint": "1.73.0",
     "playwright": "1.61.1",
+    "postcss": "8.5.18",
     "react": "19.2.7",
     "react-dom": "19.2.7",
     "storybook": "10.5.0",
@@ -102,10 +113,13 @@
     "check:account-controls": "node scripts/verify-account-controls.mjs",
     "dev": "vite --host 127.0.0.1 --port 5174",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "lint": "oxlint src preview .storybook bin scripts vite.config.ts vite.config.site.ts vitest.config.ts -c ./.oxlintrc.json",
-    "format": "oxfmt package.json tsconfig.json tsconfig.build.json src preview .storybook bin scripts vite.config.ts vite.config.site.ts vitest.config.ts --write --ignore-path ./.oxfmtignore",
-    "format:check": "oxfmt package.json tsconfig.json tsconfig.build.json src preview .storybook bin scripts vite.config.ts vite.config.site.ts vitest.config.ts --check --ignore-path ./.oxfmtignore",
-    "verify": "pnpm typecheck && pnpm lint && pnpm format:check && pnpm api:check && pnpm test && pnpm check:styles && pnpm build",
+    "lint": "oxlint src preview tests types .storybook bin scripts vite.config.ts vite.config.site.ts vitest.config.ts -c ./.oxlintrc.json",
+    "format": "oxfmt package.json tsconfig.json tsconfig.build.json src preview tests types .storybook bin scripts vite.config.ts vite.config.site.ts vitest.config.ts --write --ignore-path ./.oxfmtignore",
+    "format:check": "oxfmt package.json tsconfig.json tsconfig.build.json src preview tests types .storybook bin scripts vite.config.ts vite.config.site.ts vitest.config.ts --check --ignore-path ./.oxfmtignore",
+    "verify": "pnpm typecheck && pnpm lint && pnpm format:check && pnpm api:check && pnpm check:guide && pnpm test && pnpm check:styles && pnpm check:themes && pnpm build && pnpm check:fonts",
+    "check:themes": "node scripts/check-control-styles.mjs",
+    "check:packed": "node scripts/verify-packed-candidate.mjs",
+    "check:next-consumer": "node scripts/check-next-consumer.mjs",
     "api:inventory": "node scripts/public-api-audit.mjs --write",
     "api:check": "node scripts/public-api-audit.mjs --check",
     "build": "vite build && node scripts/build-css.mjs && node scripts/finalize-dist.mjs && node scripts/check-warnings-survive-build.mjs",
@@ -118,6 +132,8 @@
     "doc-gov": "doc-gov",
     "pro-gov": "pro-gov",
     "docs:check": "pnpm pro-gov doctor --strict-hooks && pnpm doc-gov router-check && pnpm doc-gov check && pnpm doc-gov scan --check && pnpm doc-gov links && pnpm doc-gov audit && pnpm doc-gov doctor",
-    "check:styles": "node bin/swimmer-ui-check.mjs src"
+    "check:styles": "node bin/swimmer-ui-check.mjs src",
+    "check:guide": "node scripts/check-guide.mjs",
+    "check:fonts": "node scripts/check-fonts.mjs"
   }
 }

package/bin/swimmer-ui-assets.mjs

@@ -1,83 +0,0 @@
-#!/usr/bin/env node
-// Copy the sculpted clay asset set out of the package and into a directory the
-// consuming app actually serves.
-//
-// The kit resolves sculpted icons to absolute URLs under CLAY_ASSET_BASE_PATH
-// ('/assets/game/ui/clay/…'), which is a path on the *host's* origin. The files
-// themselves ship inside the package, in dist/assets. Nothing was closing that
-// gap, so every consumer had to discover it, and the default placeholder mode
-// meant the failure looked like a design choice rather than a missing step.
-//
-// Usage: swimmer-ui-assets [targetDir] [--base=/assets/game/ui/clay/...] [--force]
-//   targetDir  where the host serves static files from. Default "public".
-//   --base     the URL path to mirror under targetDir. Defaults to the kit's
-//              CLAY_ASSET_BASE_PATH, which is what setClayAssetMode('source')
-//              expects with no further configuration.
-//   --force    overwrite files that already exist (default: skip them).
-//
-// After running this, call setClayAssetMode('source') once at your app entry.
-import { cpSync, existsSync, mkdirSync, readdirSync, statSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const DEFAULT_BASE = '/assets/game/ui/clay/phase03-clay-kit';
-const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
-
-const args = process.argv.slice(2);
-const flags = new Set(args.filter((a) => a.startsWith('--')));
-const positional = args.filter((a) => !a.startsWith('--'));
-
-// Two different paths that are easy to conflate: where the files sit inside
-// this package (fixed, mirrors the default URL under dist/) and where the host
-// will serve them from (--base, defaults to the same thing so the common case
-// needs no configuration).
-const trim = (p) => p.replace(/^\/+|\/+$/g, '');
-const baseFlag = args.find((a) => a.startsWith('--base='));
-const servedBase = trim(baseFlag ? baseFlag.slice('--base='.length) : DEFAULT_BASE);
-const targetRoot = resolve(process.cwd(), positional[0] ?? 'public');
-const force = flags.has('--force');
-
-const source = join(packageRoot, 'dist', trim(DEFAULT_BASE));
-if (!existsSync(source)) {
-  console.error(`swimmer-ui-assets: nothing to copy — ${source} does not exist.`);
-  console.error('This package may have been installed without its dist/assets tree.');
-  process.exit(1);
-}
-
-const destination = join(targetRoot, servedBase);
-
-function count(dir) {
-  let files = 0;
-  let bytes = 0;
-  for (const entry of readdirSync(dir)) {
-    const full = join(dir, entry);
-    const stat = statSync(full);
-    if (stat.isDirectory()) {
-      const inner = count(full);
-      files += inner.files;
-      bytes += inner.bytes;
-    } else {
-      files += 1;
-      bytes += stat.size;
-    }
-  }
-  return { files, bytes };
-}
-
-const { files, bytes } = count(source);
-
-mkdirSync(dirname(destination), { recursive: true });
-cpSync(source, destination, { recursive: true, force, errorOnExist: false });
-
-const megabytes = (bytes / 1024 / 1024).toFixed(1);
-console.log(`swimmer-ui-assets: copied ${files} files (${megabytes} MB)`);
-console.log(`  from  ${source}`);
-console.log(`  to    ${destination}`);
-console.log('');
-console.log('Now call this once at your app entry, or the kit keeps drawing placeholders:');
-console.log("  import { setClayAssetMode } from '@pieai/swimmer-ui-kit';");
-console.log("  setClayAssetMode('source');");
-if (!force) {
-  console.log('');
-  console.log('Existing files were left alone. Re-run with --force to overwrite.');
-}