canopycms 0.11.0 → 0.11.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,9 +5,9 @@ packages release together, at one version.
5
5
 
6
6
  ## This build
7
7
 
8
- Version `0.11.0`, built from [`5c6c8f1`](https://github.com/safeinsights/canopycms/tree/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7).
8
+ Version `0.11.1`, built from [`3e35fb5`](https://github.com/safeinsights/canopycms/tree/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e).
9
9
 
10
- Its entries are [0.11.0](#0110), under **Released**.
10
+ Its entries are [0.11.1](#0111), under **Released**.
11
11
 
12
12
  If you upgraded from a build on another branch, compare the `<!-- changeset: … -->` slugs in your previous build's `CHANGELOG.md` (`npm pack canopycms@<old>` fetches it) with this one's: entries whose slug your old file lacks are new to you.
13
13
 
@@ -24,7 +24,7 @@ Each entry has up to three parts:
24
24
  `node_modules/canopycms/CHANGELOG.md`, assembled for that build: its **This build** section lists
25
25
  what is new since the previous int on the same branch, or on a stable release links its entries, and its links point at the commit the build
26
26
  came from. The copy in the repository holds released history and the entries from before changesets;
27
- every entry written since is a file in [`.changeset/`](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/.changeset/README.md) until a stable release
27
+ every entry written since is a file in [`.changeset/`](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/.changeset/README.md) until a stable release
28
28
  moves it here.
29
29
 
30
30
  **Find your starting point.** From a stable pin, start at the first version under **Released**
@@ -62,6 +62,16 @@ entries under **Released**.
62
62
 
63
63
  ## Released
64
64
 
65
+ ### 0.11.1
66
+
67
+ #### A comment thread you can't resolve shows Resolve disabled, with the reason
68
+
69
+ <!-- changeset: resolve-disabled-with-reason -->
70
+
71
+ _First in 0.11.1._
72
+
73
+ **What changed.** On a thread someone else started, a user outside Reviewers and Admins used to see Reply but no Resolve, with nothing to say why. Resolve now stays in place, disabled, and its tooltip explains that only the person who started the thread or a reviewer can resolve it, and suggests replying to let them know it's done. Who may resolve a thread is unchanged.
74
+
65
75
  ### 0.11.0
66
76
 
67
77
  #### The preview follows the form to the field you're on
@@ -98,7 +108,7 @@ _First in 0.9.0._
98
108
 
99
109
  **What changed.** A new scalar field type, `date`, holds a calendar day as a `YYYY-MM-DD` string, edited with a day picker. `datetime` stores an instant, so a day picked in one zone can read as the day before in another; a `date` is the same day everywhere. A save and a production build refuse a value that is not a real day, such as `2026-02-30` or `2026-5-1`; YAML rolls an unquoted `2026-02-30` forward first, so quote hand-written days. A hand-written unquoted `2024-05-01` in md or mdx frontmatter reads as that day in every zone, and survives a save on its own line. `list: true` is refused on a `date`; use an object list with a `date` field inside, which `itemTitleField` may name. `stampOnPublish` stays on `datetime`, and `datetime` values and checks are unchanged. Editor field errors now meet 4.5:1 contrast.
100
110
 
101
- **To adopt.** Change `type: 'string'` to `type: 'date'` on a field that holds `YYYY-MM-DD`: `TypeFromEntrySchema` still gives `string`, and every `YYYY-MM-DD` value stays as it is. A production build lists any entry whose value is not a real day, such as `2026-5-1`; fix those by hand. A custom field type that was named `date` keeps its `customRenderers` entry but is now checked as a `date`, so rename it if its values differ. See [Field Types](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/.changeset/README.md#field-types).
111
+ **To adopt.** Change `type: 'string'` to `type: 'date'` on a field that holds `YYYY-MM-DD`: `TypeFromEntrySchema` still gives `string`, and every `YYYY-MM-DD` value stays as it is. A production build lists any entry whose value is not a real day, such as `2026-5-1`; fix those by hand. A custom field type that was named `date` keeps its `customRenderers` entry but is now checked as a `date`, so rename it if its values differ. See [Field Types](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/.changeset/README.md#field-types).
102
112
 
103
113
  **Now deletable.** A `string` field with a hand-written `YYYY-MM-DD` format check, and site code that reads a `datetime` back into a day.
104
114
 
@@ -374,7 +384,7 @@ _First in 0.7.0._
374
384
 
375
385
  **What changed.** The pull request a submit opens now lists the branch's unresolved editor comment threads: where each one is, the first line of its first comment (80 characters at most) and a link to it in the editor. Once every thread is resolved, it says so. The list is updated whenever a comment is added, replied to or resolved, as well as on submit. Comment excerpts are visible to everyone who can read the pull request, which on a public repository means everyone. Open threads do not block the merge or keep the pull request in draft. A pull request opened before this release shows no list until its branch is next submitted.
376
386
 
377
- **To adopt.** Nothing, if your deploy replaces the worker along with the CMS, as `cdk deploy` of the canopycms-cdk stack does with the default `workerCode`. A worker on an earlier release fails each update of the list and marks the branch's sync failed until a later task succeeds, so a pipeline that leaves the worker behind must roll it no later than the CMS: see [Rolling the worker from CI](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#rolling-the-worker-from-ci).
387
+ **To adopt.** Nothing, if your deploy replaces the worker along with the CMS, as `cdk deploy` of the canopycms-cdk stack does with the default `workerCode`. A worker on an earlier release fails each update of the list and marks the branch's sync failed until a later task succeeds, so a pipeline that leaves the worker behind must roll it no later than the CMS: see [Rolling the worker from CI](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#rolling-the-worker-from-ci).
378
388
 
379
389
  #### Pull request bodies link back to the editor
380
390
 
@@ -384,7 +394,7 @@ _First in 0.7.0._
384
394
 
385
395
  **What changed.** The pull request a submit opens links to the branch in the editor, and each changed entry to that entry. A notice tells reviewers that comments on the pull request do not reach the editor, so the author will not see them. The links use the editor's URL from the submit, accepted only when its host is the one the request was addressed to (`X-Forwarded-Host`, else `Host`), which holds behind `canopycms-cdk`'s CloudFront distribution as it stands.
386
396
 
387
- **To adopt.** Nothing, unless a proxy in front of the CMS sets neither header to the editor's public host: then set `editorUrl` in your Canopy config to the editor page's URL, e.g. `editorUrl: 'https://cms.example.org/edit'`. See [the config reference](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#definecanopyconfig-options).
397
+ **To adopt.** Nothing, unless a proxy in front of the CMS sets neither header to the editor's public host: then set `editorUrl` in your Canopy config to the editor page's URL, e.g. `editorUrl: 'https://cms.example.org/edit'`. See [the config reference](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#definecanopyconfig-options).
388
398
 
389
399
  #### CloudFront origin read timeout accepted up to 120 s; the editor waits 135 s
390
400
 
@@ -470,7 +480,7 @@ _First in 0.6.0._
470
480
 
471
481
  **What changed.** `CanopyCmsService` takes `clerkOrganizationsAsGroups` (default `true`, unchanged), which the worker honours; in a deployment it, not the plugin's `useOrganizationsAsGroups`, decides the groups. When Clerk refuses the organization list with a 403 (Organizations disabled), the refresh now writes users with no groups and logs a warning, instead of failing whole; any other failure still keeps the last snapshot. Memberships are fetched instance-wide rather than per user. The scaffolds write `false` explicitly: `useOrganizationsAsGroups` in `canopycms init`'s `canopy.ts`, and `clerkOrganizationsAsGroups` in `canopycms init-deploy aws`'s CDK stack.
472
482
 
473
- **To adopt.** On a Clerk instance without Organizations, set `clerkOrganizationsAsGroups: false` on `CanopyCmsService` and `useOrganizationsAsGroups: false` in `createClerkAuthPlugin`. See [Deploying to AWS](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md).
483
+ **To adopt.** On a Clerk instance without Organizations, set `clerkOrganizationsAsGroups: false` on `CanopyCmsService` and `useOrganizationsAsGroups: false` in `createClerkAuthPlugin`. See [Deploying to AWS](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md).
474
484
 
475
485
  ### 0.5.0
476
486
 
@@ -482,7 +492,7 @@ _First in 0.5.0._
482
492
 
483
493
  **What changed.** A `type: 'reference', list: true` field now edits as rows in stored order, like an `object` list: drag a row or use its "…" menu to move or remove it, open a row to swap its entry in place, and pick from Add under the rows to append. Neither control offers an entry the list already holds. Any `list: true` field, and any `block` field, takes `maxItems`. The editor stops adding at the cap and says why, a save over it is refused, and a production build fails on an entry over it, naming the entry, field, count and cap. Adding `maxItems` to a list that already holds more therefore fails the build until an editor removes the extra items. `maxItems` on a field that holds no items is refused when the entry schema registry is created.
484
494
 
485
- **To adopt.** Set `maxItems: 3` on the list field in its entry schema. See [Field Types](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#field-types).
495
+ **To adopt.** Set `maxItems: 3` on the list field in its entry schema. See [Field Types](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#field-types).
486
496
 
487
497
  #### SEO field location moves into config; reference pickers mark hidden entries and take a sort order — **breaking: `createNextCanopyContext({ seo })` and `AIContentConfig.seo` are removed**
488
498
 
@@ -492,7 +502,7 @@ _First in 0.5.0._
492
502
 
493
503
  **What changed.** `defineCanopyConfig` takes `seo: { group?, fields? }`, the one place every surface reads an entry's `noindex` flag: the sitemap and `entryToMetadata` that `createNextCanopyContext` returns, AI content and the editor's reference picker. A per-call `seo`/`group`/`fields` still overrides it. The free `generateContentSitemap` takes `seo` as an argument and refuses to run without it when the config sets one; `createNextCanopyContext` and the AI content config refuse a leftover `seo`. A reference picker now badges an entry hidden from search as "Hidden from search", and picking one adds a note naming the setting on that entry's form, since a page listing only indexed entries won't show it. A reference field takes `optionSort`: `'label'` (the default), `'collection'`, or `{ field, direction }`. Point `field` at an ISO date, since strings compare as text.
494
504
 
495
- **To adopt.** Move `seo` from `createNextCanopyContext({ seo })` and from `defineAIContentConfig({ seo })` into `defineCanopyConfig({ seo })`. See [Sitemap and SEO Metadata](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#sitemap-and-seo-metadata) and [How References Work in the Editor](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#how-references-work-in-the-editor).
505
+ **To adopt.** Move `seo` from `createNextCanopyContext({ seo })` and from `defineAIContentConfig({ seo })` into `defineCanopyConfig({ seo })`. See [Sitemap and SEO Metadata](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#sitemap-and-seo-metadata) and [How References Work in the Editor](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#how-references-work-in-the-editor).
496
506
 
497
507
  **Now deletable.** A shared `seo` constant passed separately to the Next context and the AI content config.
498
508
 
@@ -520,7 +530,7 @@ resolved without it.
520
530
  **To adopt.** Where a reference renders its target's prose, set `includeBody: true` on that
521
531
  reference field. Code that reads the body from a link-only reference's resolved type now sees
522
532
  `string | undefined`; either set `includeBody: true` or handle the missing value. See
523
- [Resolving References in a Listing](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#resolving-references-in-a-listing).
533
+ [Resolving References in a Listing](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#resolving-references-in-a-listing).
524
534
 
525
535
  ### 0.3.3
526
536
 
@@ -937,7 +947,7 @@ URL.
937
947
  2. For a branch preview: wrap views with `withCanopyPreview` in a `'use client'` module, add
938
948
  `app/preview/[[...path]]/page.server.tsx`, set `editor.previewPrefix: '/preview'`, and serve that
939
949
  route with `frame-ancestors 'self'`, not `X-Frame-Options: DENY` (see
940
- [Live Preview](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#live-preview)).
950
+ [Live Preview](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#live-preview)).
941
951
  3. A test reading view content from the route's server HTML must load the page in a browser.
942
952
  Server output rendered during a preview request carries the signed-in asset prefix; keep it out
943
953
  of cross-request caches (`unstable_cache`, module memos).
@@ -952,7 +962,7 @@ kept site styles ahead of Mantine's in the preview.
952
962
  server components. A string path marks the form's spelling (`'a.0.b'` marks `a[0].b`), and an empty
953
963
  path marks nothing. The editor counts and logs marks naming no field. `createEntrySchemaRegistry`
954
964
  refuses a field name that is empty, all digits or contains `.`, `[` or `]`. See
955
- [Live Preview](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#live-preview).
965
+ [Live Preview](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#live-preview).
956
966
 
957
967
  **To adopt.** Fix each path that stops compiling; the error lists valid ones. Rewrite computed paths
958
968
  as literal segments, or type that component's prop as plain `FieldProps`. Pass `fieldProps` as
@@ -1034,7 +1044,7 @@ or a failed render) renders as its plain text, with no URL; any other form of th
1034
1044
  fields are nested or renamed, pass the AI config's `seo` the same object you pass
1035
1045
  `createNextCanopyContext({ seo })`, so the sitemap and AI content read the flag from the same
1036
1046
  place. A field that links to a hidden section by plain URL needs a field transform; the README
1037
- shows [the recipe](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#ai-content-configuration).
1047
+ shows [the recipe](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#ai-content-configuration).
1038
1048
 
1039
1049
  **Now deletable.** An `exclude.where` that re-read the `noindex` flag by hand.
1040
1050
 
@@ -1056,7 +1066,7 @@ A `markdown` field with `renderAs: 'mdx'` is checked as MDX, and `mdxAllow` narr
1056
1066
  field or site-wide. New: field options `renderAs`, `mdxAllow`; config key `mdxAllow`; type
1057
1067
  `MdxAllowlist`. (int.110) A component prop allowance can be `'string'` (or
1058
1068
  `{ type: 'string', maxLength }`): a quoted value only, never bare or `{…}`. See
1059
- [MDX content cannot run code](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#mdx-content-cannot-run-code).
1069
+ [MDX content cannot run code](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#mdx-content-cannot-run-code).
1060
1070
 
1061
1071
  **To adopt.** Set `renderAs: 'mdx'` on each `markdown` field your site compiles as MDX, and
1062
1072
  `mdxAllow` to what your renderer takes. Set `executable: true` only on a field whose editors you
@@ -1193,7 +1203,7 @@ a format check.
1193
1203
 
1194
1204
  - (int.93) Submit commits gain an `Edited-by: Name (id)` trailer; PR bodies gain a section that
1195
1205
  re-submits replace, keeping human text. Options: `gitEditedByTrailers`, `gitCoAuthoredByTrailers`
1196
- ([reference](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#definecanopyconfig-options)).
1206
+ ([reference](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#definecanopyconfig-options)).
1197
1207
  - (int.110) Submit-commit trailers name every user who saved since the last submit commit, and
1198
1208
  the PR-body section every user who edited the branch, not only the submitter; settings commits
1199
1209
  (permissions, groups) carry the acting user's trailer.
@@ -1217,7 +1227,7 @@ saves only push the branch, and no failing PR task lands in System health.
1217
1227
  that entry type goes unavailable: the editor says so, and its entries answer 503 with
1218
1228
  `code: 'SCHEMA_UNAVAILABLE'`. Builds, static deploys and `generate-ai-content` still fail. The
1219
1229
  worker holds the base branch for up to 30 minutes while that lasts; see
1220
- [New schemas wait for the editor deploy](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#new-schemas-wait-for-the-editor-deploy).
1230
+ [New schemas wait for the editor deploy](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#new-schemas-wait-for-the-editor-deploy).
1221
1231
  Public types gain optional `unavailable` on `EntryTypeConfig` and `FlatSchemaItem`, optional
1222
1232
  `ApiResponse.code`, and a required `SchemaResolutionResult.issues`.
1223
1233
 
@@ -1255,7 +1265,7 @@ hang until the drain heartbeat lets termination continue. Its in-flight task is
1255
1265
  new stack needs no steps.
1256
1266
 
1257
1267
  **What changed.** (int.109) Detailed in
1258
- [The worker instance](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#the-worker-instance): IMDSv2 with a hop limit of 1; the
1268
+ [The worker instance](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#the-worker-instance): IMDSv2 with a hop limit of 1; the
1259
1269
  bundle is one file whose sha256 user data checks, readable as that one object; a file-system policy
1260
1270
  refusing clients without TLS or IAM, replacing the worker's
1261
1271
  `AmazonElasticFileSystemClientReadWriteAccess`; an encrypted gp3 root volume; a boot-time upgrade to
@@ -1309,10 +1319,10 @@ failure and exits non-zero on `selfStopped`, with a code outside `RestartPrevent
1309
1319
  with its hash, as `worker/dist/index.js` and `index.js.sha256`. The default, `'asset'`, is
1310
1320
  unchanged.
1311
1321
  - `CanopyCmsService` alarms when the worker logs no git sync for 30 minutes. See
1312
- [Worker-down alarm](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#worker-down-alarm).
1322
+ [Worker-down alarm](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#worker-down-alarm).
1313
1323
 
1314
1324
  **To adopt.** Optional. For parameter-only change sets, see
1315
- [Rolling the worker from CI](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#rolling-the-worker-from-ci). For the alarm, pass
1325
+ [Rolling the worker from CI](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#rolling-the-worker-from-ci). For the alarm, pass
1316
1326
  `alarmTopic`.
1317
1327
 
1318
1328
  **Now deletable.** A manual `cdk deploy` after each canopycms bump whose only purpose is moving the
@@ -1323,7 +1333,7 @@ worker, and a hand-built alarm on the worker log group.
1323
1333
  **What changed.** (int.112) The boot's `dnf upgrade` could be OOM-killed on every retry. A 1 GiB
1324
1334
  swap file now goes on first; an upgrade that still fails starts the worker unpatched and notifies
1325
1335
  `alarmTopic` if set; a retried step names itself when it gives up. See
1326
- [The worker instance](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#the-worker-instance).
1336
+ [The worker instance](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#the-worker-instance).
1327
1337
 
1328
1338
  **To adopt.** Deploy, which replaces the worker instance. The bundle needs none of this, so it is
1329
1339
  not Template first and the worker contract stays at 1.
@@ -1389,7 +1399,7 @@ and operations may reuse GitHub fetches under 30 seconds old.
1389
1399
 
1390
1400
  **To adopt.** Nothing. Seeding `remote.git` stages a copy of the repository beside the gateway's
1391
1401
  mirror, so the root volume needs room for two
1392
- ([details](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#the-worker-instance)).
1402
+ ([details](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#the-worker-instance)).
1393
1403
 
1394
1404
  #### The worker follows a rebased or deleted GitHub branch
1395
1405
 
@@ -1411,7 +1421,7 @@ changes the template too (the fallback bundle's key and hash), so only the contr
1411
1421
  bundle-only roll is safe.
1412
1422
 
1413
1423
  **To adopt.** Parameter mode: gate bundle-only rolls on the contract
1414
- ([recipe](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#rolling-the-worker-from-ci)). The gate refuses a stack without the
1424
+ ([recipe](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#rolling-the-worker-from-ci)). The gate refuses a stack without the
1415
1425
  `WorkerContract` output, so `cdk deploy` the template once, which adds it. A hand-installed unit
1416
1426
  copies its `Environment=CANOPYCMS_WORKER_CONTRACT=` line from `worker/canopy-worker.service`.
1417
1427
 
@@ -1428,8 +1438,8 @@ units from the bundle's contract: 2 gets the split, an older bundle the single u
1428
1438
  template, then roll the bundle; on an older template it stops with `template too old for this
1429
1439
  bundle`. Inspect EFS only through `sudo /opt/canopy-worker/canopy-inspect <command>`, never from a root shell. A hand install
1430
1440
  takes `worker/`'s three units and `gateway.env.example`
1431
- ([steps](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#installing-the-units-by-hand)). After the first deploy, run the
1432
- [checklist](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#first-deploy-checklist).
1441
+ ([steps](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#installing-the-units-by-hand)). After the first deploy, run the
1442
+ [checklist](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#first-deploy-checklist).
1433
1443
 
1434
1444
  #### `canopycms-cdk`: `CanopyCmsService.attachTo`, and editor response headers — **behaviour change if you frame the CMS**
1435
1445
 
@@ -1440,7 +1450,7 @@ response headers policy. `CanopyCmsDistribution` sends the same headers: `frame-
1440
1450
  `X-Frame-Options: SAMEORIGIN`, `nosniff`, HSTS and `X-Robots-Tag: noindex`. Unless your app sends
1441
1451
  its own framing headers, no other origin can frame the editor or any page the CMS domain serves. Every such page is
1442
1452
  marked `noindex`. The editor's default preview is same-origin and unaffected. See
1443
- [Serving the editor from a distribution you already own](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#serving-the-editor-from-a-distribution-you-already-own).
1453
+ [Serving the editor from a distribution you already own](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#serving-the-editor-from-a-distribution-you-already-own).
1444
1454
 
1445
1455
  **To adopt.** If you wired the Function URL into your own distribution by hand, delete those
1446
1456
  behaviors and call `attachTo`, passing your CMS build's `assetPrefix` as `editorAssetPrefix` and a
@@ -1616,7 +1626,7 @@ one the exclusions leave out. A throw or any other return is logged and treated
1616
1626
  **To adopt.** If your site's routes, sitemap or bylines decide that some entries have no page,
1617
1627
  apply the same rule here, for example `referenceLink: (target, { body }) =>
1618
1628
  !body?.trim() ? false : undefined` in `defineAIContentConfig` from `canopycms/ai`. See
1619
- [AI Content Configuration](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#ai-content-configuration).
1629
+ [AI Content Configuration](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#ai-content-configuration).
1620
1630
 
1621
1631
  **Now deletable.** A `fieldTransforms` entry that re-renders a reference field only to drop or
1622
1632
  change its link.
@@ -1691,7 +1701,7 @@ _First in int.115._
1691
1701
  entry the base branch also changed, the "updated on the base branch" notice and the branch's
1692
1702
  conflict count now stay until the branch merges, so a reviewer still sees which entries replaced a
1693
1703
  base change. They used to clear on the next sync, about five minutes later. README's new [Drafts
1694
- and Unpublishing](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#drafts-and-unpublishing) section covers long-lived branches and
1704
+ and Unpublishing](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#drafts-and-unpublishing) section covers long-lived branches and
1695
1705
  unpublishing.
1696
1706
 
1697
1707
  #### The editor calls the content drawer "All content"
@@ -2003,7 +2013,7 @@ editor carries an unsaved draft of a stamped entry onto its stamped version.
2003
2013
  The flag is refused off a top-level `datetime`, on `list: true`, and with `required: true`.
2004
2014
 
2005
2015
  **To adopt.** Add `stampOnPublish: true` to the date field your site sorts or labels by, such as
2006
- `{ name: 'publishedAt', type: 'datetime', stampOnPublish: true }`. See [Stamping a publication date](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#stamping-a-publication-date).
2016
+ `{ name: 'publishedAt', type: 'datetime', stampOnPublish: true }`. See [Stamping a publication date](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#stamping-a-publication-date).
2007
2017
 
2008
2018
  **Now deletable.** A build step or hook that writes a missing publication date into new entries.
2009
2019
 
@@ -2050,7 +2060,7 @@ preview/form divider is now keyboard-resizable within the same 15–85% the spli
2050
2060
  stored at, and `react-split-pane` is no longer a dependency.
2051
2061
  `EditorPanes`, `EditorPanesProps`, the `PaneLayout` type and the `SPLIT_PERCENT_*` and `DEFAULT_*_SPLIT_PERCENT` constants are
2052
2062
  no longer exported from `canopycms/client`. See
2053
- [Your root layout](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#editor-customization).
2063
+ [Your root layout](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#editor-customization).
2054
2064
 
2055
2065
  **To adopt.** Nothing, unless you import `EditorPanes` or those constants: render `CanopyEditor`
2056
2066
  instead, which lays out its own panes. Hiding your site chrome on the editor route is now
@@ -2161,7 +2171,7 @@ never ended. `canopycms-auth-clerk` skips it while the editor is mounted, and ex
2161
2171
  **To adopt.** Nothing for the editor, if your edit page uses `useClerkAuthConfig()` or
2162
2172
  `ClerkSignIn`. If your CMS build renders `<SignIn>`, `UserButton` or `OrganizationSwitcher` on your
2163
2173
  own pages, mount the hook as in
2164
- [Clerk components on your own pages](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/packages/canopycms-auth-clerk/README.md#clerk-components-on-your-own-pages).
2174
+ [Clerk components on your own pages](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/packages/canopycms-auth-clerk/README.md#clerk-components-on-your-own-pages).
2165
2175
  Your own Server Actions in the CMS build still 403 behind OAC.
2166
2176
 
2167
2177
  **Now deletable.** Any local patch of `window.__internal_onBeforeSetActive` (or 6.x's
@@ -2202,12 +2212,12 @@ fast naming the ARN, the field and the keys present, never a value.
2202
2212
  **To adopt.** Nothing, unless one of those secrets holds a JSON document: then set the matching
2203
2213
  prop. The scaffolded stack fills them from the repository _variables_
2204
2214
  `CANOPY_GITHUB_TOKEN_SECRET_JSON_FIELD` and `CLERK_SECRET_KEY_SECRET_JSON_FIELD`
2205
- ([why the prefix](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#repository-secrets-and-variables)); a stack scaffolded earlier
2215
+ ([why the prefix](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#repository-secrets-and-variables)); a stack scaffolded earlier
2206
2216
  adds the props to `infrastructure/bin/app.ts` and `infrastructure/lib/cms-stack.ts` and the two `env`
2207
2217
  lines to `.github/workflows/deploy-cms.yml`, or re-runs the generator and diffs. `cdk synth` refuses a `…JsonField` prop without its `…SecretArn`, and an ARN carrying the ECS `:KEY::` suffix
2208
2218
  (also in `secretsArns`). Don't use CDK's `secretValueFromJson`: it resolves the plaintext into the deployed
2209
2219
  resource's configuration, readable by anyone who can describe it. Only `CLERK_SECRET_KEY` goes through Secrets Manager; `CLERK_JWT_KEY` and the publishable
2210
- key are public material ([Security Model](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#security-model)).
2220
+ key are public material ([Security Model](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#security-model)).
2211
2221
 
2212
2222
  **Now deletable.** A wrapper that fetches the secret, parses it and re-exports one field into the
2213
2223
  worker's environment, such as a `jq` step in user data or a wrapper entrypoint around
@@ -2219,7 +2229,7 @@ worker's environment, such as a `jq` step in user data or a wrapper entrypoint a
2219
2229
  `githubToken` is not deprecated and stays the documented default; `canopycms` neither depends on
2220
2230
  nor imports `@octokit/auth-app`. Register one App per site, not one shared across repositories:
2221
2231
  anyone holding an App's key can mint a token for any of its installations
2222
- ([why](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/ARCHITECTURE.md#why-one-github-app-per-site-not-one-shared-across-an-organisation)).
2232
+ ([why](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/ARCHITECTURE.md#why-one-github-app-per-site-not-one-shared-across-an-organisation)).
2223
2233
 
2224
2234
  **To adopt with `canopycms-cdk`** (existing stacks need no edit). `CanopyCmsServiceProps` takes
2225
2235
  `githubAppId`, `githubAppInstallationId`, `githubAppPrivateKeySecretArn` and
@@ -2232,7 +2242,7 @@ anyone holding an App's key can mint a token for any of its installations
2232
2242
  `verify` checks an existing installation's permissions: run it, since an App missing a
2233
2243
  permission only shows up later, as `sync-failed`. `create` needs an interactive terminal and
2234
2244
  never edits an existing JSON secret (create one and point the JSON-field prop at it)
2235
- ([details](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#register-it-with-canopycms-init-github-app)).
2245
+ ([details](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#register-it-with-canopycms-init-github-app)).
2236
2246
  2. Set the three props and **remove `githubTokenSecretArn`** (with its JSON field). A partial set
2237
2247
  of the three is refused at synth, and so is an App alongside a token.
2238
2248
  3. In the generated workflow, store them as `CANOPY_GITHUB_APP_ID`,
@@ -2243,7 +2253,7 @@ anyone holding an App's key can mint a token for any of its installations
2243
2253
 
2244
2254
  The private key is ARN-only; passing the key itself is refused at synth. Its ARN joins the worker's
2245
2255
  IAM policy automatically, so you need not add it to `secretsArns`. See
2246
- [Authenticating as a GitHub App](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#authenticating-as-a-github-app).
2256
+ [Authenticating as a GitHub App](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#authenticating-as-a-github-app).
2247
2257
 
2248
2258
  ```bash
2249
2259
  canopycms init-github-app create -- \
@@ -2291,7 +2301,7 @@ downloads the `.pem` from the App's settings page.
2291
2301
 
2292
2302
  **What changed.** The worker re-reads a Secrets Manager secret (the GitHub token or the Clerk secret
2293
2303
  key) when the operation using it fails. Timings, costs and the store-before-revoke order are in
2294
- [Rotating a secret](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#rotating-a-secret).
2304
+ [Rotating a secret](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#rotating-a-secret).
2295
2305
 
2296
2306
  **To adopt.** Nothing for credentials from `*_SECRET_ARN`, which is every scaffolded deployment. A
2297
2307
  GitHub App private key is still read only at boot: store the new key, replace the instance, and
@@ -2345,12 +2355,12 @@ also check the bucket policy for its grant.
2345
2355
  5. `withCanopy()` adds sharp's libvips to Next's file tracing (not for a static export) and, on
2346
2356
  Next 16 and later, sets `turbopack: {}` when your config has neither `turbopack` nor your own
2347
2357
  `webpack` and it can read your Next version. A webpack build still fails its image transforms
2348
- ([Dual Build Support](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#dual-build-support)).
2358
+ ([Dual Build Support](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#dual-build-support)).
2349
2359
 
2350
2360
  **Breaking:** a stack setting `platform` on `fromImageAsset` without `architecture` gets an arm64
2351
2361
  function while `platform` still decides the image, so `Platform.LINUX_AMD64` builds an image the
2352
2362
  function cannot run. A stack setting neither moves to arm64 with a matching image, built under QEMU
2353
- on an x86 host ([Where the image is built](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#where-the-image-is-built)).
2363
+ on an x86 host ([Where the image is built](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#where-the-image-is-built)).
2354
2364
 
2355
2365
  **To adopt.**
2356
2366
 
@@ -2379,7 +2389,7 @@ reason; `platform` on `fromImageAsset`; and, with `withCanopy()`, a hand-written
2379
2389
 
2380
2390
  **What changed.** `media.uploadUrl` (s3 adapter; an absolute http(s) URL or a site-relative path)
2381
2391
  replaces the `url` that `beginUpload()` returns, leaving the presign's `fields` untouched, so
2382
- uploads can be same-origin. See [Media Configuration](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#media-configuration) for the
2392
+ uploads can be same-origin. See [Media Configuration](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#media-configuration) for the
2383
2393
  CloudFront behavior it expects.
2384
2394
 
2385
2395
  **To adopt.** Optional. Set it from an environment variable: a site-relative value works only where
@@ -2404,7 +2414,7 @@ needs `lazyPublicTransforms: true`) let you pass a deterministically named role,
2404
2414
  bucket's stack computes `arn:aws:iam::<account>:role/<name>` from literals instead of a
2405
2415
  `Fn::GetStackOutput` reference only the CDK CLI resolves. The constructs re-attach
2406
2416
  `AWSLambdaBasicExecutionRole` (and the VPC policy) that `lambda.Function` drops from a role you
2407
- pass. See [Cross-account asset bucket](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#cross-account-asset-bucket).
2417
+ pass. See [Cross-account asset bucket](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#cross-account-asset-bucket).
2408
2418
 
2409
2419
  **To adopt.** Optional:
2410
2420
 
@@ -2514,7 +2524,7 @@ public JWKS PEM, used only to verify signatures.
2514
2524
  to variables (Settings → Secrets and variables → Actions → Variables); `bin/app.ts` refuses the
2515
2525
  deploy at synth while it is unset. Check that `bin/app.ts` passes `CLERK_SECRET_KEY` as
2516
2526
  `clerkSecretKeySecretArn` (read by the worker), never in the Lambda's `environment`, unless you keep
2517
- `clerkMiddleware` ([Security Model](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/docs/deploying-to-aws.md#security-model)).
2527
+ `clerkMiddleware` ([Security Model](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/docs/deploying-to-aws.md#security-model)).
2518
2528
 
2519
2529
  #### `readByUrlPath` answers only where `listEntries` publishes — **breaking (routing)**
2520
2530
 
@@ -2613,7 +2623,7 @@ basePath: process.env.NEXT_PUBLIC_BASE_PATH,
2613
2623
  Then pass `baseUrl` to `assetUrl` only if Next serves `/assets` (local adapter, `next dev`, S3 with
2614
2624
  no distribution): `assetUrl(image, { width: 960, baseUrl: BASE_PATH })`. Assets on CloudFront via
2615
2625
  `AssetSupport` stay at the distribution root; pass no `baseUrl` (mount table under "Where `/assets`
2616
- is mounted" in [Media Configuration](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#media-configuration)). Two traps:
2626
+ is mounted" in [Media Configuration](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#media-configuration)). Two traps:
2617
2627
 
2618
2628
  - Don't pass a deployment `basePath` to `contentStaticParams({ basePath })`; that option filters by
2619
2629
  a nested route prefix and emits zero params, building green.
@@ -2772,7 +2782,7 @@ Under `exactOptionalPropertyTypes: true`, omit keys instead of assigning `undefi
2772
2782
  `withTrailingSlash` and `isAbsoluteUrl` from `canopycms/server`; `defineSeoFieldGroup()` from
2773
2783
  `canopycms`; `generateContentSitemap` and `entryToMetadata` from `canopycms-next`, bound on
2774
2784
  `createNextCanopyContext`'s result. See
2775
- [Sitemap and SEO Metadata](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#sitemap-and-seo-metadata). Every routable entry type is in
2785
+ [Sitemap and SEO Metadata](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#sitemap-and-seo-metadata). Every routable entry type is in
2776
2786
  the sitemap unless `exclude`d or `noindex`; one `noindex` predicate drives both robots metadata and
2777
2787
  sitemap exclusion. `trailingSlash` is never inferred. `lastModified` defaults to `updatedAt`, a
2778
2788
  filesystem mtime. An empty SEO field counts as unset. `siteUrl` must be absolute, colliding URLs are
@@ -2829,7 +2839,7 @@ underscore-prefixed files are skipped.
2829
2839
 
2830
2840
  **What changed.** New scaffolds write `defaultBranchAccess: 'deny'` and
2831
2841
  `defaultPathAccess: { read: 'allow' }`
2832
- ([Public read on server deployments](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#public-read-on-server-deployments)).
2842
+ ([Public read on server deployments](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#public-read-on-server-deployments)).
2833
2843
 
2834
2844
  **To adopt.** An older scaffold's `defaultBranchAccess: 'allow'` is wider than recommended;
2835
2845
  consider `'deny'`. If you deleted `defaultPathAccess: { read: 'allow' }`, anonymous visitors get no content until you
@@ -2882,7 +2892,7 @@ re-checked an entry's type (a `switch` on `meta.entryType` can merge them into o
2882
2892
  **What changed.** `BlockComponentRegistry<Blocks>` (types only, from `canopycms`; `BlockValueOf<Blocks, 'hero'>`
2883
2893
  gives one template's value type) requires exactly
2884
2894
  one component per block template name when written as an object literal. See
2885
- [Block Component Registries](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#block-component-registries) and
2895
+ [Block Component Registries](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#block-component-registries) and
2886
2896
  `apps/example1/app/components/PostView.tsx`.
2887
2897
 
2888
2898
  ```ts
@@ -2904,7 +2914,7 @@ templates against the schema.
2904
2914
 
2905
2915
  **What changed.** Spreading a `const` field array into several schemas, and nesting
2906
2916
  `defineInlineFieldGroup()` inside a block template, are documented
2907
- ([Reusable Field Fragments](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#reusable-field-fragments)); `defineFieldFragment()` is an
2917
+ ([Reusable Field Fragments](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#reusable-field-fragments)); `defineFieldFragment()` is an
2908
2918
  identity helper for them.
2909
2919
 
2910
2920
  ```ts
@@ -2923,7 +2933,7 @@ field by composing from the same `const` field object.
2923
2933
  A block template holding a `reference` field is a shared block; `read()`/`readByUrlPath()` resolve
2924
2934
  it, and listings do with
2925
2935
  [`resolveReferences`](#listings-resolve-references-and-a-resolved-reference-carries-urlpath-and-optionally-its-body-16--breaking-type-level)
2926
- (0.0.64). See [Shared / Referenced Blocks](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#shared--referenced-blocks).
2936
+ (0.0.64). See [Shared / Referenced Blocks](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#shared--referenced-blocks).
2927
2937
 
2928
2938
  **Now deletable.** A second `read()` in page code to unwrap a shared block's reference.
2929
2939
 
@@ -2945,7 +2955,7 @@ Not retro-documented, apart from these:
2945
2955
 
2946
2956
  #### The registry is keyed by entry-type name (0.0.42)
2947
2957
 
2948
- **What changed.** `createEntrySchemaRegistry` keys are the entry-type names that `.collection.json` files name in `entry.schema`, and `EntryTypesFromRegistry` derives the typed entry-type map from them. Schema-variable keys (`{ postSchema }`) still work but derive nothing; [README's registry convention](https://github.com/safeinsights/canopycms/blob/5c6c8f1378edd82c6c0cd54923dfb2fa1bb4d4d7/README.md#convention-why-key-the-registry-by-entry-type-name) says when to keep them.
2958
+ **What changed.** `createEntrySchemaRegistry` keys are the entry-type names that `.collection.json` files name in `entry.schema`, and `EntryTypesFromRegistry` derives the typed entry-type map from them. Schema-variable keys (`{ postSchema }`) still work but derive nothing; [README's registry convention](https://github.com/safeinsights/canopycms/blob/3e35fb5d09036c5975fc88fbf08e9c2b960bce4e/README.md#convention-why-key-the-registry-by-entry-type-name) says when to keep them.
2949
2959
 
2950
2960
  **To adopt.**
2951
2961
 
@@ -1,9 +1,10 @@
1
1
  'use client';
2
2
  import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
3
3
  import { useEffect, useRef, useState } from 'react';
4
- import { Button, Group, Stack, Textarea } from '@mantine/core';
4
+ import { Button, Group, Stack, Textarea, Tooltip } from '@mantine/core';
5
5
  import { moveFocusIfUnmoved } from './move-focus-if-unmoved.js';
6
6
  import { CommentWriteAlert, toCommentWriteFailure, } from './CommentWriteAlert.js';
7
+ const RESOLVE_BLOCKED_REASON = "Only the person who started this thread or a reviewer can resolve it. Reply to let them know it's done.";
7
8
  /** Refocuses `box` when a submit settles: the busy button disabled itself and dropped focus. */
8
9
  export const useRefocusAfterSubmit = (submitting, box) => {
9
10
  const wasSubmitting = useRef(false);
@@ -90,6 +91,8 @@ export const ThreadReplyControls = ({ thread, onAddReply, onResolve, focusAfterR
90
91
  }
91
92
  };
92
93
  const mayResolve = canResolve || thread.authorId === currentUserId;
93
- const resolveButton = mayResolve && (_jsx(Button, { variant: "light", color: "green", onClick: handleResolve, loading: resolving, disabled: replying, "data-testid": "resolve-thread-button", children: hasDraft ? 'Reply and resolve' : 'Resolve' }));
94
+ // Shown disabled with its reason rather than hidden: the same user may resolve threads they start.
95
+ // `data-disabled` without native `disabled` keeps it focusable, so the Tooltip can open on focus.
96
+ const resolveButton = mayResolve ? (_jsx(Button, { variant: "light", color: "green", onClick: handleResolve, loading: resolving, disabled: replying, "data-testid": "resolve-thread-button", children: hasDraft ? 'Reply and resolve' : 'Resolve' })) : (_jsx(Tooltip, { label: RESOLVE_BLOCKED_REASON, multiline: true, maw: 280, events: { hover: true, focus: true, touch: true }, children: _jsx(Button, { variant: "light", color: "green", "data-disabled": true, "aria-disabled": true, onClick: (e) => e.preventDefault(), "data-testid": "resolve-thread-button", children: "Resolve" }) }));
94
97
  return (_jsxs(Stack, { gap: "xs", children: [error && _jsx(CommentWriteAlert, { failure: error, onClose: () => setError(null) }), expanded ? (_jsxs(_Fragment, { children: [_jsx(Textarea, { ref: boxRef, placeholder: "Write a reply\u2026", "aria-label": "Reply to this thread", value: replyText, onChange: (e) => setReplyText(e.target.value), minRows: 2, disabled: replying || resolving }), _jsxs(Group, { gap: "xs", children: [_jsx(Button, { onClick: handleReply, loading: replying, disabled: !replyText.trim() || resolving, "data-testid": "submit-reply-button", children: "Reply" }), _jsx(Button, { variant: "subtle", color: "gray", onClick: collapse, disabled: replying, children: "Cancel" }), resolveButton] })] })) : (_jsxs(Group, { gap: "xs", children: [_jsx(Button, { ref: replyButtonRef, variant: "light", onClick: expand, disabled: resolving, "data-testid": "reply-thread-button", children: "Reply\u2026" }), resolveButton] }))] }));
95
98
  };
package/dist/version.d.ts CHANGED
@@ -1 +1 @@
1
- export declare const CANOPYCMS_VERSION = "0.11.0";
1
+ export declare const CANOPYCMS_VERSION = "0.11.1";
package/dist/version.js CHANGED
@@ -1,3 +1,3 @@
1
1
  // Generated by scripts/bump-version.mjs, its only writer. The package builds with plain
2
2
  // tsc (rootDir: src), so src/ cannot import ../package.json; version.test.ts keeps the two equal.
3
- export const CANOPYCMS_VERSION = '0.11.0';
3
+ export const CANOPYCMS_VERSION = '0.11.1';
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "//": "@codemirror/language, @lezer/highlight: workaround — @mdxeditor/editor uses cm6-theme-basic-light which peer-requires these but mdxeditor doesn't declare them as dependencies",
3
3
  "name": "canopycms",
4
- "version": "0.11.0",
4
+ "version": "0.11.1",
5
5
  "description": "CanopyCMS core package: schema-driven content, branch-aware editing, and editor UI for Next.js.",
6
6
  "license": "MIT",
7
7
  "repository": {