Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Audit Experimental APIs for WP 6.1 #43635

Closed
ockham opened this issue Aug 26, 2022 · 1 comment
Closed

Audit Experimental APIs for WP 6.1 #43635

ockham opened this issue Aug 26, 2022 · 1 comment
Labels
[Type] Code Quality Issues or PRs that relate to code quality [Type] Tracking Issue Tactical breakdown of efforts across the codebase and/or tied to Overview issues.

Comments

@ockham
Copy link
Contributor

ockham commented Aug 26, 2022

Based on @adamziel's #39977. Generated using @noisysocks' script from #28157.

This issue list all experimental APIs in the editor(s).

The script overreports, but I think it's a nice way to highlight API usage across the packages.

The list is long, and we don't have to go through all of the items. However, the suggestion is the same - if you have introduced/used one of the APIs, please follow the steps outlined (by @youknowriad in #31416) below:

  • If it's an API that is never meant to be made available to third-party developers as is, rename it to __unstable instead
  • If you think it's time to consider making the API stable, open a PR to rename it.
  • If you think it's an API worth having, but you're still uncertain whether future changes might impact it, consider asking for help to make the right call, ping me, or comment here.
  • if you want to give the API more time to mature, just ignore it for now.

While not immediately relevant for WP 6.1, note this ongoing discussion about potentially refraining from backporting __experimental features to Core in the future.

Cc @WordPress/gutenberg-core

packages/annotations

__experimentalAddAnnotation
__experimentalCreateOnChangeEditableValue
__experimentalCreatePrepareEditableTree
__experimentalGetAllAnnotationsForBlock
__experimentalGetAnnotations
__experimentalGetAnnotationsForBlock
__experimentalGetAnnotationsForRichText
__experimentalGetPropsForEditableTreeChangeHandler
__experimentalGetPropsForEditableTreePreparation
__experimentalRemoveAnnotation
__experimentalRemoveAnnotationsBySource
__experimentalUpdateAnnotationRange

packages/block-directory

__experimentalIsFocusable

packages/block-editor

