Lock private APIs

WordPress · mirka · Oct 22, 2025 · Oct 13, 2025 · Oct 13, 2025 · Oct 14, 2025
commit 71d1f63ed35d7f1e8f37b6e76d346124a1489ac1
diff --git a/package-lock.json b/package-lock.json
@@ -41,6 +41,7 @@
 	"sideEffects": false,
 	"dependencies": {
 		"@wordpress/element": "file:../element",
+		"@wordpress/private-apis": "file:../private-apis",
 		"colorjs.io": "^0.5.2"
 	},
 	"peerDependencies": {

@@ -1,2 +1,2 @@
-export { ThemeProvider } from './theme-provider';
-export { useThemeProviderStyles } from './use-theme-provider-styles';
+// Private APIs.
+export { privateApis } from './private-apis';
@@ -0,0 +1,10 @@
+/**
+ * WordPress dependencies
+ */
+import { __dangerousOptInToUnstableAPIsOnlyForCoreModules } from '@wordpress/private-apis';
+
+export const { lock, unlock } =
+	__dangerousOptInToUnstableAPIsOnlyForCoreModules(
+		'I acknowledge private features are not for use in themes or plugins and doing so will break in the next version of WordPress.',
+		'@wordpress/theme'
+	);
@@ -0,0 +1,12 @@
+/**
+ * Internal dependencies
+ */
+import { lock } from './lock-unlock';
+import { ThemeProvider } from './theme-provider';
+import { useThemeProviderStyles } from './use-theme-provider-styles';
+
+export const privateApis = {};
+lock( privateApis, {
+	ThemeProvider,
+	useThemeProviderStyles,
+} );
diff --git a/packages/theme/src/test/theme-provider.test.tsx b/packages/theme/src/test/theme-provider.test.tsx
@@ -6,7 +6,7 @@ import { render } from '@testing-library/react';
 /**
  * Internal dependencies
  */
-import { ThemeProvider } from '../index';
+import { ThemeProvider } from '../theme-provider';
 
 const NestingDebug = ( { bg = '', primary = '' } ) => (
 	<div

@@ -7,6 +7,6 @@
 		"moduleResolution": "bundler",
 		"types": [ "jest", "@testing-library/jest-dom" ]
 	},
-	"references": [ { "path": "../element" } ],
+	"references": [ { "path": "../element" }, { "path": "../private-apis" } ],
 	"include": [ "src", "types", "scripts", "build/js", "terrazzo.config.ts" ]
 }