Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

docs(public-component-api): useMenuPress has no create twin by owner decision (#10053)

Cindy Zhang64b56eef9ed3
diff --git a/docs/architecture/public-component-api.md b/docs/architecture/public-component-api.md
index e53f79c6e6..5e3f6a4f38 100644
--- a/docs/architecture/public-component-api.md
+++ b/docs/architecture/public-component-api.md
@@ -245,7 +245,9 @@ guidance owns the process used to propose and test APIs.
output feeds one Astryx component prop, or `useAnimatedLayout`,
`useEntryAnimation`, `useContainerReveal`, `useTouchTrigger`,
`useTableRowExpansion`, `useTableColumnResize`) has none by default; the owner
- may add one (owner decision, 2026-11-04).
+ may add one (owner decision, 2026-11-04). `useMenuPress` has no non-React
+ equivalent by owner decision (2026-11-04); one may be added when a caller
+ needs it.
- **INV23 — Each private data attribute has one owner module.** A
`data-astryx-*` attribute is private unless this invariant names it public.
Each private attribute has one internal owner module in the package that
@@ -413,7 +415,7 @@ Rejected: component-local names for shared concepts.
| INV20 | Public-API review of new boolean props | A boolean whose only effect is a visual swap where a variant fits |
| INV21 | Public-API review against existing props, components, hooks, and factories | A new API that shares a job with an existing one that is not being deprecated in its favor; a hook fed to one component slot prop counted as a second API |
| INV21a | Public-API review of each breaking or deprecating change to a shipped API | A breaking or deprecating change to a shipped public API justified only by conformance to a system rule |
-| INV22 | Public-API review of each public interaction utility hook against its `create…` equivalent | An interaction utility hook with no `create…` equivalent, outside hooks whose result only an Astryx component or StyleX can use, or an equivalent whose option names and meanings, events, or return concepts differ from its hook |
+| INV22 | Public-API review of each public interaction utility hook against its `create…` equivalent | An interaction utility hook with no `create…` equivalent, outside hooks whose result only an Astryx component or StyleX can use and `useMenuPress` (by owner decision), or an equivalent whose option names and meanings, events, or return concepts differ from its hook |
| INV23 | `@astryx/no-raw-private-attribute` lint with its baseline (test files exempt), plus public-API review of the public list | A `data-astryx-*` name or selector written outside its owner module, a test, or the public list; a `dataAttr()` call that names a private attribute; an owner module that exports its raw name or a selector; a package that imports another package's owner module; a caller that sets a property an owner style it spreads also sets; a private attribute in a public export, `.doc.mjs`, or Changeset; a baseline entry added; a public data attribute changed without INV9 evidence |
| INV24 | API report generator tests over representative entry points, plus the pull-request report's API changes | A promised export, prop, hook, type, custom property, theme target, or public attribute is missing from a report; a reachable internal-tagged member is missing; an `./internal/*` or Lab member appears; a stale committed report is not flagged, or its rows are listed as the pull request's API changes; the check fails a pull request |
| INV25 | Public-API review routing against the pull request's API changes | A row that no current record decides does not reach human review; a row a current record decides is held for a human; an undeclared row alone draws a request for changes |
@@ -442,7 +444,7 @@ Known verification gaps:
another keeps its name until a minor renames it under INV9. Outline's
`offset` is the distance below the top of its scroll root
(`component:Outline` FR4), not a gap from an anchor.
-- INV22: known gaps include `useLongPress`, `useMenuPress`, `usePressFeedback`,
+- INV22: known gaps include `useLongPress`, `usePressFeedback`,
`useClickableContainer`, `useInputContainer`, `useOverlay`, `useCombobox`,
`useMultiCombobox`, `useResizable`, `useTooltip`, `useHoverCard`, and
`useChatStreamScroll`: each attaches gesture, press, drag, or motion behavior