__experimentalAlignmentMatrixControl
__experimentalAppenderTagName
__experimentalApplyValueToSides
__experimentalBlockAlignmentMatrixControl
__experimentalBlockDirectory
__experimentalBlockFullHeightAligmentControl
__experimentalBlockPatternCategories
__experimentalBlockPatternSetup
__experimentalBlockPatterns
__experimentalBlockPatternsList
__experimentalBlockVariationPicker
__experimentalBlockVariationTransforms
__experimentalBorder
__experimentalBorderBoxControl
__experimentalBorderRadiusControl
__experimentalBoxControl
__experimentalCanUserUseUnfilteredHTML
__experimentalCaptureToolbars
__experimentalCloneSanitizedBlock
__experimentalColorGradientControl
__experimentalColorGradientSettingsDropdown
__experimentalConvertBlockToStatic
__experimentalCreateOnChangeEditableValue
__experimentalCreatePrepareEditableTree
__experimentalDateFormatPicker
__experimentalDefaultBlock
__experimentalDefaultControls
__experimentalDirectInsert
__experimentalDragComponent
__experimentalDropdownContentWrapper
__experimentalDuotone
__experimentalDuotoneControl
__experimentalExposeControlsToChildren
__experimentalFeatures
__experimentalFetchLinkSuggestions
__experimentalFetchReusableBlocks
__experimentalFetchRichUrlData
__experimentalFilterValue
__experimentalFirstVisibleItemClass
__experimentalFontAppearanceControl
__experimentalFontFamily
__experimentalFontFamilyControl
__experimentalFontStyle
__experimentalFontWeight
__experimentalGetAccessibleBlockLabel
__experimentalGetActiveBlockIdByBlockNames
__experimentalGetAllowedBlocks
__experimentalGetAllowedPatterns
__experimentalGetBlockAttributesNamesByRole
__experimentalGetBlockLabel
__experimentalGetBlockListSettingsForBlocks
__experimentalGetBorderClassesAndStyles
__experimentalGetColorClassesAndStyles
__experimentalGetDirectInsertBlock
__experimentalGetElementClassName
__experimentalGetGapCSSValue
__experimentalGetGlobalBlocksByName
__experimentalGetGradientClass
__experimentalGetGradientObjectByGradientValue
__experimentalGetLastBlockAttributeChanges
__experimentalGetMatchingVariation
__experimentalGetParsedPattern
__experimentalGetPatternTransformItems
__experimentalGetPatternsByBlockTypes
__experimentalGetPropsForEditableTreeChangeHandler
__experimentalGetPropsForEditableTreePreparation
__experimentalGetReusableBlockTitle
__experimentalGetSettings
__experimentalGetSpacingClassesAndStyles
__experimentalGlobalStylesBaseStyles
__experimentalGroup
__experimentalHStack
__experimentalHandleURLSuggestions
__experimentalHasMultipleOrigins
__experimentalHasSplitBorders
__experimentalHeading
__experimentalHideChildBlockControls
__experimentalHint
__experimentalImageEditingProvider
__experimentalImageEditor
__experimentalImageSizeControl
__experimentalImageURLInputUI
__experimentalInitialIndex
__experimentalInitialPosition
__experimentalInsertionIndex
__experimentalInspectorPopoverHeader
__experimentalIsDefinedBorder
__experimentalIsFocusable
__experimentalIsItemGroup
__experimentalIsQuick
__experimentalIsRenderedInSidebar
__experimentalLastVisibleItemClass
__experimentalLayout
__experimentalLayoutStyle
__experimentalLetterSpacing
__experimentalLetterSpacingControl
__experimentalLibrary
__experimentalLinkControl
__experimentalLinkControlSearchInput
__experimentalLinkControlSearchItem
__experimentalLinkControlSearchResults
__experimentalListView
__experimentalLive
__experimentalMinHeight
__experimentalNumberControl
__experimentalOnClick
__experimentalOnIndexChange
__experimentalOnlyMediaLibrary
__experimentalPadding
__experimentalPanelColorGradientSettings
__experimentalParentSelector
__experimentalParseQuantityAndUnitFromRawValue
__experimentalPreferPatternsOnRoot
__experimentalPreferredStyleVariations
__experimentalPreviewOptions
__experimentalPublishDateTimePicker
__experimentalRecursionProvider
__experimentalRenderControl
__experimentalRenderSuggestions
__experimentalResponsiveBlockControl
__experimentalReusableBlocks
__experimentalRichText
__experimentalRole
__experimentalSelectBlock
__experimentalSetIsInserterOpened
__experimentalSettings
__experimentalShareWithChildBlocks
__experimentalShouldInsertAtTheTop
__experimentalShowInitialSuggestions
__experimentalSkipSerialization
__experimentalSlashInserter
__experimentalSpacer
__experimentalSpacingSizesControl
__experimentalStyleProvider
__experimentalText
__experimentalTextDecoration
__experimentalTextDecorationControl
__experimentalTextTransform
__experimentalTextTransformControl
__experimentalToolbar
__experimentalToolbarContext
__experimentalToolsPanel
__experimentalToolsPanelContext
__experimentalToolsPanelItem
__experimentalTransferDataType
__experimentalTreeGrid
__experimentalTreeGridCell
__experimentalTreeGridItem
__experimentalTreeGridRow
__experimentalTruncate
__experimentalUndo
__experimentalUnitControl
__experimentalUpdateSelection
__experimentalUseBlockOverlayActive
__experimentalUseBlockPreview
__experimentalUseBorderProps
__experimentalUseColorProps
__experimentalUseCustomSides
__experimentalUseCustomUnits
__experimentalUseDropZone
__experimentalUseFixedWindowList
__experimentalUseGradient
__experimentalUseHasRecursion
__experimentalUseMultipleOriginColorsAndGradients
__experimentalUseResizeCanvas
__experimentalUseSlot
__experimentalVStack
__experimentalVersion

packages/block-library

