@mistriwork/kit 0.0.0-stage → 1.0.0-rc.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Baljinder Randhawa
+
+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.

package/README.md

@@ -1,3 +1,17 @@
-# Temporary Holding Version
+<img src="mark.svg" alt="mistri" width="48" height="48" />
 
-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.
+# @mistriwork/kit
+
+The shared React client both shells, mistri's and tablewalk's, are drawn with:
+the walk and the address, Grid, Value, the record page, lists, filters and
+charts. Its `dist/client` is the page the server sends.
+
+It is a layer of [mistri](https://mistriwork.dev), published so the App
+framework and the database browser (`tablewalk`) serve the same client. Install
+`tablewalk` or `mistri`; this package comes with either.
+[Source](https://github.com/rbaljinder/mistri/tree/main/packages/kit).
+
+This package is internal plumbing for `mistri` and `tablewalk`, with no semver
+promise to an App's author: its `exports` name each module those two import,
+and any of them may change or go in any release. An App imports `mistri`'s
+names (or `tablewalk`'s), never these.

package/dist/clientFiles.d.ts

@@ -0,0 +1,5 @@
+import type { ClientFiles } from '@mistriwork/engine/server/devclient.js';
+/** The page's sources, and the workspace whose Vite serves them. */
+export declare const KIT_CLIENT: Pick<ClientFiles, 'source' | 'workspace'>;
+/** A product's page: the kit's sources, and `built`, the folder its own client build wrote. */
+export declare function clientFiles(built: string): ClientFiles;

package/dist/clientFiles.js

@@ -0,0 +1,21 @@
+/**
+ * Where the page every server sends comes from. The page is the kit's: its index.html, its entry (boot.js) and the
+ * shell, which start whichever product sent the page (shellStart.js). Each product builds it into its own dist/client
+ * — the database browser's with config/vite.tablewalk.config.ts, the App framework's with config/vite.mistri.config.ts, each
+ * without the other's main — and names that build with `clientFiles`; the engine serves whichever files it is handed
+ * (clientHttp.ts, devclient.ts).
+ *
+ * From source — under tsx, in a checkout — Vite serves `source` with the workspace's vite.config.ts, and watches only
+ * the workspace. Built, the page is the product's bundle; a server under tsx sends that one too when
+ * MISTRI_BUILT_CLIENT=1.
+ */
+import { fileURLToPath } from 'node:url';
+/** The page's sources, and the workspace whose Vite serves them. */
+export const KIT_CLIENT = {
+    source: fileURLToPath(new URL('./client/', import.meta.url)),
+    workspace: fileURLToPath(new URL('../../../', import.meta.url)),
+};
+/** A product's page: the kit's sources, and `built`, the folder its own client build wrote. */
+export function clientFiles(built) {
+    return { ...KIT_CLIENT, built };
+}

package/dist/shared/uiTokens.d.ts

@@ -0,0 +1,4 @@
+/** Every token a component may name, theme roles first, then faces, corners and the sheets' own steps. */
+export declare const UI_TOKENS: readonly string[];
+/** The token a name was most likely meant to be: the word another system uses for it, else the nearest spelling. */
+export declare function nearestToken(name: string): string | undefined;

package/dist/shared/uiTokens.js

@@ -0,0 +1,132 @@
+/**
+ * The custom properties a custom component may read: `@mistriwork/mistri/ui` exports
+ * them as `tokens`, and `mistri check` holds a component's `var(--…)` to
+ * them. They are not listed by hand a second time — the theme's roles, faces
+ * and corners are read off the tables the theme wears them from
+ * (themeTokens.ts), so a role added there is a token here. Only the sheets'
+ * own steps (space, type sizes, motion, depth, the larger corners) are named below,
+ * because no theme role carries them.
+ */
+import { FONT_TOKENS, PALETTE_TOKENS, RADIUS_TOKENS } from '@mistriwork/engine/shared/themeTokens.js';
+const SHEET_TOKENS = [
+    '--radius-lg',
+    '--radius-pop',
+    '--radius-panel',
+    '--radius-dialog',
+    '--radius-item',
+    '--type-ui',
+    '--type-display',
+    '--type-list-title',
+    '--type-record-title',
+    '--space-1',
+    '--space-2',
+    '--space-3',
+    '--space-4',
+    '--space-5',
+    '--space-6',
+    '--space-7',
+    '--space-8',
+    '--space-2h',
+    '--space-3h',
+    '--space-4h',
+    '--section-seam',
+    '--page-measure',
+    '--room-inset',
+    '--row-h',
+    '--text-xs',
+    '--text-sm',
+    '--text-base',
+    '--text-md',
+    '--text-lg',
+    '--text-xl',
+    '--heading-weight',
+    '--track-caps',
+    '--track-display',
+    '--track-title',
+    '--t-hover',
+    '--t-press',
+    '--t-popover',
+    '--t-panel',
+    '--ease-out',
+    '--ease-in-out',
+    '--shadow-pop',
+    '--shadow-panel',
+    '--shadow-modal',
+    '--scrim',
+    '--scrim-light',
+    '--focus-width',
+    '--focus-offset',
+];
+/** Every token a component may name, theme roles first, then faces, corners and the sheets' own steps. */
+export const UI_TOKENS = [
+    ...Object.values(PALETTE_TOKENS),
+    ...Object.values(FONT_TOKENS),
+    ...Object.values(RADIUS_TOKENS),
+    ...SHEET_TOKENS,
+];
+/** What a reader reaches for from another system's vocabulary, and the token that says it here. */
+const WORDS = {
+    negative: '--status-critical',
+    danger: '--status-critical',
+    error: '--status-critical',
+    destructive: '--status-critical',
+    red: '--status-critical',
+    positive: '--status-good',
+    success: '--status-good',
+    green: '--status-good',
+    warning: '--status-warning',
+    caution: '--status-warning',
+    info: '--status-info',
+    text: '--ink',
+    foreground: '--ink',
+    fg: '--ink',
+    'text-muted': '--ink-muted',
+    muted: '--ink-muted',
+    secondary: '--ink-muted',
+    subtle: '--ink-subtle',
+    background: '--ground',
+    bg: '--ground',
+    page: '--ground',
+    card: '--surface',
+    panel: '--surface',
+    border: '--line',
+    divider: '--line',
+    primary: '--accent',
+    brand: '--accent',
+    'accent-color': '--accent',
+    font: '--sans',
+    'font-family': '--sans',
+    'font-mono': '--mono',
+    'border-radius': '--radius',
+    rounded: '--radius',
+    // Renamed before 1.0, with `nav.currentInk`: words on a fill are on<Fill>.
+    'nav-current-ink': '--nav-on-current',
+};
+function distance(a, b) {
+    const row = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i++) {
+        let diagonal = row[0];
+        row[0] = i;
+        for (let j = 1; j <= b.length; j++) {
+            const above = row[j];
+            row[j] = Math.min(row[j] + 1, row[j - 1] + 1, diagonal + (a[i - 1] === b[j - 1] ? 0 : 1));
+            diagonal = above;
+        }
+    }
+    return row[b.length];
+}
+/** The token a name was most likely meant to be: the word another system uses for it, else the nearest spelling. */
+export function nearestToken(name) {
+    const bare = name.replace(/^--/, '').toLowerCase();
+    const said = WORDS[bare];
+    if (said)
+        return said;
+    let best;
+    let bestDistance = 3;
+    for (const token of UI_TOKENS) {
+        const gap = distance(bare, token.slice(2));
+        if (gap < bestDistance)
+            [best, bestDistance] = [token, gap];
+    }
+    return best;
+}

package/mark.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><style>.i{fill:#1c1a17}.a{fill:#6b3fd4}@media (prefers-color-scheme:dark){.i{fill:#f2f0ec}.a{fill:#a88bff}}</style><path class="i" d="M2 4H26V18H22V10H18V28H12V10H8V28H2Z"/><rect class="a" x="20" y="20" width="10" height="8"/></svg>

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@mistriwork/kit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-rc.9",
+  "description": "The shared React client both shells are drawn with: the walk and the address, Grid, Value, the record page, lists, filters and charts.",
+  "homepage": "https://mistriwork.dev",
+  "bugs": {
+    "url": "https://github.com/rbaljinder/mistri/issues"
+  },
+  "license": "MIT",
+  "author": "Baljinder Randhawa",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rbaljinder/mistri.git",
+    "directory": "packages/kit"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "mark.svg",
+    "LICENSE"
+  ],
+  "type": "module",
+  "exports": {
+    "./clientFiles.js": "./dist/clientFiles.js",
+    "./shared/uiTokens.js": "./dist/shared/uiTokens.js",
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@mistriwork/engine": "1.0.0-rc.9",
+    "@mistriwork/ui": "1.0.0-rc.9",
+    "intl-messageformat": "12.1.2",
+    "qrcode-generator": "^2.0.4"
+  },
+  "engines": {
+    "node": ">=24.22.1"
+  }
+}