docs(spec): name the warning level in the widget options doc comment, add the patch changeset

Claude-Session: https://claude.ai/code/session_01UtnxvdiN376GF3sgXwAw4d
Co-authored-by: Claude <noreply@anthropic.com>

Author: claude

.changeset/21210-widget-options-docblock.md

@@ -0,0 +1,7 @@
+---
+'@objectstack/spec': patch
+---
+
+The `DashboardWidgetOptionsSchema` doc comment no longer says that a misspelled widget `options` key is an author-time type error. The bag ends in `.passthrough()`, so a misspelled key such as `sortDirection` or `granularity` compiles and parses like any other extra key, and it changes nothing at render time. A wrong value for a declared key, such as `sortOrder: 'sideways'`, is the type error and the parse error. `os validate`, `os build` and `os lint` name the misspelled key with the `unconsumed-widget-option` warning, which does not fail any of the three commands. Only the comment changed. The schema's shape is the same.
+
+Clause-②: no

packages/spec/src/ui/dashboard.zod.ts

@@ -245,9 +245,10 @@ const WIDGET_HISTORY =
  * a wrong VALUE for one (`sortOrder: 'sideways'`) is an author-time type error
  * and a parse error. A misspelled KEY is neither: the bag is open, so
  * `sortDirection` or `granularity` compiles and parses like any other extra
- * and changes nothing. What names it is the `unconsumed-widget-option` warning
- * that `os validate`, `os build` and `os lint` raise on every key the
- * dataset-bound path does not read.
+ * and changes nothing. What names it is the `unconsumed-widget-option`
+ * warning `os validate`, `os build` and `os lint` raise for a key the
+ * dataset-bound path does not read — a warning, so none of the three fails on
+ * it.
  *
  * The dashboard/report renderer lowers these into the `DatasetSelection` it
  * posts (`dateGranularity`, `order`, `limit`); see the field docs on