__experimentalAppenderTagName
__experimentalBlockAlignmentMatrixControl
__experimentalBlockFullHeightAligmentControl
__experimentalBlockPatternSetup
__experimentalBlockPatternsList
__experimentalBlockVariationPicker
__experimentalBorder
__experimentalCaptureToolbars
__experimentalColorGradientSettingsDropdown
__experimentalConvert
__experimentalConvertBlockToStatic
__experimentalDateFormatPicker
__experimentalDefault
__experimentalDefaultBlock
__experimentalDefaultControls
__experimentalDirectInsert
__experimentalDiscussionSettings
__experimentalDuotone
__experimentalEnableListBlockV2
__experimentalExposeControlsToChildren
__experimentalFontFamily
__experimentalFontStyle
__experimentalFontWeight
__experimentalGetBorderClassesAndStyles
__experimentalGetColorClassesAndStyles
__experimentalGetCoreBlocks
__experimentalGetDefaultTemplatePartAreas
__experimentalGetElementClassName
__experimentalGetGlobalBlocksByName
__experimentalGetGradientClass
__experimentalGetMatchingVariation
__experimentalGetParsedPattern
__experimentalGetPatternsByBlockTypes
__experimentalGetSettings
__experimentalGetSpacingClassesAndStyles
__experimentalGroup
__experimentalHStack
__experimentalHasMultipleOrigins
__experimentalHasSplitBorders
__experimentalImageEditingProvider
__experimentalImageEditor
__experimentalImageSizeControl
__experimentalImageURLInputUI
__experimentalIsEditingReusableBlock
__experimentalIsRenderedInSidebar
__experimentalLabel
__experimentalLayout
__experimentalLetterSpacing
__experimentalLinkControl
__experimentalNumberControl
__experimentalOnEnter
__experimentalPanelColorGradientSettings
__experimentalParseQuantityAndUnitFromRawValue
__experimentalPreferredStyleVariations
__experimentalPublishDateTimePicker
__experimentalRecursionProvider
__experimentalRegisterExperimentalCoreBlocks
__experimentalRole
__experimentalSelector
__experimentalSettings
__experimentalShowTooltip
__experimentalSkipSerialization
__experimentalSlashInserter
__experimentalStyle
__experimentalTextDecoration
__experimentalTextTransform
__experimentalToggleGroupControl
__experimentalToggleGroupControlOption
__experimentalToolsPanel
__experimentalToolsPanelItem
__experimentalTooltipProps
__experimentalUnitControl
__experimentalUseBlockOverlayActive
__experimentalUseBlockPreview
__experimentalUseBorderProps
__experimentalUseColorProps
__experimentalUseCustomUnits
__experimentalUseGradient
__experimentalUseHasRecursion
__experimentalUseMultipleOriginColorsAndGradients
__experimentalUseResourcePermissions
__experimentalVersion

packages/blocks

__experimentalBorder
__experimentalCloneSanitizedBlock
__experimentalConvert
__experimentalDuotone
__experimentalFontFamily
__experimentalFontStyle
__experimentalFontWeight
__experimentalGetAccessibleBlockLabel
__experimentalGetBlockAttributesNamesByRole
__experimentalGetBlockLabel
__experimentalGetUnprocessedBlockTypes
__experimentalLabel
__experimentalLetterSpacing
__experimentalReapplyBlockTypeFilters
__experimentalRegisterBlockType
__experimentalRole
__experimentalSanitizeBlockAttributes
__experimentalTextDecoration
__experimentalTextTransform

packages/components

