An open source design system that's fully customizable and agent ready
TypeScript
feat(core): add server-safe utility subpath exports (#1981)
Cindy Zhang69c084c3cbb4
diff --git a/packages/core/package.json b/packages/core/package.jsonindex b9527176c4..1bc6448003 100644--- a/packages/core/package.json+++ b/packages/core/package.json@@ -564,6 +564,42 @@"types": "./dist/utils/index.d.ts","import": "./dist/utils/index.mjs","require": "./dist/utils/index.js"+ },+ "./Calendar/utils": {+ "source": "./src/Calendar/utils.ts",+ "types": "./dist/Calendar/utils.d.ts",+ "import": "./dist/Calendar/utils.mjs",+ "require": "./dist/Calendar/utils.js"+ },+ "./Markdown/utils": {+ "source": "./src/Markdown/utils.ts",+ "types": "./dist/Markdown/utils.d.ts",+ "import": "./dist/Markdown/utils.mjs",+ "require": "./dist/Markdown/utils.js"+ },+ "./PowerSearch/utils": {+ "source": "./src/PowerSearch/utils.ts",+ "types": "./dist/PowerSearch/utils.d.ts",+ "import": "./dist/PowerSearch/utils.mjs",+ "require": "./dist/PowerSearch/utils.js"+ },+ "./Selector/utils": {+ "source": "./src/Selector/utils.ts",+ "types": "./dist/Selector/utils.d.ts",+ "import": "./dist/Selector/utils.mjs",+ "require": "./dist/Selector/utils.js"+ },+ "./Table/utils": {+ "source": "./src/Table/utils.ts",+ "types": "./dist/Table/utils.d.ts",+ "import": "./dist/Table/utils.mjs",+ "require": "./dist/Table/utils.js"+ },+ "./Typeahead/utils": {+ "source": "./src/Typeahead/utils.ts",+ "types": "./dist/Typeahead/utils.d.ts",+ "import": "./dist/Typeahead/utils.mjs",+ "require": "./dist/Typeahead/utils.js"}},"files": [diff --git a/packages/core/src/Markdown/utils.ts b/packages/core/src/Markdown/utils.tsnew file mode 100644index 0000000000..f00ba02850--- /dev/null+++ b/packages/core/src/Markdown/utils.ts@@ -0,0 +1,22 @@+/**+ * @file utils.ts+ * @output Server-safe re-exports of pure Markdown parser functions+ * @position Subpath entry point: `@xds/core/Markdown/utils`+ */++export {+ parseMarkdown,+ parseInline,+ parseMarkdownIncremental,+ createIncrementalState,+ trimStreamingArtifacts,+} from './parser';++export type {+ InlineNode,+ BlockNode,+ ListItemNode,+ TableCellNode,+ TableAlignment,+ IncrementalState,+} from './parser';diff --git a/packages/core/src/PowerSearch/utils.ts b/packages/core/src/PowerSearch/utils.tsnew file mode 100644index 0000000000..5be00814e3--- /dev/null+++ b/packages/core/src/PowerSearch/utils.ts@@ -0,0 +1,10 @@+/**+ * @file utils.ts+ * @output Server-safe re-exports of pure PowerSearch utility functions+ * @position Subpath entry point: `@xds/core/PowerSearch/utils`+ */++export {formatFilterValue} from './formatFilterValue';++export type {InternalConfig} from './useInternalConfig';+export type {OperatorValue, FilterValue} from './types';diff --git a/packages/core/src/Table/utils.ts b/packages/core/src/Table/utils.tsnew file mode 100644index 0000000000..859c4d9830--- /dev/null+++ b/packages/core/src/Table/utils.ts@@ -0,0 +1,21 @@+/**+ * @file utils.ts+ * @output Server-safe re-exports of pure Table utility functions+ * @position Subpath entry point: `@xds/core/Table/utils`+ */++export {+ proportional,+ pixel,+ capitalize,+ generateColumns,+ resolveColumnWidths,+ DEFAULT_MIN_COLUMN_WIDTH,+} from './columnUtils';++export type {+ ColumnWidth,+ ProportionalWidth,+ PixelWidth,+ XDSTableColumn,+} from './types';diff --git a/packages/core/src/Typeahead/utils.ts b/packages/core/src/Typeahead/utils.tsnew file mode 100644index 0000000000..6ae73a2ff9--- /dev/null+++ b/packages/core/src/Typeahead/utils.ts@@ -0,0 +1,10 @@+/**+ * @file utils.ts+ * @output Server-safe re-exports of pure Typeahead utility functions+ * @position Subpath entry point: `@xds/core/Typeahead/utils`+ */++export {createStaticSource} from './createStaticSource';++export type {CreateStaticSourceOptions} from './createStaticSource';+export type {XDSSearchableItem, XDSSearchSource} from './types';diff --git a/packages/core/tsup.config.ts b/packages/core/tsup.config.tsindex 040b02d588..9ae65702b2 100644--- a/packages/core/tsup.config.ts+++ b/packages/core/tsup.config.ts@@ -15,7 +15,13 @@ import {defineConfig} from 'tsup';import babel from 'esbuild-plugin-babel';export default defineConfig({- entry: ['src/index.ts', 'src/*/index.ts', 'src/theme/tokens.stylex.ts', 'src/theme/syntax/index.ts'],+ entry: [+ 'src/index.ts',+ 'src/*/index.ts',+ 'src/*/utils.ts',+ 'src/theme/tokens.stylex.ts',+ 'src/theme/syntax/index.ts',+ ],format: ['cjs', 'esm'],dts: false,splitting: true,diff --git a/scripts/sync-exports.js b/scripts/sync-exports.jsindex 2c80cdb554..0a2279e1cf 100644--- a/scripts/sync-exports.js+++ b/scripts/sync-exports.js@@ -77,6 +77,25 @@ const STATIC_EXPORTS = {'./groups.doc.mjs': './groups.doc.mjs',};+/**+ * Server-safe utility subpath exports.+ *+ * These re-export pure functions from component directories without+ * the `'use client'` directive, making them importable from React+ * Server Components. Each entry points to a `utils.ts` file that+ * re-exports only the server-safe subset of a component's utilities.+ *+ * See: https://github.com/facebookexperimental/xds/issues/1977+ */+const UTIL_SUBPATH_DIRS = [+ 'Calendar',+ 'Markdown',+ 'PowerSearch',+ 'Selector',+ 'Table',+ 'Typeahead',+];+/*** Discover all exportable directories under src/.* A directory is exportable if it contains an index.ts file.@@ -139,6 +158,16 @@ function buildExports() {exports[key] = makeExportEntry(dir);}+ // Server-safe utility subpath exports+ for (const dir of UTIL_SUBPATH_DIRS) {+ exports[`./${dir}/utils`] = {+ source: `./src/${dir}/utils.ts`,+ types: `./dist/${dir}/utils.d.ts`,+ import: `./dist/${dir}/utils.mjs`,+ require: `./dist/${dir}/utils.js`,+ };+ }+return exports;}