Skip to content

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.json
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
index 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.js
index 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;
}