react-material-expressive 1.0.0 → 1.1.0

package/docs/components/Combobox.md

@@ -0,0 +1,119 @@
+# Combobox
+
+ARIA **combobox** with an async-friendly options list — a text field
+(`ComboboxFilled` / `ComboboxOutlined`, same anatomy as the text fields and
+`Select`) over a `role="listbox"` popover. Unlike `Select` (a fixed option
+list) and `Search` (a search bar, not a combobox), it exposes the full
+combobox semantics — `role="combobox"`, `aria-autocomplete`,
+`aria-expanded`/`aria-controls`/`aria-activedescendant` — with keyboard
+navigation and a portaled listbox that escapes `overflow` ancestors.
+
+**The library never fetches or filters.** You own the data: as the user types,
+`onInputChange(query)` fires (debounce it on your side), you fetch/filter
+(client- or server-side) and feed the resulting `options` back in. `loading`
+shows a status row while in flight. (Not a Material component — an extra on top
+of the M3 kit.)
+
+Because filtering only happens through `onInputChange`, `aria-autocomplete` is
+`"list"` when you wire `onInputChange` (the list narrows as the user types) and
+`"none"` when you don't (a static option popover that never narrows). Wire
+`onInputChange` for a real combobox — even a static list needs a (synchronous)
+filter to narrow.
+
+## Import
+
+```tsx
+import {ComboboxFilled, ComboboxOutlined} from "react-material-expressive";
+```
+
+## API
+
+```ts
+interface ComboboxOption {
+  disabled?: boolean;
+  label?: string; // input text when selected; defaults to value
+  value: string;
+}
+
+interface ComboboxLabels {
+  clear?: string; // clear-button aria-label (default "Clear")
+  empty?: string; // no-options status row (default "No results")
+  loading?: string; // loading status row (default "Loading…")
+}
+
+interface ComboboxOutlinedProps {
+  // …plus the native <input> props (placeholder, required, aria-*, …)
+  className?: string;
+  clearable?: boolean; // trailing clear button when there is text (default true)
+  defaultValue?: string; // uncontrolled selected value
+  disabled?: boolean;
+  error?: boolean;
+  errorText?: ReactNode;
+  id?: string;
+  inputClassName?: string;
+  label?: string; // floating label
+  labels?: ComboboxLabels;
+  leftElement?: ReactNode; // leading icon (24px box)
+  listboxClassName?: string; // class for the portaled listbox surface
+  loading?: boolean; // consumer signals an in-flight fetch
+  name?: string; // posts the selected value via a hidden input
+  onChange?: (value: string) => void; // selected value, or "" when cleared
+  onInputChange?: (query: string) => void; // re-query (debounce on your side)
+  options: ComboboxOption[]; // ALREADY filtered
+  supportingText?: ReactNode;
+  value?: string; // controlled selected value
+}
+// ComboboxFilledProps is identical.
+```
+
+## Example (async)
+
+```tsx
+function CountryPicker() {
+  const [options, setOptions] = useState<ComboboxOption[]>([]);
+  const [loading, setLoading] = useState(false);
+
+  const search = useMemo(
+    () =>
+      debounce(async (q: string) => {
+        setLoading(true);
+        setOptions(await fetchCountries(q)); // your API
+        setLoading(false);
+      }, 250),
+    [],
+  );
+
+  return (
+    <ComboboxOutlined
+      label="Country"
+      loading={loading}
+      onInputChange={search}
+      onChange={setCountry}
+      options={options}
+    />
+  );
+}
+```
+
+## Keyboard
+
+`ArrowDown`/`ArrowUp` open the popover (then move the active option, skipping
+disabled, wrapping); `Home`/`End` jump; `Enter` commits the active option;
+`Escape` and `Tab` close and revert the input text to the selected option's
+label. Typing fires `onInputChange` and keeps the popover open.
+
+## Gotchas
+
+- **You own fetching and filtering.** `options` are rendered as-is; the
+  library never filters them. Debounce `onInputChange` yourself.
+- Two states: the **selected value** (`value`/`onChange`, controllable via
+  `useControlled`) and the **input text** (the query). Typing diverges the
+  text; blur/Escape/Tab without a pick reverts it to the selected label.
+- `onChange` fires the option **value** (or `""` on clear) — not on every
+  keystroke (that's `onInputChange`).
+- The listbox is portaled to `document.body` (fixed positioning), matches the
+  input width and flips up when there's no room below — it escapes `overflow`
+  ancestors. An empty/loading popover shows a `role="status"` row instead of an
+  empty listbox.
+- `name` renders a hidden input so the value posts in native forms; native
+  `required` validation is not wired — validate in `onSubmit`.

package/docs/components/DatePicker.md

@@ -51,11 +51,14 @@ interface DatePickerLabels {
 
 interface DatePickerDockedProps {
   className?: string;
+  error?: boolean; // error state on the field
+  errorText?: ReactNode; // error message below the field
   labels?: DatePickerDockedLabels; // { field, openCalendar, previousMonth, nextMonth, selectYear }
   locale?: string;
   max?: Date | null;
   min?: Date | null;
   onChange?: (date: Date | null) => void;
+  supportingText?: ReactNode; // helper text below the field
   value?: Date | null;
   weekStartsOn?: number;
 }
@@ -89,8 +92,13 @@ const [date, setDate] = useState<Date | null>(null);
     value={date}
 />;
 
-// Docked
-<DatePicker.Docked value={date} onChange={setDate} />;
+// Docked, with validation
+<DatePicker.Docked
+    value={date}
+    onChange={setDate}
+    error={submitted && !date}
+    errorText="Pick a date"
+/>;
 ```
 
 ## Gotchas
@@ -103,6 +111,10 @@ const [date, setDate] = useState<Date | null>(null);
   is in `labels`, e.g. `labels={{cancel: "Cancelar", confirm: "Aceptar"}}`;
   unset keys keep the English defaults.
 - `min`/`max` disable out-of-range days.
+- `error` / `errorText` / `supportingText` recolor and annotate the **docked**
+  field with the MD3 error role (`aria-invalid`, `role="alert"`,
+  `aria-describedby`). The modal pickers render no form field of their own, so
+  they have no error state.
 
 ## Accepted gaps (criterion)
 

package/docs/components/Dropdown.md

@@ -62,6 +62,10 @@ interface DropdownItemProps {
 
 ## Gotchas
 
+- The menu renders in a portal on `document.body` with fixed positioning, so
+  it escapes `overflow` ancestors (e.g. a `Table` body) and auto-flips above
+  the trigger when there isn't room below; it tracks the trigger on
+  scroll/resize.
 - The whole wrapper toggles on click, so clicking an item also closes the
   menu (select-like behavior).
 - The menu is content-width, clamped to the M3 spec's 112–280dp range

package/docs/components/Layers.md

@@ -41,3 +41,6 @@ interface SectionProps {
 
 - The dot grid uses `--md-sys-color-outline-variant`, so it adapts to the
   active theme.
+- Overlay stacking follows the documented `--md-sys-z-*` scale (see
+  FOUNDATIONS.md → Stacking & z-index). Override a token to slot your own
+  chrome between layers (e.g. a sticky header below menus).

package/docs/components/Menu.md

@@ -145,5 +145,9 @@ Grouped with a gap (separate surfaces):
 
 - Anchorless: wrap it in a positioned element and control mount/unmount
   (e.g. via `useDismissable`) yourself, or use `Dropdown` which does this.
+  The built-in anchored menus (`Dropdown`, `OverflowMenu`, `SplitButton`) and
+  `Menu.Sub` all render in a portal on `document.body`, placed by the shared
+  internal `usePopoverPosition` helper (fixed positioning with viewport
+  flip/shift), so they escape `overflow` ancestors.
 - `selected` is visual; for single-selection semantics in a picker, the
   consumer still owns the selected value.

package/docs/components/NavigationRail.md

@@ -103,3 +103,6 @@ const [expanded, setExpanded] = useState(false);
 - Per spec: 3–7 destinations, vertical rails sit opposite the content
   edge with ≥24dp margins on large screens, and the rail stays fixed
   while content scrolls vertically.
+- The destinations area scrolls only when the items genuinely overflow the
+  rail height; the header and bottom slot keep their natural size, so a few
+  destinations never show a scrollbar even when the rail is short.

package/docs/components/OverflowMenu.md

@@ -61,5 +61,9 @@ interface OverflowMenuItemProps {
 
 ## Gotchas
 
-- Position flags are booleans; with none set it falls back to bottomRight.
+- Position flags are booleans expressing a **preferred** placement; with none
+  set it falls back to bottomRight. The menu renders in a portal on
+  `document.body` (fixed-positioned), so it escapes `overflow` ancestors, and
+  flips to the opposite side / shifts to stay in the viewport when the
+  preferred placement doesn't fit; it tracks the trigger on scroll/resize.
 - Closes on outside click, item click and Escape.

package/docs/components/Search.md

@@ -34,13 +34,16 @@ interface SearchInputProps extends Omit<
   "placeholder" | "size"
 > {
   className?: string;
+  clearable?: boolean; // trailing clear (×) button when there's a value
   inputClassName?: string;
   labels?: SearchInputLabels; // accessible names
   leftElement?: ReactNode; // 56px slot (search icon / back)
-  rightElement?: ReactNode; // 56px slot (avatar / mic)
+  onClear?: () => void; // called after the clear button empties the input
+  rightElement?: ReactNode; // 56px slot (avatar / mic) — wins over clear
 }
 
 interface SearchInputLabels {
+  clear?: string; // clear-button aria-label (default "Clear")
   placeholder?: string; // input placeholder (default "Search")
 }
 
@@ -74,6 +77,7 @@ interface SearchItemProps {
     </>
   }>
   <SearchInput
+    clearable
     labels={{placeholder: "Search"}}
     leftElement={<MaterialSymbol name="search" />}
     onChange={onQuery}
@@ -86,6 +90,10 @@ interface SearchItemProps {
 - `SearchInput` is transparent — the `Search` wrapper owns the container
   color/shape. Standalone bars: wrap in `Search` without `result`.
 - Search bars don't float labels (M3); the placeholder stays visible.
+- `clearable` renders a trailing clear (×) button while the input has a value
+  (controlled or uncontrolled; clearing refocuses the input and fires
+  `onClear`). It hides the inconsistent native `type=search` clear, and a
+  `rightElement` takes precedence over it.
 - The suggestions card opens with the menu choreography (500ms emphasized
   clip reveal with staggered items, 150ms accelerate exit). In the default
   **contained** style the bar keeps its 28px pill shape and the card floats

package/docs/components/SplitButton.md

@@ -40,7 +40,9 @@ interface SplitButtonLabels {
 The menu is the shared M3E vertical [`Menu`](Menu.md) (corner-large surface,
 `surface-container-low`, elevation 3) anchored to the trailing button's
 bottom-right; focus returns to that button when it closes. `SplitButton.Item`
-is the shared `Menu.Item` (same as `OverflowMenu.Item`).
+is the shared `Menu.Item` (same as `OverflowMenu.Item`). The menu renders in a
+portal on `document.body` (fixed-positioned), so it escapes `overflow`
+ancestors and auto-flips above the button when there's no room below.
 
 ## Sizes
 

package/docs/components/TextElement.md

@@ -14,12 +14,16 @@ import {TextElement} from "react-material-expressive";
 
 ```ts
 interface TextElementProps {
+  as?: ElementType; // wrapper element (multi-slot only); default "div"
   body?: ReactNode;
+  bodyAs?: ElementType; // body element; default "p"
   bodyStyle?: string; // class override
   className?: string;
   label?: ReactNode;
+  labelAs?: ElementType; // label element; default "p"
   labelStyle?: string;
   title?: ReactNode;
+  titleAs?: ElementType; // title element; default "h2"
   titleStyle?: string;
 }
 ```
@@ -29,9 +33,20 @@ interface TextElementProps {
 ```tsx
 <TextElement label="OVERLINE" title="Headline" body="Supporting copy" />
 <TextElement title="Bigger" titleStyle="text-headline-small" />
+
+// A lone title as a page heading — renders a bare <h1>, no wrapper div:
+<TextElement title="Page title" titleAs="h1" />
 ```
 
 ## Gotchas
 
 - Each slot renders only when provided; `*Style` props are class strings
   merged with `cn`.
+- **Element is polymorphic**: `labelAs`/`titleAs`/`bodyAs` (default p/h2/p) set
+  the rendered tag while keeping the M3 typography. Choose the title's level by
+  content hierarchy, not visual size (M3 a11y: don't force `<h2>` where the
+  outline needs `<h1>`/`<h3>`/a non-heading).
+- **Single slot = no wrapper**: with exactly one slot the text element renders
+  directly (e.g. a bare `<h2>`) and `className` applies to it. With two or more
+  slots they stack in the `as` wrapper (default `<div>`), which takes
+  `className`.

package/llms.txt

@@ -6,85 +6,90 @@
 > React >= 19 (ESM + CJS + types, "use client" embedded). Single root
 > export (react-material-expressive) plus the precompiled ./styles.css
 > and the raw ./theme.css Tailwind partial (only to extend with your own
-> Tailwind v4).
+> Tailwind v4). Links below are relative to this file (the package bundles
+> `docs/` alongside it).
 
 ## Start here
 
-- [README](README.md): install, quickstart,
-  theming, icons, media/link injection, i18n (per-component `labels` prop,
-  English defaults only; `locale` for Intl formatting), subpath map.
-- [CHANGELOG](CHANGELOG.md): per-release history with a migration note on
-  every breaking change (pre-1.0: breaking bumps the minor version).
+- [README](README.md) — install, quickstart, theming, icons, media/link
+  injection, i18n (per-component `labels` prop, English defaults only;
+  `locale` for Intl formatting), exports.
+- [FOUNDATIONS](FOUNDATIONS.md) — authoritative M3 sources and the
+  cross-cutting foundations: tokens, state layers, motion, elevation, the type
+  scale, and the documented `--md-sys-z-*` overlay stacking scale.
+- [CHANGELOG](CHANGELOG.md) — per-release history; each breaking change carries
+  a migration note (SemVer: breaking → major, additive → minor, fix → patch).
 
 ## Component docs (API, props, variants, examples, gotchas)
 
 ### Actions
-- [Button](docs/components/Button.md)
-- [ButtonGroup](docs/components/ButtonGroup.md)
-- [ButtonGroupConnected](docs/components/ButtonGroupConnected.md)
-- [IconButton](docs/components/IconButton.md)
-- [FAB and ExtendedFAB](docs/components/FAB.md)
-- [FABMenu](docs/components/FABMenu.md)
-- [SplitButton](docs/components/SplitButton.md)
+- [Button](docs/components/Button.md) — M3 Expressive button; sizes xs–xl, variants, optional toggle.
+- [ButtonGroup](docs/components/ButtonGroup.md) — invisible container that spaces a row of buttons.
+- [ButtonGroupConnected](docs/components/ButtonGroupConnected.md) — buttons joined by 2dp gaps, with toggle selection.
+- [IconButton](docs/components/IconButton.md) — 40×40 icon button (48×48 touch target), variants + toggle.
+- [FAB and ExtendedFAB](docs/components/FAB.md) — floating action buttons (56/80/96) and the extended FAB.
+- [FABMenu](docs/components/FABMenu.md) — a FAB that morphs into a vertical menu of labeled actions.
+- [SplitButton](docs/components/SplitButton.md) — leading action + trailing menu button; the menu portals to escape `overflow`.
 
 ### Communication
-- [Badge, DotBadge, OnIconBadge](docs/components/Badge.md)
-- [Progress and Circle](docs/components/Progress.md)
-- [LoadingIndicator](docs/components/LoadingIndicator.md)
-- [Snackbar and SnackbarWrapper](docs/components/Snackbar.md)
-- [Tooltip](docs/components/Tooltip.md)
-- [Loading](docs/components/Loading.md)
+- [Badge, DotBadge, OnIconBadge](docs/components/Badge.md) — count, dot and on-icon badges on the error container.
+- [Progress and Circle](docs/components/Progress.md) — linear and circular progress indicators (optional `wavy`).
+- [LoadingIndicator](docs/components/LoadingIndicator.md) — expressive 38dp shape-morphing loading indicator.
+- [Snackbar and SnackbarWrapper](docs/components/Snackbar.md) — snackbar (inverse-surface) + its portaled stacking wrapper.
+- [Tooltip](docs/components/Tooltip.md) — plain/rich tooltips on hover/focus, dismissed on Escape.
+- [Loading](docs/components/Loading.md) — icon-sized indeterminate spinner using `currentColor`.
 
 ### Containment
-- [Card (+Header/Body/Footer)](docs/components/Card.md)
-- [Dialog (+Header/Body/Footer)](docs/components/Dialog.md)
-- [BottomSheet and SideSheet](docs/components/Sheets.md)
-- [Divider](docs/components/Divider.md)
-- [List (+List.Item)](docs/components/List.md)
-- [Table (+Head/Body/Row/Cell/HeaderCell/TextContainer)](docs/components/Table.md)
+- [Card (+Header/Body/Footer)](docs/components/Card.md) — card (shape medium) with composable sub-parts.
+- [Dialog (+Header/Body/Footer)](docs/components/Dialog.md) — focus-trapped modal dialog with sub-parts.
+- [BottomSheet and SideSheet](docs/components/Sheets.md) — modal sheets over a 32% scrim.
+- [Divider](docs/components/Divider.md) — 1px `outline-variant` rule.
+- [List (+List.Item)](docs/components/List.md) — expressive (tiles) or plain list.
+- [Table (+Head/Body/Row/Cell/HeaderCell/TextContainer)](docs/components/Table.md) — data table with horizontal scroll and composable parts.
 
 ### Selection and input
-- [Checkbox](docs/components/Checkbox.md)
-- [Radio](docs/components/Radio.md)
-- [Switch](docs/components/Switch.md)
-- [Chips](docs/components/Chips.md)
-- [Slider and SliderDual](docs/components/Slider.md)
-- [TextField (InputOutlined/InputFilled/TextFieldOutlined/TextFieldFilled)](docs/components/TextField.md)
-- [Select (SelectFilled/SelectOutlined)](docs/components/Select.md)
-- [Amount](docs/components/Amount.md)
-- [DatePicker (+Docked) and DateRangePicker](docs/components/DatePicker.md)
-- [TimePicker (dial + input)](docs/components/TimePicker.md)
+- [Checkbox](docs/components/Checkbox.md) — custom-rendered checkbox over a native input.
+- [Radio](docs/components/Radio.md) — custom-rendered radio over a native input.
+- [Switch](docs/components/Switch.md) — M3 switch (52×32) over a native input.
+- [Chips](docs/components/Chips.md) — chip (height 32) with an optional remove affordance.
+- [Slider and SliderDual](docs/components/Slider.md) — single and dual-thumb sliders, arrow-key operable.
+- [TextField (InputOutlined/InputFilled/TextFieldOutlined/TextFieldFilled)](docs/components/TextField.md) — outlined/filled fields and textareas with error + supporting text.
+- [Select (SelectFilled/SelectOutlined)](docs/components/Select.md) — outlined/filled select over a listbox, with typeahead.
+- [Combobox (ComboboxFilled/ComboboxOutlined)](docs/components/Combobox.md) — ARIA combobox with consumer-controlled async options, loading and clearable.
+- [Amount](docs/components/Amount.md) — quantity stepper pill (minus / value / plus).
+- [DatePicker (+Docked) and DateRangePicker](docs/components/DatePicker.md) — modal + docked date pickers and a range picker; the docked field takes error state.
+- [TimePicker (dial + input)](docs/components/TimePicker.md) — modal time picker: clock dial + keyboard input.
 
 ### Navigation
-- [NavigationBar (+Item)](docs/components/NavigationBar.md)
-- [NavigationRail (+Item)](docs/components/NavigationRail.md)
-- [TopAppBar (Small/Center/Medium/Large)](docs/components/TopAppBar.md)
-- [DockedToolbar and FloatingToolbar](docs/components/Toolbar.md)
-- [TabsPrimary and TabsSecondary](docs/components/Tabs.md)
-- [LinkBox and LinkContainer](docs/components/Link.md)
-- [Search (+Input/Item)](docs/components/Search.md)
+- [NavigationBar (+Item)](docs/components/NavigationBar.md) — flexible bottom navigation bar.
+- [NavigationRail (+Item)](docs/components/NavigationRail.md) — navigation rail (collapsed/expanded, optional modal); items scroll only on overflow.
+- [TopAppBar (Small/Center/Medium/Large)](docs/components/TopAppBar.md) — top app bar variants as sub-parts.
+- [DockedToolbar and FloatingToolbar](docs/components/Toolbar.md) — docked and floating expressive toolbars.
+- [TabsPrimary and TabsSecondary](docs/components/Tabs.md) — primary and secondary tabs, arrow-key operable.
+- [LinkBox and LinkContainer](docs/components/Link.md) — router-agnostic native `<a>` link helpers.
+- [Search (+Input/Item)](docs/components/Search.md) — search bar + docked results; `SearchInput` supports `clearable`.
 
 ### Menus
-- [Menu (+Item/+Group/+Sub/+Label/+Divider)](docs/components/Menu.md) — shared M3E vertical-menu primitive
-- [Dropdown (+Item)](docs/components/Dropdown.md)
-- [OverflowMenu (+Item)](docs/components/OverflowMenu.md)
-- [ToggleTheme and ToggleThemeMenu](docs/components/ToggleTheme.md)
+- [Menu (+Item/Group/Sub/Label/Divider)](docs/components/Menu.md) — shared M3E vertical-menu primitive; the host positions it.
+- [Dropdown (+Item)](docs/components/Dropdown.md) — trigger + portaled Menu opening below the trigger.
+- [OverflowMenu (+Item)](docs/components/OverflowMenu.md) — corner-anchored portaled menu.
+- [ToggleTheme and ToggleThemeMenu](docs/components/ToggleTheme.md) — prebuilt light/dark theme controls.
 
 ### Media and showcase
-- [Avatar](docs/components/Avatar.md)
-- [AvatarStack](docs/components/AvatarStack.md)
-- [Img](docs/components/Img.md)
-- [MediaFrame](docs/components/MediaFrame.md)
-- [Gallery (+Row)](docs/components/Gallery.md)
-- [Stories (+User/Business)](docs/components/Stories.md)
-- [Video](docs/components/Video.md)
-- [PerspectiveImage and PerspectiveCard](docs/components/Perspective.md)
-- [Blob](docs/components/Blob.md)
+- [Avatar](docs/components/Avatar.md) — avatar with initials/placeholder fallback and badges.
+- [AvatarStack](docs/components/AvatarStack.md) — overlapping avatar row with a hover raise.
+- [Img](docs/components/Img.md) — native `<img>` in a MediaFrame (object-fit, hide-on-error).
+- [MediaFrame](docs/components/MediaFrame.md) — presentational media frame (size/aspect/radius) with media injection.
+- [Gallery (+Row)](docs/components/Gallery.md) — stacked media gallery composed with `Gallery.Row`.
+- [Stories (+User/Business)](docs/components/Stories.md) — horizontal story strip with User/Business items.
+- [Video](docs/components/Video.md) — native looping ambient/media video.
+- [PerspectiveImage and PerspectiveCard](docs/components/Perspective.md) — 3D cursor-tilt showcases.
+- [Blob](docs/components/Blob.md) — decorative blurred, morphing blob.
 
 ### Text and icons
-- [TextElement](docs/components/TextElement.md)
-- [Icon](docs/components/Icon.md)
-- [MaterialSymbol](docs/components/MaterialSymbol.md)
+- [TextElement](docs/components/TextElement.md) — polymorphic label/title/body text stack (`as`/`titleAs`/`labelAs`/`bodyAs`).
+- [Icon](docs/components/Icon.md) — icon slot helper (fixed square box).
+- [MaterialSymbol](docs/components/MaterialSymbol.md) — zero-dependency Material Symbols glyph.
 
 ### Layout
-- [Layers: Container and Section](docs/components/Layers.md)
+- [Layers: Container and Section](docs/components/Layers.md) — `Container` (dotted showcase panel) and `Section` (responsive band).

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "react-material-expressive",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Material 3 Expressive React component library. Framework-agnostic, precompiled CSS, official M3 design tokens.",
   "author": "Ger Silva",
   "homepage": "https://github.com/gersilva96/react-material-expressive#readme",
+  "llmsTxt": "./llms.txt",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/gersilva96/react-material-expressive.git"
@@ -46,6 +47,7 @@
     },
     "./styles.css": "./dist/styles.css",
     "./theme.css": "./dist/theme.css",
+    "./llms.txt": "./llms.txt",
     "./package.json": "./package.json"
   },
   "scripts": {
@@ -96,6 +98,7 @@
     "vitest": "4.1.9"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
   }
 }