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 WP 6.0 #39977

Closed
adamziel opened this issue Apr 1, 2022 · 17 comments
Closed

Audit Experimental APIs WP 6.0 #39977

adamziel opened this issue Apr 1, 2022 · 17 comments
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

@adamziel
Copy link
Contributor

adamziel commented Apr 1, 2022

This issue list all experimental APIs in the editor(s). It was generated using @noisysocks' script from #28157.

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.

Cc @WordPress/gutenberg-core

packages/annotations

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

packages/block-editor

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

packages/block-library

__experimentalAppenderTagName
__experimentalBlockAlignmentMatrixControl
__experimentalBlockContentOverlay
__experimentalBlockFullHeightAligmentControl
__experimentalBlockPatternSetup
__experimentalBlockPatternsList
__experimentalBlockVariationPicker
__experimentalBorder
__experimentalBoxControl
__experimentalCaptureToolbars
__experimentalConvert
__experimentalConvertBlockToStatic
__experimentalDateFormatPicker
__experimentalDefaultBlock
__experimentalDefaultControls
__experimentalDirectInsert
__experimentalDiscussionSettings
__experimentalDuotone
__experimentalEnableListBlockV2
__experimentalEnableQuoteBlockV2
__experimentalExposeControlsToChildren
__experimentalFontFamily
__experimentalFontStyle
__experimentalFontWeight
__experimentalGenerateAnchors
__experimentalGetBorderClassesAndStyles
__experimentalGetColorClassesAndStyles
__experimentalGetCoreBlocks
__experimentalGetDefaultTemplatePartAreas
__experimentalGetGradientClass
__experimentalGetMatchingVariation
__experimentalGetParsedPattern
__experimentalGetPatternsByBlockTypes
__experimentalGetSettings
__experimentalGetSpacingClassesAndStyles
__experimentalGroup
__experimentalHasMultipleOrigins
__experimentalImageEditingProvider
__experimentalImageEditor
__experimentalImageSizeControl
__experimentalImageURLInputUI
__experimentalIsEditingReusableBlock
__experimentalIsRenderedInSidebar
__experimentalLabel
__experimentalLayout
__experimentalLetterSpacing
__experimentalLinkControl
__experimentalNumberControl
__experimentalPanelColorGradientSettings
__experimentalParseQuantityAndUnitFromRawValue
__experimentalPreferredStyleVariations
__experimentalRegisterExperimentalCoreBlocks
__experimentalRole
__experimentalSelector
__experimentalShowTooltip
__experimentalSkipSerialization
__experimentalSlashInserter
__experimentalTextDecoration
__experimentalTextTransform
__experimentalToggleGroupControl
__experimentalToggleGroupControlOption
__experimentalToolsPanelItem
__experimentalTooltipProps
__experimentalUnitControl
__experimentalUseBlockPreview
__experimentalUseBorderProps
__experimentalUseColorProps
__experimentalUseCustomUnits
__experimentalUseEntityRecord
__experimentalUseEntityRecords
__experimentalUseGradient
__experimentalUseNoRecursiveRenders
__experimentalVersion

packages/blocks

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

packages/components

__experimentalAlignmentMatrixControl
__experimentalBorderBoxControl
__experimentalBorderControl
__experimentalBoxControl
__experimentalConfirmDialog
__experimentalDimensionControl
__experimentalDivider
__experimentalDragComponent
__experimentalElevation
__experimentalExpandOnFocus
__experimentalFeatures
__experimentalFetchLinkSuggestions
__experimentalFirstVisibleItemClass
__experimentalFlex
__experimentalFlexBlock
__experimentalFlexItem
__experimentalFlyout
__experimentalGetSettings
__experimentalGlobalStylesBaseStyles
__experimentalGrid
__experimentalHStack
__experimentalHasMultipleOrigins
__experimentalHasSplitBorders
__experimentalHeading
__experimentalHideHeader
__experimentalHint
__experimentalInputControl
__experimentalInvalid
__experimentalIsDefinedBorder
__experimentalIsEmptyBorder
__experimentalIsFocusable
__experimentalIsRenderedInSidebar
__experimentalItem
__experimentalItemGroup
__experimentalLastVisibleItemClass
__experimentalNavigation
__experimentalNavigationBackButton
__experimentalNavigationGroup
__experimentalNavigationItem
__experimentalNavigationMenu
__experimentalNavigatorBackButton
__experimentalNavigatorButton
__experimentalNavigatorProvider
__experimentalNavigatorScreen
__experimentalNumberControl
__experimentalPaletteEdit
__experimentalParseQuantityAndUnitFromRawValue
__experimentalRadio
__experimentalRadioGroup
__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
__experimentalUseDisabled
__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