__experimentalAlignmentMatrixControl
__experimentalApplyValueToSides
__experimentalBorderBoxControl
__experimentalBorderControl
__experimentalBoxControl
__experimentalConfirmDialog
__experimentalDimensionControl
__experimentalDivider
__experimentalDragComponent
__experimentalDropdownContentWrapper
__experimentalElevation
__experimentalExpandOnFocus
__experimentalFeatures
__experimentalFetchLinkSuggestions
__experimentalFirstVisibleItemClass
__experimentalGetSettings
__experimentalGlobalStylesBaseStyles
__experimentalGrid
__experimentalHStack
__experimentalHasMultipleOrigins
__experimentalHasSplitBorders
__experimentalHeading
__experimentalHideHeader
__experimentalHint
__experimentalInputControl
__experimentalInputControlPrefixWrapper
__experimentalInputControlSuffixWrapper
__experimentalInvalid
__experimentalIsDefinedBorder
__experimentalIsEmptyBorder
__experimentalIsFocusable
__experimentalIsIconGroup
__experimentalIsRenderedInSidebar
__experimentalItem
__experimentalItemGroup
__experimentalLastVisibleItemClass
__experimentalNavigation
__experimentalNavigationBackButton
__experimentalNavigationGroup
__experimentalNavigationItem
__experimentalNavigationMenu
__experimentalNavigatorBackButton
__experimentalNavigatorButton
__experimentalNavigatorProvider
__experimentalNavigatorScreen
__experimentalNumberControl
__experimentalPaletteEdit
__experimentalParseQuantityAndUnitFromRawValue
__experimentalRadio
__experimentalRadioGroup
__experimentalRenderItem
__experimentalScrollable
__experimentalShowHowTo
__experimentalShowTooltip
__experimentalSpacer
__experimentalStyleProvider
__experimentalSurface
__experimentalText
__experimentalToggleGroupControl
__experimentalToggleGroupControlOption
__experimentalToggleGroupControlOptionBase
__experimentalToggleGroupControlOptionIcon
__experimentalToolbarContext
__experimentalToolsPanel
__experimentalToolsPanelContext
__experimentalToolsPanelItem
__experimentalTooltipProps
__experimentalTransferDataType
__experimentalTreeGrid
__experimentalTreeGridCell
__experimentalTreeGridItem
__experimentalTreeGridRow
__experimentalTruncate
__experimentalUnitControl
__experimentalUseCustomUnits
__experimentalUseDialog
__experimentalUseDragging
__experimentalUseDropZone
__experimentalUseFocusOutside
__experimentalUseNavigator
__experimentalUseSlot
__experimentalVStack
__experimentalValidateInput
__experimentalView
__experimentalZStack

packages/compose

__experimentalUseDialog
__experimentalUseDragging
__experimentalUseDropZone
__experimentalUseFixedWindowList
__experimentalUseFocusOutside
__experimentalWidthProvider

packages/core-data

__experimentalBatch
__experimentalFetchLinkSuggestions
__experimentalFetchUrlData
__experimentalGetCurrentGlobalStylesId
__experimentalGetCurrentThemeBaseGlobalStyles
__experimentalGetCurrentThemeGlobalStylesVariations
__experimentalGetDirtyEntityRecords
__experimentalGetEntitiesBeingSaved
__experimentalGetEntityRecordNoResolver
__experimentalGetTemplateForLink
__experimentalNoFetch
__experimentalReceiveCurrentGlobalStylesId
__experimentalReceiveThemeBaseGlobalStyles
__experimentalReceiveThemeGlobalStyleVariations
__experimentalSaveSpecifiedEntityEdits
__experimentalUseEntityRecord
__experimentalUseEntityRecords
__experimentalUseQuerySelect
__experimentalUseResourcePermissions

packages/customize-widgets

__experimentalGetCoreBlocks
__experimentalGetInsertionPoint
__experimentalInsertionIndex
__experimentalLibrary
__experimentalReapplyBlockTypeFilters
__experimentalRegisterExperimentalCoreBlocks
__experimentalSetIsInserterOpened

packages/date

__experimentalGetSettings

packages/e2e-test-utils

__experimentalActivatePlugin
__experimentalBatch
__experimentalDeactivatePlugin
__experimentalRest

packages/e2e-tests

__experimentalActivatePlugin
__experimentalAddAnnotation
__experimentalBatch
__experimentalConvert
__experimentalDeactivatePlugin
__experimentalFeatures
__experimentalRemoveAnnotationsBySource
__experimentalRest

packages/edit-navigation

__experimentalBatch
__experimentalConfirmDialog
__experimentalFetchLinkSuggestions
__experimentalFetchRichUrlData
__experimentalFetchUrlData
__experimentalGetDirtyEntityRecords
__experimentalInsertionIndex
__experimentalIsFocusable
__experimentalLibrary
__experimentalNoFetch
__experimentalReapplyBlockTypeFilters
__experimentalRegisterExperimentalCoreBlocks
__experimentalSetIsInserterOpened
__experimentalText
__experimentalUseDialog

packages/edit-post

