@ggui-ai/gadgets 0.6.2 → 0.7.0

package/dist/codegen.d.mts

@@ -43,10 +43,14 @@ import { GadgetDescriptor } from '@ggui-ai/protocol';
  *
  * The helper:
  *   1. Validates each descriptor against
- *      `registeredGadgetDescriptorSchema` (every registered descriptor
- *      MUST pass — same gate the `App.gadgets` registration handler
- *      applies, including the `typesUrl`-required refinement for
- *      non-stdlib gadgets).
+ *      `registeredGadgetDescriptorSchema` — strict validation PLUS the
+ *      `typesUrl`-required refinement for non-stdlib gadgets. This
+ *      build helper is that schema's one live consumer: it runs after
+ *      the wrapper build has emitted the `.d.ts` and stamped
+ *      `typesUrl` + `typesSri`, so requiring them is coherent HERE.
+ *      (Catalog boundaries — registration writes, reads, generation —
+ *      validate with `strictGadgetDescriptorSchema`, where `typesUrl`
+ *      stays optional until the types-pipeline follow-up lands.)
  *   2. Writes a JSON document `{ version: 'gg2', descriptors: [...] }`.
  */
 interface WriteDescriptorJsonInput {

package/dist/codegen.d.ts

@@ -43,10 +43,14 @@ import { GadgetDescriptor } from '@ggui-ai/protocol';
  *
  * The helper:
  *   1. Validates each descriptor against
- *      `registeredGadgetDescriptorSchema` (every registered descriptor
- *      MUST pass — same gate the `App.gadgets` registration handler
- *      applies, including the `typesUrl`-required refinement for
- *      non-stdlib gadgets).
+ *      `registeredGadgetDescriptorSchema` — strict validation PLUS the
+ *      `typesUrl`-required refinement for non-stdlib gadgets. This
+ *      build helper is that schema's one live consumer: it runs after
+ *      the wrapper build has emitted the `.d.ts` and stamped
+ *      `typesUrl` + `typesSri`, so requiring them is coherent HERE.
+ *      (Catalog boundaries — registration writes, reads, generation —
+ *      validate with `strictGadgetDescriptorSchema`, where `typesUrl`
+ *      stays optional until the types-pipeline follow-up lands.)
  *   2. Writes a JSON document `{ version: 'gg2', descriptors: [...] }`.
  */
 interface WriteDescriptorJsonInput {

package/dist/index.d.mts

@@ -17,10 +17,13 @@ export { GadgetError, GadgetHook, GadgetStatus } from '@ggui-ai/protocol';
  *      `typesUrl`) must be full URLs — plus a non-function `hookImpl`
  *      check the schema can't see. Throws
  *      {@link WrapperConformanceError} with field-level paths on any
- *      violation. (`typesUrl` is not required HERE — at author time
- *      the build hasn't emitted a `.d.ts` yet — but registration via
- *      `registeredGadgetDescriptorSchema` requires it for every
- *      non-stdlib package.)
+ *      violation. (`typesUrl` is optional here AND at every catalog
+ *      boundary — the `strict` posture is the one live validator;
+ *      generation degrades gracefully to no-types codegen when it is
+ *      absent. The build helper `writeDescriptorJson` still requires
+ *      it via `registeredGadgetDescriptorSchema`, since the wrapper
+ *      build HAS just emitted a `.d.ts` — the front half of the
+ *      types-pipeline follow-up.)
  *   2. Returns the React hook function as the primary export, with
  *      the serializable {@link GadgetDescriptor} descriptor attached
  *      as `.descriptor`. Single export, dual purpose:

package/dist/index.d.ts

@@ -17,10 +17,13 @@ export { GadgetError, GadgetHook, GadgetStatus } from '@ggui-ai/protocol';
  *      `typesUrl`) must be full URLs — plus a non-function `hookImpl`
  *      check the schema can't see. Throws
  *      {@link WrapperConformanceError} with field-level paths on any
- *      violation. (`typesUrl` is not required HERE — at author time
- *      the build hasn't emitted a `.d.ts` yet — but registration via
- *      `registeredGadgetDescriptorSchema` requires it for every
- *      non-stdlib package.)
+ *      violation. (`typesUrl` is optional here AND at every catalog
+ *      boundary — the `strict` posture is the one live validator;
+ *      generation degrades gracefully to no-types codegen when it is
+ *      absent. The build helper `writeDescriptorJson` still requires
+ *      it via `registeredGadgetDescriptorSchema`, since the wrapper
+ *      build HAS just emitted a `.d.ts` — the front half of the
+ *      types-pipeline follow-up.)
  *   2. Returns the React hook function as the primary export, with
  *      the serializable {@link GadgetDescriptor} descriptor attached
  *      as `.descriptor`. Single export, dual purpose:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggui-ai/gadgets",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Browser-capability gadget hooks for ggui — declared via DataContract.clientCapabilities.gadgets, mounted by the UI generator's component code.",
   "license": "Apache-2.0",
   "keywords": [
@@ -60,7 +60,7 @@
     "vitest": "^3.2.6"
   },
   "dependencies": {
-    "@ggui-ai/protocol": "0.6.2"
+    "@ggui-ai/protocol": "0.7.0"
   },
   "engines": {
     "node": ">=20.0.0"