packages/customize-widgets

__experimentalGetCoreBlocks
__experimentalGetInsertionPoint
__experimentalInsertionIndex
__experimentalLibrary
__experimentalReapplyBlockTypeFilters
__experimentalRegisterExperimentalCoreBlocks
__experimentalSetIsInserterOpened

packages/data

__experimentalListeningStores
__experimentalMarkListeningStores
__experimentalSubscribeStore

packages/date

__experimentalGetSettings

packages/e2e-test-utils

__experimentalActivatePlugin
__experimentalBatch
__experimentalDeactivatePlugin
__experimentalRest

packages/e2e-tests

__experimentalActivatePlugin
__experimentalAddAnnotation
__experimentalConvert
__experimentalDeactivatePlugin
__experimentalFeatures
__experimentalRemoveAnnotationsBySource
__experimentalRest

packages/edit-navigation

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

packages/edit-post

__experimentalConfirmDialog
__experimentalFeatures
__experimentalFilterValue
__experimentalFullscreenModeClose
__experimentalGetInsertionPoint
__experimentalGetPreviewDeviceType
__experimentalGetTemplateForLink
__experimentalGlobalStylesBaseStyles
__experimentalHeading
__experimentalInsertionIndex
__experimentalLayout
__experimentalLayoutStyle
__experimentalLibrary
__experimentalListView
__experimentalMainDashboardButton
__experimentalPersistentListViewFeatures
__experimentalPreferredStyleVariations
__experimentalPreviewOptions
__experimentalReapplyBlockTypeFilters
__experimentalRegisterExperimentalCoreBlocks
__experimentalSetIsInserterOpened
__experimentalSetPreviewDeviceType
__experimentalText
__experimentalUseDialog
__experimentalUseNoRecursiveRenders
__experimentalUseResizeCanvas
__experimentalUseSlot

packages/edit-site

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

packages/edit-widgets

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

packages/editor

__experimentalBlockDirectory
__experimentalBlockPatternCategories
__experimentalBlockPatterns
__experimentalCanLockBlocks
__experimentalCanUserUseUnfilteredHTML
__experimentalConfirmDialog
__experimentalCreatePageEntity
__experimentalDiscussionSettings
__experimentalFeatures
__experimentalFetchLinkSuggestions
__experimentalFetchRichUrlData
__experimentalFetchUrlData
__experimentalGenerateAnchors
__experimentalGetDefaultTemplatePartAreas
__experimentalGetDefaultTemplateType
__experimentalGetDefaultTemplateTypes
__experimentalGetDirtyEntityRecords
__experimentalGetEntitiesBeingSaved
__experimentalGetSettings
__experimentalGetTemplateInfo
__experimentalGlobalStylesBaseStyles
__experimentalPreferPatternsOnRoot
__experimentalPreferredStyleVariations
__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/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
__experimentalUseEntityRecord

lib

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

@adamziel adamziel 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 Apr 1, 2022
@adamziel adamziel moved this from Triage to In Progress in WordPress 6.0 Editor Tasks Apr 1, 2022
@adamziel
Copy link
Contributor Author

adamziel commented Apr 1, 2022

@Mamaduka what are your thoughts on __experimentalGenerateAnchors? It seems to be relevant to the ToC block and the heading block.

@Mamaduka
Copy link
Member

Mamaduka commented Apr 3, 2022

@adamziel, I think boolean settings are as stable as they get.

@youknowriad
Copy link
Contributor

youknowriad commented Apr 4, 2022

@youknowriad
Copy link
Contributor

cc @ciampo to see if there's any component that should be stabilized.

@gziolo
Copy link
Member

gziolo commented Apr 4, 2022

Regardless of the WordPress 6.0 release cycle, it looks like we need to revisit the current approach to introducing experimental APIs. In my opinion, it's getting out of control because developers who authored those APIs way too often leave them documented only in the code and they rarely come back to promote them to final APIs.

@adamziel
Copy link
Contributor Author

adamziel commented Apr 4, 2022

__experimentalUseEntityRecord
__experimentalUseEntityRecords

I think these two APIs can be stabilized.

__experimentalUseQuerySelect

I would like to make it a public API eventually, but it's internal for now so it doesn't matter for the 6.0 release.

@cbravobernal
Copy link
Contributor

packages/block-library

I guess we can promote the Avatar block to stable. I don’t know how much has been tested apart from the development, but it’s true that we received some feedback and a couple of fixes. Also, it would be great to create patterns for posts authors and will also become part of the new Comments blocks if we land it.

