@valu/block-components 0.3.1 → 0.5.0

package/README.md

@@ -16,9 +16,23 @@ accessible by default.
 npm ci
 ```
 
-Peer dependencies: `react ^18.3`, `react-dom ^18.3`, and the
-`@wordpress/*` packages listed in `package.json` (available in any
-modern Gutenberg/WP 6.4+ environment).
+### Requirements
+
+- **WordPress 7.0 or newer.** The components use the `@wordpress/*` packages
+  that WordPress ships at runtime.
+- **A build that externalizes WordPress packages**, such as `@wordpress/scripts`
+  or `@wordpress/dependency-extraction-webpack-plugin`. The `@wordpress/*`
+  imports are left bare in `dist/` and must resolve to the `wp.*` globals, so
+  every plugin on the page shares the editor's copy.
+- **Peer dependencies:** `react ^18.3` and `react-dom ^18.3`.
+
+The `@wordpress/*` packages are intentionally not declared as peer
+dependencies: npm would check them against your `node_modules`, while the
+version that actually runs is the one WordPress provides. `@wordpress/icons`
+is a regular dependency because WordPress doesn't provide it at runtime.
+
+If you use TypeScript or run unit tests that import this package, install the
+`@wordpress/*` packages you use as your own `devDependencies`.
 
 ## Quickstart
 
@@ -46,6 +60,10 @@ function Edit({ attributes, setAttributes }) {
 - [`ContentPicker`](components/content-picker/readme.md) — search and
   select posts, pages, users, or taxonomy terms with drag-to-reorder,
   thumbnails, status/type badges, and grouped results.
+- [`DocumentPicker`](components/document-picker/readme.md) — attach
+  document attachments (PDF, Word, Excel, PowerPoint by default) via
+  REST search-as-you-type combined with the native Media Library modal,
+  with optional in-place editable display names per item.
 - [`Matrix`](components/matrix/readme.md) — abstract row × column grid of
   selectable cells with optional collapsible column groups and a sticky
   master gate column. For permission matrices, feature-flag grids,

package/dist/components/content-picker/index.cjs

@@ -1760,10 +1760,7 @@ var useResolvedItems = (value) => {
           nameKey,
           item.id
         ]);
-        out[`${item.kind}:${item.type}:${item.id}`] = {
-          record: record ?? null,
-          resolved
-        };
+        out[`${item.kind}:${item.type}:${item.id}`] = resolved ? record ?? null : void 0;
       }
       return out;
     },
@@ -1771,10 +1768,8 @@ var useResolvedItems = (value) => {
   );
   return react$1.useMemo(
     () => value.map((item) => {
-      const resolvedEntry = records[`${item.kind}:${item.type}:${item.id}`];
-      if (!resolvedEntry) return item;
-      const { record, resolved } = resolvedEntry;
-      if (!resolved) {
+      const record = records[`${item.kind}:${item.type}:${item.id}`];
+      if (record === void 0) {
         return item;
       }
       if (!record) {