@jxsuite/schema 1.9.0 → 2.0.0

package/README.md

@@ -44,12 +44,12 @@ const valid = await validateDocument(doc); // validate a Jx document
 
 ## Component schema coverage
 
-- **`tagName`** — all standard HTML element names from `@webref/elements`
-- **Element properties** — all DOM IDL properties from `@webref/idl`
-- **`style`** — all CSSOM camelCase properties from `@webref/css`
-- **Event handlers** — all `EventHandler` names (`onclick`, `oninput`, …)
-- **`state` shapes** — naked value, typed value, computed, function, external class
-- **Built-in `$prototype` values** — `Request`, `LocalStorage`, `SessionStorage`, `Cookie`, `IndexedDB`, `Array`, `Set`, `Map`, `Blob`, `ReadableStream`, `URLSearchParams`, `FormData`
+- **`tagName`**: all standard HTML element names from `@webref/elements`
+- **Element properties**: all DOM IDL properties from `@webref/idl`
+- **`style`**: all CSSOM camelCase properties from `@webref/css`
+- **Event handlers**: all `EventHandler` names (`onclick`, `oninput`, …)
+- **`state` shapes**: naked value, typed value, computed, function, external class
+- **Built-in `$prototype` values**: `Request`, `LocalStorage`, `SessionStorage`, `Cookie`, `IndexedDB`, `Array`, `Set`, `Map`, `Blob`, `ReadableStream`, `URLSearchParams`, `FormData`
 
 ## VSCode / editor integration
 

package/defs/function-def.schema.ts

@@ -9,6 +9,13 @@ export const functionDefSchema = {
       description: "Named export in $src module. Defaults to the state key name.",
       type: "string",
     },
+    $lazy: {
+      description:
+        "Load $src on first call instead of importing it up front. The function then returns a " +
+        "promise, so it may only be called from a handler or lifecycle hook — never bound as a " +
+        "computed value. Use it for code most visitors never reach.",
+      type: "boolean",
+    },
     $prototype: { const: "Function", type: "string" },
     $src: {
       description: "External module specifier. Mutually exclusive with body.",

package/package.json

@@ -1,8 +1,8 @@
 {
   "dependencies": {
-    "@webref/css": "^8.7.2",
-    "@webref/elements": "^2.7.1",
-    "@webref/idl": "^3.82.2",
+    "@webref/css": "^8.7.3",
+    "@webref/elements": "^2.8.0",
+    "@webref/idl": "^3.83.0",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1"
   },
@@ -52,10 +52,10 @@
     "schema": "bun run src/schema.ts",
     "test": "bun test --isolate",
     "test:coverage": "bun test --isolate --coverage",
-    "upgrade": "bunx npm-check-updates -u && bun install"
+    "upgrade": "bun update --latest && bun install"
   },
   "type": "module",
-  "version": "1.9.0",
+  "version": "2.0.0",
   "devDependencies": {
     "json-schema-to-ts": "^3.1.1"
   }

package/schema.json

@@ -211,6 +211,10 @@
           "description": "Named export in $src module. Defaults to the state key name.",
           "type": "string"
         },
+        "$lazy": {
+          "description": "Load $src on first call instead of importing it up front. The function then returns a promise, so it may only be called from a handler or lifecycle hook — never bound as a computed value. Use it for code most visitors never reach.",
+          "type": "boolean"
+        },
         "$prototype": {
           "const": "Function",
           "type": "string"
@@ -2565,6 +2569,20 @@
             }
           ]
         },
+        "onconfigurationchange": {
+          "description": "Event handler for the \"configurationchange\" event.",
+          "oneOf": [
+            {
+              "$ref": "#/$defs/RefObject"
+            },
+            {
+              "$ref": "#/$defs/ExpressionEntry"
+            },
+            {
+              "$ref": "#/$defs/FunctionDef"
+            }
+          ]
+        },
         "onconnect": {
           "description": "Event handler for the \"connect\" event.",
           "oneOf": [
@@ -5421,6 +5439,20 @@
             }
           ]
         },
+        "onstream": {
+          "description": "Event handler for the \"stream\" event.",
+          "oneOf": [
+            {
+              "$ref": "#/$defs/RefObject"
+            },
+            {
+              "$ref": "#/$defs/ExpressionEntry"
+            },
+            {
+              "$ref": "#/$defs/FunctionDef"
+            }
+          ]
+        },
         "onsubmit": {
           "description": "Event handler for the \"submit\" event.",
           "oneOf": [
@@ -22776,6 +22808,7 @@
         "body",
         "br",
         "button",
+        "camera",
         "canvas",
         "caption",
         "circle",
@@ -22872,6 +22905,7 @@
         "meter",
         "mfrac",
         "mi",
+        "microphone",
         "mmultiscripts",
         "mn",
         "mo",
@@ -22960,6 +22994,7 @@
         "u",
         "ul",
         "use",
+        "usermedia",
         "var",
         "video",
         "view",

package/src/locale.ts

@@ -427,3 +427,27 @@ export function primaryLanguage(tag: unknown): string | null {
   const canonical = canonicalizeLocale(tag);
   return canonical === null ? null : (canonical.split("-")[0] ?? null);
 }
+
+/**
+ * The locale a URL belongs to.
+ *
+ * Matching is on the **first path segment**, compared canonically, so `/fr-CA/about/` resolves for
+ * a project that declared `fr-ca`. A path under no declared locale is the default locale — under
+ * `prefix-except-default` that is the point, and under `prefix-always` it is a page the author put
+ * outside the locale tree, which is theirs to place.
+ *
+ * @param {string} urlPattern - Site-absolute route pattern, e.g. `/fr/about/`
+ * @param {ResolvedI18n | null} i18n
+ * @returns {string | null} A canonical tag, or null when the project has no i18n
+ */
+export function localeOfRoute(urlPattern: string, i18n: ResolvedI18n | null): string | null {
+  if (i18n === null) {
+    return null;
+  }
+  const first = urlPattern.split("/").find(Boolean);
+  if (first === undefined) {
+    return i18n.defaultLocale;
+  }
+  const canonical = canonicalizeLocale(first);
+  return canonical !== null && i18n.locales.includes(canonical) ? canonical : i18n.defaultLocale;
+}

package/types.ts

@@ -171,6 +171,13 @@ export interface JxFunctionDef {
   $src?: string;
   /** Named export within `$src`; defaults to the state key. */
   $export?: string;
+  /**
+   * Load `$src` on first call rather than importing it with the module.
+   *
+   * The function returns a promise once lazy, so it may only be called — never bound as a computed
+   * value. Meant for code most visitors never reach.
+   */
+  $lazy?: boolean;
   /** Legacy alias for `parameters` (bare names only). */
   arguments?: string[];
   timing?: "compiler" | "server" | "client";
@@ -648,6 +655,13 @@ export interface ProjectConfig {
     deploy?: DeployConfig;
     sitemap?: boolean;
     headers?: HeadersConfig;
+    /**
+     * Minify emitted browser JavaScript. Defaults to true.
+     *
+     * Set false to ship readable bundles — debugging a deployed page, or diffing `dist/` where the
+     * two bundler backends agree on semantics but not on minified bytes.
+     */
+    minify?: boolean;
     [key: string]: unknown;
   };
   images?: ImageConfig;