__experimentalDiscussionSettings

The Avatar block uses this experimental feature (inside lib/experimental folder), in order to get the default Avatar chosen in Discussion settings. I'm new to this, so I don't know if we should also move experimentalDiscussionSettings.

This last one may need in the future to add more settings to the list.

@Mamaduka
Copy link
Member

Mamaduka commented Apr 4, 2022

There's a plan to stabilize Block Locking settings before WP 6.0 (#39809). We can also do the same for __experimentalGenerateAnchors.

@aaronrobertshaw
Copy link
Contributor

__experimentalBorder
__experimentalFontFamily
__experimentalFontStyle
__experimentalFontWeight

Any plans to stabilize some of these block supports. @aaronrobertshaw @andrewserong @ramonjd

There's a major update for __experimentalBorder that is close to landing. I think it will be best to let that settle a bit before we stabilize this one though.

As for the typography supports, I wasn't aware of any plans to stabilize them prior to 6.0.

We are avoiding adopting the font family support on new blocks until we have a better means of adding custom fonts. Given that, I'd expect __experimentalFontFamily, at least, to remain __experimental for now.

After 6.0, I'll work through stabilizing all the block support APIs that might be ready for it.

Possible candidates for stabilization before 6.1

__experimentalBorderRadiusControl
__experimentalBorderStyleControl
__experimentalBorder
__experimentalDimensions
__experimentalFontAppearanceControl
__experimentalFontFamilyControl
__experimentalFontFamily
__experimentalFontStyle
__experimentalFontWeight
__experimentalGetBorderClassesAndStyles
__experimentalGetColorClassesAndStyles
__experimentalGetSpacingClassesAndStyles
__experimentalLayout
__experimentalLetterSpacingControl
__experimentalLetterSpacing
__experimentalSkipSerialization
__experimentalTextDecorationControl
__experimentalTextDecoration
__experimentalTextTransformControl
__experimentalTextTransform
__experimentalUseBorderProps
__experimentalUseColorProps

@ciampo
Copy link
Contributor

ciampo commented Apr 5, 2022

cc @ciampo to see if there's any component that should be stabilized.

Thank you for the ping! We don't have any components to mark as stable at the moment

@getdave
Copy link
Contributor

getdave commented Apr 5, 2022

@adamziel I've raised this to promote fetchLinkSuggestions.

@Mamaduka
Copy link
Member

Mamaduka commented Apr 7, 2022

PRs to stabilize two settings I introduced in this cycle - #40143 and #40145.

@andronocean
Copy link

andronocean commented Apr 9, 2022

Is there any chance that __experimentalGetTemplateForLink could be marked stable? It actually fixes a bug that causes the site editor to fail to launch on WP 5.9 when WP is installed in a subdirectory.

Full bug info: https://core.trac.wordpress.org/ticket/55288

Edit: the fix in fact comes from the setPage function, which calls __experimentalGetTemplateForLink. I'm assuming the API needs to be stable to make it into 6.0... but maybe I'm mistaken?

.__experimentalGetTemplateForLink( page.path );

@adamziel
Copy link
Contributor Author

@andronocean Experimental APIs generally make it to the release unless they fall into a few categories like blocks. WP 6.0 Beta1 was released yesterday and __experimentalGetTemplateForLink is a part of it.

@adamziel
Copy link
Contributor Author

adamziel commented Apr 13, 2022

Since we've entered the feature freeze period yesterday after the WordPress 6.0 beta 1 was released, I am closing this issue as it isn't actionable anymore.

@imangm
Copy link
Contributor

imangm commented Jun 29, 2022

Do you know what has happened to __experimentalFlyout? I can't find it anywhere... https://github.com/WordPress/gutenberg/search?q=__experimentalFlyout

@ciampo
Copy link
Contributor

ciampo commented Jun 29, 2022

Do you know what has happened to __experimentalFlyout? I can't find it anywhere... https://github.com/WordPress/gutenberg/search?q=__experimentalFlyout

Hey @imangm — the experimental Flyout component has been removed in #40740 — see the PR for more details about the rationale.

@ciampo ciampo reopened this Jun 29, 2022
Repository owner moved this from Done to Triage in WordPress 6.0 Editor Tasks Jun 29, 2022
@ciampo ciampo closed this as completed Jun 29, 2022
Repository owner moved this from Triage to Done in WordPress 6.0 Editor Tasks Jun 29, 2022
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
Archived in project
Development

No branches or pull requests

10 participants