udi-yac 0.1.0

package/dist/utils/specMutations.d.ts

@@ -0,0 +1,45 @@
+import { UDIGrammar } from 'udi-toolkit/react';
+/**
+ * Return a new spec with every mapping whose `encoding` matches `encoding`
+ * rewritten to use `newField`. All other parts of the spec — including
+ * mappings on different encodings, transformation pipelines, source.name,
+ * and named filters — are left untouched.
+ *
+ * Replaces the historical string-replace approach (`JSON.stringify(spec)
+ * .replace(/"oldField"/g, '"newField"')`), which had three problems:
+ *   1. It updated EVERY occurrence of the string, so two encodings bound to
+ *      the same field (e.g. a density plot with both axes on `age_value`)
+ *      would change together when only one was meant to.
+ *   2. It silently rewrote transformations and source references that
+ *      happened to mention the field by name.
+ *   3. The regex was unescaped — field names containing `.` (e.g.
+ *      `donor.hubmap_id`) matched arbitrary characters, causing collisions.
+ *
+ * If `encoding` is not present in any layer's mapping, returns the original
+ * spec object unchanged so callers can compare by reference to detect no-ops.
+ */
+export declare function setMappingFieldByEncoding(spec: UDIGrammar, encoding: string, newField: string): UDIGrammar;
+/**
+ * Collect the set of source-field names that are referenced by any
+ * schema-defining operator in `spec.transformation`. A mapping whose
+ * `field` belongs to this set should not be offered as tweakable — swapping
+ * it via VizTweak would leave the transformation pipeline referencing the
+ * old field while the mapping points at a new field that the pipeline's
+ * output no longer contains, producing a silently-broken chart.
+ *
+ * Schema-defining operators — covered here:
+ *   groupby   row keys of the output
+ *   binby     `.field` becomes bin input; output replaces the row schema
+ *   rollup    each aggregation's `.field` is an input to the op; when a
+ *             mapping references that same field elsewhere, orphaning it
+ *             breaks the rollup
+ *   kde       `.field` is the density-estimation input
+ *   join      `.on` fields define the join key
+ *
+ * Schema-preserving / free-form operators — skipped intentionally:
+ *   filter    string expression; row-count-only effect, schema unchanged
+ *   orderby   sort only; schema unchanged
+ *   derive    only creates new output fields; expressions are opaque strings
+ *             (would need a parser to extract source-field references safely)
+ */
+export declare function collectLockedFields(spec: UDIGrammar): Set<string>;

package/dist/utils/specMutations.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "udi-yac",
+  "version": "0.1.0",
+  "description": "React implementation of the Universal Discovery Interface (UDI) chat — natural-language querying and visualization of biomedical datasets. Publishable as a library (`UDIChat` component) or as a standalone SPA.",
+  "keywords": [
+    "udi",
+    "udi-yac",
+    "udi-chat",
+    "react",
+    "visualization",
+    "vega-lite",
+    "biomedical",
+    "hubmap",
+    "llm",
+    "chat"
+  ],
+  "homepage": "https://github.com/NickAkhmetov/udi-chat-react#readme",
+  "bugs": {
+    "url": "https://github.com/NickAkhmetov/udi-chat-react/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NickAkhmetov/udi-chat-react.git"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/udi-yac.js",
+  "module": "dist/udi-yac.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/udi-yac.js"
+    },
+    "./style.css": "./dist/udi-yac.css"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "build:lib": "tsc -b && vite build --mode lib",
+    "typecheck": "tsc -b --noEmit",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "preview": "vite preview",
+    "prepare": "husky"
+  },
+  "packageManager": "pnpm@10.27.0",
+  "lint-staged": {
+    "*.{ts,tsx,js,jsx,json,css,md,html,yaml,yml}": "prettier --write"
+  },
+  "dependencies": {
+    "@base-ui/react": "^1.3.0",
+    "@fontsource-variable/geist": "^5.2.8",
+    "arquero": "^8.0.3",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "jszip": "^3.10.1",
+    "lucide-react": "^1.7.0",
+    "lz-string": "^1.5.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-markdown": "^10.1.0",
+    "shadcn": "^4.1.2",
+    "tailwind-merge": "^3.5.0",
+    "tw-animate-css": "^1.4.0",
+    "udi-toolkit": "^0.0.55",
+    "zustand": "^5.0.12"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@tailwindcss/vite": "^4.2.2",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.1.0",
+    "@testing-library/user-event": "^14.5.2",
+    "@types/lz-string": "^1.5.0",
+    "@types/node": "^24.12.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "eslint": "^9.39.4",
+    "eslint-plugin-project-structure": "^3.14.3",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "globals": "^17.4.0",
+    "husky": "^9.1.7",
+    "jsdom": "^25.0.1",
+    "lint-staged": "^16.4.0",
+    "prettier": "^3.4.2",
+    "tailwindcss": "^4.2.2",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.57.0",
+    "vite": "^8.0.1",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^2.1.8"
+  }
+}