__experimentalBlockPatternsList
__experimentalConfirmDialog
__experimentalFilterValue
__experimentalFullscreenModeClose
__experimentalGetInsertionPoint
__experimentalGetPatternsByBlockTypes
__experimentalGetPreviewDeviceType
__experimentalGetTemplateForLink
__experimentalGlobalStylesBaseStyles
__experimentalHeading
__experimentalInsertionIndex
__experimentalInspectorPopoverHeader
__experimentalLayout
__experimentalLayoutStyle
__experimentalLibrary
__experimentalListView
__experimentalMainDashboardButton
__experimentalPreferredStyleVariations
__experimentalPreviewOptions
__experimentalReapplyBlockTypeFilters
__experimentalRecursionProvider
__experimentalRegisterExperimentalCoreBlocks
__experimentalSetIsInserterOpened
__experimentalSetPreviewDeviceType
__experimentalText
__experimentalUseDialog
__experimentalUseResizeCanvas
__experimentalUseSlot

packages/edit-site

__experimentalAdditionalBlockPatternCategories
__experimentalAdditionalBlockPatterns
__experimentalBlockPatternCategories
__experimentalBlockPatterns
__experimentalBorder
__experimentalBorderBoxControl
__experimentalBorderRadiusControl
__experimentalBoxControl
__experimentalColorGradientControl
__experimentalDefault
__experimentalDuotone
__experimentalFeatures
__experimentalFetchLinkSuggestions
__experimentalFetchRichUrlData
__experimentalFetchUrlData
__experimentalFilterValue
__experimentalFontAppearanceControl
__experimentalFontFamilyControl
__experimentalGetActiveBlockIdByBlockNames
__experimentalGetBlockLabel
__experimentalGetCurrentGlobalStylesId
__experimentalGetCurrentThemeBaseGlobalStyles
__experimentalGetCurrentThemeGlobalStylesVariations
__experimentalGetDefaultTemplatePartAreas
__experimentalGetDefaultTemplateTypes
__experimentalGetDirtyEntityRecords
__experimentalGetGapCSSValue
__experimentalGetGlobalBlocksByName
__experimentalGetInsertionPoint
__experimentalGetPreviewDeviceType
__experimentalGetTemplateForLink
__experimentalGetTemplateInfo
__experimentalGrid
__experimentalHStack
__experimentalHasMultipleOrigins
__experimentalHasSplitBorders
__experimentalHeading
__experimentalInsertionIndex
__experimentalIsDefinedBorder
__experimentalIsRenderedInSidebar
__experimentalItem
__experimentalItemGroup
__experimentalLayout
__experimentalLetterSpacingControl
__experimentalLibrary
__experimentalLinkControl
__experimentalListView
__experimentalMainDashboardButton
__experimentalNavigation
__experimentalNavigationBackButton
__experimentalNavigationGroup
__experimentalNavigationItem
__experimentalNavigationMenu
__experimentalNavigationToggle
__experimentalNavigatorBackButton
__experimentalNavigatorButton
__experimentalNavigatorProvider
__experimentalNavigatorScreen
__experimentalPaletteEdit
__experimentalPreferPatternsOnRoot
__experimentalPreviewOptions
__experimentalRadio
__experimentalRadioGroup
__experimentalReapplyBlockTypeFilters
__experimentalRegisterExperimentalCoreBlocks
__experimentalReusableBlocks
__experimentalSelector
__experimentalSetIsInserterOpened
__experimentalSetPreviewDeviceType
__experimentalSkipSerialization
__experimentalSpacer
__experimentalSpacingSizesControl
__experimentalText
__experimentalToggleGroupControl
__experimentalToggleGroupControlOption
__experimentalToolsPanel
__experimentalToolsPanelItem
__experimentalUnitControl
__experimentalUseCustomSides
__experimentalUseCustomUnits
__experimentalUseDialog
__experimentalUseResizeCanvas
__experimentalUseSlot
__experimentalVStack
__experimentalView
__experimentalZStack

packages/edit-widgets

__experimentalBatch
__experimentalFetchLinkSuggestions
__experimentalGetCoreBlocks
__experimentalGetInsertionPoint
__experimentalInsertionIndex
__experimentalLabel
__experimentalLibrary
__experimentalListView
__experimentalParentSelector
__experimentalReapplyBlockTypeFilters
__experimentalRegisterExperimentalCoreBlocks
__experimentalReusableBlocks
__experimentalSetIsInserterOpened
__experimentalToolbar
__experimentalUseDialog

packages/editor

