@colixsystems/widget-sdk 0.175.0 → 0.176.0

package/README.md

@@ -73,7 +73,11 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`v0.175.0` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+`v0.176.0` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+
+### What's new in 0.176.0 (contract 1.137.0)
+
+**`manifest.description` is optional.** A widget publishes with a name and no description; when present, the description must still be a string. The storefront shows no blurb for a widget without one.
 
 ### What's new in 0.175.0 (contract 1.136.0)
 

package/dist/contract.cjs

@@ -2598,8 +2598,8 @@ const MANIFEST_SCHEMA = {
   },
   description: {
     type: "string",
-    required: true,
-    description: "1-2 sentence storefront description.",
+    required: false,
+    description: "Optional. 1-2 sentence storefront description.",
   },
   author: {
     type: "object",
@@ -4716,7 +4716,7 @@ const CONTRACT = deepFreeze({
   //    without saving it, through the new `device.pdfViewer` host slice. And
   //    `createObjectURL` joins `bannedApis`: widgets reached for it to fake a
   //    "print version" as a plain-text blob that never worked on native.
-  version: "1.136.0",
+  version: "1.137.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/dist/contract.js

@@ -2594,8 +2594,8 @@ const MANIFEST_SCHEMA = {
   },
   description: {
     type: "string",
-    required: true,
-    description: "1-2 sentence storefront description.",
+    required: false,
+    description: "Optional. 1-2 sentence storefront description.",
   },
   author: {
     type: "object",
@@ -4712,7 +4712,7 @@ const CONTRACT = deepFreeze({
   //    without saving it, through the new `device.pdfViewer` host slice. And
   //    `createObjectURL` joins `bannedApis`: widgets reached for it to fake a
   //    "print version" as a plain-text blob that never worked on native.
-  version: "1.136.0",
+  version: "1.137.0",
   sharedTranslationKeys: SHARED_TRANSLATION_KEYS,
   hooks: HOOKS,
   primitives: PRIMITIVES,

package/dist/manifest.cjs

@@ -196,7 +196,12 @@ function validateManifest(m) {
   );
 
   pushIf(errors, isNonEmptyString(manifest.icon), "manifest.icon must be a non-empty string");
-  pushIf(errors, isNonEmptyString(manifest.description), "manifest.description must be a non-empty string");
+  // sc-9142: optional — a listing needs a name, not a blurb.
+  pushIf(
+    errors,
+    manifest.description === undefined || typeof manifest.description === "string",
+    "manifest.description must be a string when present",
+  );
 
   if (manifest.author === null || typeof manifest.author !== "object") {
     errors.push("manifest.author must be an object with a name");

package/dist/manifest.js

@@ -242,7 +242,12 @@ function validateManifest(m) {
   );
 
   pushIf(errors, isNonEmptyString(manifest.icon), "manifest.icon must be a non-empty string");
-  pushIf(errors, isNonEmptyString(manifest.description), "manifest.description must be a non-empty string");
+  // sc-9142: optional — a listing needs a name, not a blurb.
+  pushIf(
+    errors,
+    manifest.description === undefined || typeof manifest.description === "string",
+    "manifest.description must be a string when present",
+  );
 
   if (manifest.author === null || typeof manifest.author !== "object") {
     errors.push("manifest.author must be an object with a name");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colixsystems/widget-sdk",
-  "version": "0.175.0",
+  "version": "0.176.0",
   "description": "Common widget interface for AppStudio. Implements WidgetManifest, WidgetContext, property schema, and helper hooks.",
   "homepage": "https://github.com/Colix-AB/AppStudio",
   "type": "module",