@valancex/common 0.14.0 → 0.15.0

package/dist/app.js

@@ -44,6 +44,11 @@ export const checkDefinition = (author) => {
             throw new AppDefinitionError(`src/main.ts: the state field "${name}" is the framework's (which page is shown, and the pages visited); choose another`);
         }
     }
+    for (const [tag, id] of Object.entries(author?.resolve ?? {})) {
+        if (typeof id !== "string" || !/^(@[^/\s]+\/)?[^/\s]+\/[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(id) || id.split("/").at(-1) !== tag) {
+            throw new AppDefinitionError(`src/main.ts: \`resolve\` maps a tag to the qualified id of the component it means, \`${tag}: "package/${tag}"\`; got ${JSON.stringify(id)} for "${tag}"`);
+        }
+    }
     const fields = Object.keys(stateOf(author)?.schema.fields ?? {});
     for (const name of persistedFields(author)) {
         if (!fields.includes(name)) {

package/dist/index.d.ts

@@ -141,6 +141,12 @@ export type UnitCommandSpec<S, P extends Schema.Struct.Fields = Schema.Struct.Fi
     /** Events of the component the command announces to its caller, each with the payload it carries, worked out from the state the command leaves: `{ change: (next) => next.at }`. */
     readonly raises?: Readonly<Record<string, (next: S, args: Schema.Struct.Type<P>) => unknown>>;
 };
+/** A command of a unit as `unit` takes it: any parameters (they are typed where the command is written, with `unitCommand`). */
+type UnitCommandInput<S> = ((state: S) => Changes<S>) | {
+    readonly params?: Schema.Struct.Fields;
+    readonly run: (state: S, args: any) => Changes<S>;
+    readonly raises?: Readonly<Record<string, (next: S, args: any) => unknown>>;
+};
 /** A command with parameters, typed: the parameters' types reach `run` and `raises`. */
 export declare const unitCommand: <S, P extends Schema.Struct.Fields>(spec: {
     readonly params: P;
@@ -165,7 +171,7 @@ export declare const unitCommand: <S, P extends Schema.Struct.Fields>(spec: {
 export declare const unit: <F extends Fields>(definition: {
     readonly state: F;
     readonly commands: {
-        readonly [name: string]: UnitCommandSpec<StateOf<F>, any>;
+        readonly [name: string]: UnitCommandInput<StateOf<F>>;
     };
     readonly controllable?: ReadonlyArray<Extract<keyof F, string>>;
 }) => Valance.Unit<StateOf<F>>;
@@ -202,6 +208,12 @@ export interface AppDefinition<S extends StateInput = {}> {
     readonly components?: ReadonlyArray<Component>;
     /** Built-in components (`heading`, `runs`, …) you replace with your own template of the same name. */
     readonly override?: ReadonlyArray<Component>;
+    /**
+     * Which component a tag means when two share a name (Tier 2: nothing to write until there is a collision). A library's component has the qualified id `package/name` (`acme-ui/disclosure`); two
+     * libraries that both have a `disclosure`, or a library component named like a built-in, are a compile error that names both ids, and `resolve: { disclosure: "acme-ui/disclosure" }` says which one the
+     * tag is. The others are left out of the program, and a library template that writes the tag gets the one chosen. A built-in is replaced by the chosen library component, as `override` would.
+     */
+    readonly resolve?: Readonly<Record<string, string>>;
     /**
      * Application state beyond the page: `{ theme: field(Schema.Literal("light", "dark"), "light") }`. Its fields become names a layout can read. A hand-built `{ schema, initial }` is also accepted, for
      * hydration and shared schemas.

package/dist/primitives.js

@@ -220,7 +220,7 @@ export const declared = {
                 "type": {
                     "kind": "string"
                 },
-                "required": true
+                "required": false
             },
             "id": {
                 "type": {
@@ -237,7 +237,7 @@ export const declared = {
                 "type": {
                     "kind": "string"
                 },
-                "required": true
+                "required": false
             }
         },
         "events": {}
@@ -254,7 +254,7 @@ export const declared = {
                 "type": {
                     "kind": "string"
                 },
-                "required": true
+                "required": false
             }
         },
         "events": {}
@@ -265,7 +265,7 @@ export const declared = {
                 "type": {
                     "kind": "string"
                 },
-                "required": true
+                "required": false
             }
         },
         "events": {}
@@ -320,7 +320,7 @@ export const declared = {
                 "type": {
                     "kind": "string"
                 },
-                "required": true
+                "required": false
             },
             "src": {
                 "type": {
@@ -338,7 +338,7 @@ export const declared = {
                 "type": {
                     "kind": "string"
                 },
-                "required": true
+                "required": false
             }
         },
         "events": {}
@@ -366,13 +366,13 @@ export const declared = {
                 "type": {
                     "kind": "string"
                 },
-                "required": true
+                "required": false
             },
             "current": {
                 "type": {
                     "kind": "string"
                 },
-                "required": true
+                "required": false
             }
         },
         "events": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valancex/common",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "The author's side of a VALANCE application (defineApp, component, field) and the runtime the vlx build runs: the browser and server entries. What src/main.ts imports; @valancex/cli builds what it describes.",
   "keywords": [
     "valance",
@@ -67,8 +67,8 @@
     "@valancex/mesh-runtime": "^0.15.0 || ^0.16.0 || ^0.17.0",
     "@valancex/nexus": "^0.14.0 || ^0.15.0 || ^0.16.0",
     "@valancex/port-web": "^0.12.0 || ^0.13.0 || ^0.14.0",
-    "@valancex/router": "^0.14.0",
-    "@valancex/valance": "^0.14.0"
+    "@valancex/router": "^0.15.0",
+    "@valancex/valance": "^0.15.0"
   },
   "peerDependencies": {
     "effect": "^3.10.0"