__experimentalAdditionalBlockPatternCategories
__experimentalAdditionalBlockPatterns
__experimentalBlockDirectory
__experimentalBlockPatternCategories
__experimentalBlockPatterns
__experimentalCanUserUseUnfilteredHTML
__experimentalConfirmDialog
__experimentalCreatePageEntity
__experimentalDiscussionSettings
__experimentalFeatures
__experimentalFetchLinkSuggestions
__experimentalFetchRichUrlData
__experimentalFetchUrlData
__experimentalGetDefaultTemplatePartAreas
__experimentalGetDefaultTemplateType
__experimentalGetDefaultTemplateTypes
__experimentalGetDirtyEntityRecords
__experimentalGetEntitiesBeingSaved
__experimentalGetSettings
__experimentalGetTemplateInfo
__experimentalGlobalStylesBaseStyles
__experimentalInspectorPopoverHeader
__experimentalPreferPatternsOnRoot
__experimentalPreferredStyleVariations
__experimentalPublishDateTimePicker
__experimentalReusableBlocks
__experimentalRichText
__experimentalSaveSpecifiedEntityEdits
__experimentalSetIsInserterOpened
__experimentalShouldInsertAtTheTop
__experimentalTearDownEditor
__experimentalUndo
__experimentalUseDialog
__experimentalUserCanCreatePages

packages/eslint-plugin

__experimentalFoo
__experimentalSafe
__experimentalUnsafe

packages/format-library

__experimentalCreatePageEntity
__experimentalLinkControl
__experimentalUserCanCreatePages

packages/interface

__experimentalHStack
__experimentalItem
__experimentalItemGroup
__experimentalNavigatorBackButton
__experimentalNavigatorButton
__experimentalNavigatorProvider
__experimentalNavigatorScreen
__experimentalText
__experimentalTruncate

packages/react-native-editor

__experimentalEnableListBlockV2

packages/reusable-blocks

__experimentalConvertBlockToStatic
__experimentalConvertBlocksToReusable
__experimentalDeleteReusableBlock
__experimentalIsEditingReusableBlock
__experimentalSetEditingReusableBlock

packages/rich-text

__experimentalCreateOnChangeEditableValue
__experimentalCreatePrepareEditableTree
__experimentalFeatures
__experimentalGetPropsForEditableTreeChangeHandler
__experimentalGetPropsForEditableTreePreparation
__experimentalGlobalStylesBaseStyles
__experimentalRichText

packages/server-side-render

__experimentalSanitizeBlockAttributes

packages/widgets

__experimentalConvert
__experimentalLabel

lib

__experimentalBorder
__experimentalDefault
__experimentalDimensions
__experimentalDiscussionSettings
__experimentalDuotone
__experimentalEnableListBlockV2
__experimentalEnableQuoteBlockV2
__experimentalFeatures
__experimentalFontFamily
__experimentalFontStyle
__experimentalFontWeight
__experimentalLayout
__experimentalLetterSpacing
__experimentalSelector
__experimentalSkipSerialization
__experimentalStyle
__experimentalStyles
__experimentalTextDecoration
__experimentalTextTransform

@ockham ockham added [Type] Code Quality Issues or PRs that relate to code quality [Type] Tracking Issue Tactical breakdown of efforts across the codebase and/or tied to Overview issues. labels Aug 26, 2022
@ockham ockham changed the title Audit Experimental APIs WP 6.1 Audit Experimental APIs for WP 6.1 Aug 26, 2022
@ockham ockham moved this from Triage to Bumped to 6.2 in WordPress 6.1 Editor Tasks Sep 28, 2022
@colorful-tones
Copy link
Member

colorful-tones commented Oct 12, 2022

@ockham Do you happen to know the current state of border support?

I was looking at the current Button block's use of __experimentalBorder (see line 90), and if I understand this issue's intent. Then I assume if we want to see __experimentalBorder get merged into core, we would have to open a new Issue around its proposal and probably link back to this issue, correct?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
[Type] Code Quality Issues or PRs that relate to code quality [Type] Tracking Issue Tactical breakdown of efforts across the codebase and/or tied to Overview issues.
Projects
No open projects
Status: Bumped to 6.2
Development

No branches or pull requests

4 participants