@justai/cuts 0.43.0 → 0.44.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@justai/cuts",
3
- "version": "0.43.0",
3
+ "version": "0.44.0",
4
4
  "description": "A persona's named parts — the page shell that holds them, and the cuts themselves.",
5
5
  "license": "UNLICENSED",
6
6
  "repository": {
@@ -24,7 +24,8 @@
24
24
  "./ground.css": "./src/ground.css",
25
25
  "./FilePicker.astro": "./src/FilePicker.astro",
26
26
  "./ActionList.astro": "./src/ActionList.astro",
27
- "./ActionRow.astro": "./src/ActionRow.astro"
27
+ "./ActionRow.astro": "./src/ActionRow.astro",
28
+ "./Files.astro": "./src/FilePicker.astro"
28
29
  },
29
30
  "peerDependencies": {
30
31
  "astro": ">=5"
@@ -49,8 +49,19 @@ import Sheet from "./Sheet.astro";
49
49
  *
50
50
  * One element rather than two cuts, because it is one room: two frames would be two documents,
51
51
  * two atrium routers and two copies of the same kernel open at once, to ask the same file system
52
- * a question in each direction. The name stays `FilePicker` for now and that is a small debt —
53
- * what it actually is, is the persona's door to its files.
52
+ * a question in each direction.
53
+ *
54
+ * ── THE NAME (settled 2026-07-27) ────────────────────────────────────────────────────────────
55
+ *
56
+ * It was called `FilePicker` when picking was all it did, and by the time it could pick, save and
57
+ * read, the name described a third of it. A name that has to be explained is a name that is wrong:
58
+ * a builder reading "picker" in the catalogue has no reason to look here for saving.
59
+ *
60
+ * So it is exported as **`Files.astro`** — the persona's door to its files, which is what it is.
61
+ * `FilePicker.astro` still resolves to the same component and always will: eleven personas import
62
+ * it under that name, and breaking them to correct a word would be charging the fleet for the
63
+ * ecosystem's own late naming. An alias costs one line in `exports`; a rename costs eleven repos,
64
+ * eleven deploys, and one of them forgotten. New consumers import `Files`.
54
65
  *
55
66
  * A method on the element rather than a global, so two pickers on one page are two pickers and
56
67
  * nothing has to be coordinated through a name only one of them can own.