pte-interpolation-react 1.0.1 → 1.1.0

package/README.md

@@ -154,7 +154,7 @@ Returns a `PortableTextComponents` object with a `types.pteInterpolationVariable
 
 ### `VARIABLE_TYPE_PREFIX`
 
-The constant `'pteInterpolationVariable'` — the `_type` string used for variable inline blocks. Exported for advanced use cases.
+The constant `'pteInterpolationVariable'` - the `_type` string used for variable inline blocks. Exported for advanced use cases.
 
 ## License
 

package/dist/index.cjs

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: !0 });
-var jsxRuntime = require("react/jsx-runtime"), react$1 = require("@portabletext/react"), react = require("react");
-const VARIABLE_TYPE_PREFIX = "pteInterpolationVariable";
+var jsxRuntime = require("react/jsx-runtime"), react$1 = require("@portabletext/react"), react = require("react"), pteInterpolationCore = require("pte-interpolation-core");
 function defaultFallback(variableKey) {
   return `{${variableKey}}`;
 }
@@ -12,7 +11,7 @@ function createInterpolationComponents(values, fallback = defaultFallback) {
   }
   return {
     types: {
-      [VARIABLE_TYPE_PREFIX]: VariableComponent
+      [pteInterpolationCore.VARIABLE_TYPE_PREFIX]: VariableComponent
     }
   };
 }
@@ -34,7 +33,24 @@ function InterpolatedPortableText({
   }, [interpolationValues, fallback, userComponents]);
   return /* @__PURE__ */ jsxRuntime.jsx(react$1.PortableText, { ...rest, components: mergedComponents });
 }
+Object.defineProperty(exports, "VARIABLE_TYPE_PREFIX", {
+  enumerable: !0,
+  get: function() {
+    return pteInterpolationCore.VARIABLE_TYPE_PREFIX;
+  }
+});
+Object.defineProperty(exports, "extractVariableKeys", {
+  enumerable: !0,
+  get: function() {
+    return pteInterpolationCore.extractVariableKeys;
+  }
+});
+Object.defineProperty(exports, "interpolateToString", {
+  enumerable: !0,
+  get: function() {
+    return pteInterpolationCore.interpolateToString;
+  }
+});
 exports.InterpolatedPortableText = InterpolatedPortableText;
-exports.VARIABLE_TYPE_PREFIX = VARIABLE_TYPE_PREFIX;
 exports.createInterpolationComponents = createInterpolationComponents;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/constants.ts","../src/createInterpolationComponents.tsx","../src/InterpolatedPortableText.tsx"],"sourcesContent":["/** @public */\nexport const VARIABLE_TYPE_PREFIX = 'pteInterpolationVariable'\n","import type {PortableTextComponents, PortableTextTypeComponentProps} from '@portabletext/react'\n\nimport {VARIABLE_TYPE_PREFIX} from './constants'\nimport type {\n  InterpolationFallback,\n  InterpolationValues,\n  PteInterpolationVariableBlock,\n} from './types'\n\nfunction defaultFallback(variableKey: string): string {\n  return `{${variableKey}}`\n}\n\n/** @public */\nexport function createInterpolationComponents(\n  values: InterpolationValues,\n  fallback: InterpolationFallback = defaultFallback,\n): PortableTextComponents {\n  function VariableComponent(props: PortableTextTypeComponentProps<PteInterpolationVariableBlock>) {\n    const {variableKey} = props.value\n    const resolvedValue =\n      values[variableKey] !== undefined ? values[variableKey] : fallback(variableKey)\n\n    return <span data-variable-key={variableKey}>{resolvedValue}</span>\n  }\n\n  return {\n    types: {\n      [VARIABLE_TYPE_PREFIX]: VariableComponent,\n    },\n  }\n}\n","import {PortableText} from '@portabletext/react'\nimport {useMemo} from 'react'\n\nimport {createInterpolationComponents} from './createInterpolationComponents'\nimport type {InterpolatedPortableTextProps} from './types'\n\n/** @public */\nexport function InterpolatedPortableText({\n  interpolationValues,\n  components: userComponents,\n  fallback,\n  ...rest\n}: InterpolatedPortableTextProps) {\n  const mergedComponents = useMemo(() => {\n    const interpolationComponents = createInterpolationComponents(interpolationValues, fallback)\n\n    if (!userComponents) {\n      return interpolationComponents\n    }\n\n    return {\n      ...userComponents,\n      types: {\n        ...userComponents.types,\n        ...interpolationComponents.types,\n      },\n    }\n  }, [interpolationValues, fallback, userComponents])\n\n  return <PortableText {...rest} components={mergedComponents} />\n}\n"],"names":["jsx","useMemo","PortableText"],"mappings":";;;AACO,MAAM,uBAAuB;ACQpC,SAAS,gBAAgB,aAA6B;AACpD,SAAO,IAAI,WAAW;AACxB;AAGO,SAAS,8BACd,QACA,WAAkC,iBACV;AACxB,WAAS,kBAAkB,OAAsE;AAC/F,UAAM,EAAC,YAAA,IAAe,MAAM,OACtB,gBACJ,OAAO,WAAW,MAAM,SAAY,OAAO,WAAW,IAAI,SAAS,WAAW;AAEhF,WAAOA,2BAAAA,IAAC,QAAA,EAAK,qBAAmB,aAAc,UAAA,eAAc;AAAA,EAC9D;AAEA,SAAO;AAAA,IACL,OAAO;AAAA,MACL,CAAC,oBAAoB,GAAG;AAAA,IAAA;AAAA,EAC1B;AAEJ;ACxBO,SAAS,yBAAyB;AAAA,EACvC;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EACA,GAAG;AACL,GAAkC;AAChC,QAAM,mBAAmBC,MAAAA,QAAQ,MAAM;AACrC,UAAM,0BAA0B,8BAA8B,qBAAqB,QAAQ;AAE3F,WAAK,iBAIE;AAAA,MACL,GAAG;AAAA,MACH,OAAO;AAAA,QACL,GAAG,eAAe;AAAA,QAClB,GAAG,wBAAwB;AAAA,MAAA;AAAA,IAC7B,IARO;AAAA,EAUX,GAAG,CAAC,qBAAqB,UAAU,cAAc,CAAC;AAElD,SAAOD,2BAAAA,IAACE,QAAAA,cAAA,EAAc,GAAG,MAAM,YAAY,kBAAkB;AAC/D;;;;"}
+{"version":3,"file":"index.cjs","sources":["../src/createInterpolationComponents.tsx","../src/InterpolatedPortableText.tsx"],"sourcesContent":["import type {PortableTextComponents, PortableTextTypeComponentProps} from '@portabletext/react'\n\nimport {VARIABLE_TYPE_PREFIX} from './constants'\nimport type {\n  InterpolationFallback,\n  InterpolationValues,\n  PteInterpolationVariableBlock,\n} from './types'\n\nfunction defaultFallback(variableKey: string): string {\n  return `{${variableKey}}`\n}\n\n/** @public */\nexport function createInterpolationComponents(\n  values: InterpolationValues,\n  fallback: InterpolationFallback = defaultFallback,\n): PortableTextComponents {\n  function VariableComponent(props: PortableTextTypeComponentProps<PteInterpolationVariableBlock>) {\n    const {variableKey} = props.value\n    const resolvedValue =\n      values[variableKey] !== undefined ? values[variableKey] : fallback(variableKey)\n\n    return <span data-variable-key={variableKey}>{resolvedValue}</span>\n  }\n\n  return {\n    types: {\n      [VARIABLE_TYPE_PREFIX]: VariableComponent,\n    },\n  }\n}\n","import {PortableText} from '@portabletext/react'\nimport {useMemo} from 'react'\n\nimport {createInterpolationComponents} from './createInterpolationComponents'\nimport type {InterpolatedPortableTextProps} from './types'\n\n/** @public */\nexport function InterpolatedPortableText({\n  interpolationValues,\n  components: userComponents,\n  fallback,\n  ...rest\n}: InterpolatedPortableTextProps) {\n  const mergedComponents = useMemo(() => {\n    const interpolationComponents = createInterpolationComponents(interpolationValues, fallback)\n\n    if (!userComponents) {\n      return interpolationComponents\n    }\n\n    return {\n      ...userComponents,\n      types: {\n        ...userComponents.types,\n        ...interpolationComponents.types,\n      },\n    }\n  }, [interpolationValues, fallback, userComponents])\n\n  return <PortableText {...rest} components={mergedComponents} />\n}\n"],"names":["jsx","VARIABLE_TYPE_PREFIX","useMemo","PortableText"],"mappings":";;;AASA,SAAS,gBAAgB,aAA6B;AACpD,SAAO,IAAI,WAAW;AACxB;AAGO,SAAS,8BACd,QACA,WAAkC,iBACV;AACxB,WAAS,kBAAkB,OAAsE;AAC/F,UAAM,EAAC,YAAA,IAAe,MAAM,OACtB,gBACJ,OAAO,WAAW,MAAM,SAAY,OAAO,WAAW,IAAI,SAAS,WAAW;AAEhF,WAAOA,2BAAAA,IAAC,QAAA,EAAK,qBAAmB,aAAc,UAAA,eAAc;AAAA,EAC9D;AAEA,SAAO;AAAA,IACL,OAAO;AAAA,MACL,CAACC,yCAAoB,GAAG;AAAA,IAAA;AAAA,EAC1B;AAEJ;ACxBO,SAAS,yBAAyB;AAAA,EACvC;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EACA,GAAG;AACL,GAAkC;AAChC,QAAM,mBAAmBC,MAAAA,QAAQ,MAAM;AACrC,UAAM,0BAA0B,8BAA8B,qBAAqB,QAAQ;AAE3F,WAAK,iBAIE;AAAA,MACL,GAAG;AAAA,MACH,OAAO;AAAA,QACL,GAAG,eAAe;AAAA,QAClB,GAAG,wBAAwB;AAAA,MAAA;AAAA,IAC7B,IARO;AAAA,EAUX,GAAG,CAAC,qBAAqB,UAAU,cAAc,CAAC;AAElD,SAAOF,2BAAAA,IAACG,QAAAA,cAAA,EAAc,GAAG,MAAM,YAAY,kBAAkB;AAC/D;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.d.cts

@@ -1,6 +1,13 @@
+import {extractVariableKeys} from 'pte-interpolation-core'
+import {interpolateToString} from 'pte-interpolation-core'
+import {InterpolationFallback} from 'pte-interpolation-core'
+import {InterpolationValues} from 'pte-interpolation-core'
 import {JSX} from 'react/jsx-runtime'
+import {PortableTextBlockLike} from 'pte-interpolation-core'
+import {PortableTextChild} from 'pte-interpolation-core'
 import type {PortableTextComponents} from '@portabletext/react'
 import type {PortableTextProps} from '@portabletext/react'
+import {VARIABLE_TYPE_PREFIX} from 'pte-interpolation-core'
 
 /** @public */
 export declare function createInterpolationComponents(
@@ -8,6 +15,8 @@ export declare function createInterpolationComponents(
   fallback?: InterpolationFallback,
 ): PortableTextComponents
 
+export {extractVariableKeys}
+
 /** @public */
 export declare function InterpolatedPortableText({
   interpolationValues,
@@ -26,11 +35,15 @@ export declare interface InterpolatedPortableTextProps extends Omit<
   fallback?: InterpolationFallback
 }
 
-/** @public */
-export declare type InterpolationFallback = (variableKey: string) => string
+export {interpolateToString}
 
-/** @public */
-export declare type InterpolationValues = Record<string, string>
+export {InterpolationFallback}
+
+export {InterpolationValues}
+
+export {PortableTextBlockLike}
+
+export {PortableTextChild}
 
 /** @public */
 export declare interface PteInterpolationVariableBlock {
@@ -39,7 +52,6 @@ export declare interface PteInterpolationVariableBlock {
   variableKey: string
 }
 
-/** @public */
-export declare const VARIABLE_TYPE_PREFIX = 'pteInterpolationVariable'
+export {VARIABLE_TYPE_PREFIX}
 
 export {}

package/dist/index.d.ts

@@ -1,6 +1,13 @@
+import {extractVariableKeys} from 'pte-interpolation-core'
+import {interpolateToString} from 'pte-interpolation-core'
+import {InterpolationFallback} from 'pte-interpolation-core'
+import {InterpolationValues} from 'pte-interpolation-core'
 import {JSX} from 'react/jsx-runtime'
+import {PortableTextBlockLike} from 'pte-interpolation-core'
+import {PortableTextChild} from 'pte-interpolation-core'
 import type {PortableTextComponents} from '@portabletext/react'
 import type {PortableTextProps} from '@portabletext/react'
+import {VARIABLE_TYPE_PREFIX} from 'pte-interpolation-core'
 
 /** @public */
 export declare function createInterpolationComponents(
@@ -8,6 +15,8 @@ export declare function createInterpolationComponents(
   fallback?: InterpolationFallback,
 ): PortableTextComponents
 
+export {extractVariableKeys}
+
 /** @public */
 export declare function InterpolatedPortableText({
   interpolationValues,
@@ -26,11 +35,15 @@ export declare interface InterpolatedPortableTextProps extends Omit<
   fallback?: InterpolationFallback
 }
 
-/** @public */
-export declare type InterpolationFallback = (variableKey: string) => string
+export {interpolateToString}
 
-/** @public */
-export declare type InterpolationValues = Record<string, string>
+export {InterpolationFallback}
+
+export {InterpolationValues}
+
+export {PortableTextBlockLike}
+
+export {PortableTextChild}
 
 /** @public */
 export declare interface PteInterpolationVariableBlock {
@@ -39,7 +52,6 @@ export declare interface PteInterpolationVariableBlock {
   variableKey: string
 }
 
-/** @public */
-export declare const VARIABLE_TYPE_PREFIX = 'pteInterpolationVariable'
+export {VARIABLE_TYPE_PREFIX}
 
 export {}

package/dist/index.js

@@ -1,7 +1,8 @@
 import { jsx } from "react/jsx-runtime";
 import { PortableText } from "@portabletext/react";
 import { useMemo } from "react";
-const VARIABLE_TYPE_PREFIX = "pteInterpolationVariable";
+import { VARIABLE_TYPE_PREFIX } from "pte-interpolation-core";
+import { VARIABLE_TYPE_PREFIX as VARIABLE_TYPE_PREFIX2, extractVariableKeys, interpolateToString } from "pte-interpolation-core";
 function defaultFallback(variableKey) {
   return `{${variableKey}}`;
 }
@@ -36,7 +37,9 @@ function InterpolatedPortableText({
 }
 export {
   InterpolatedPortableText,
-  VARIABLE_TYPE_PREFIX,
-  createInterpolationComponents
+  VARIABLE_TYPE_PREFIX2 as VARIABLE_TYPE_PREFIX,
+  createInterpolationComponents,
+  extractVariableKeys,
+  interpolateToString
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/constants.ts","../src/createInterpolationComponents.tsx","../src/InterpolatedPortableText.tsx"],"sourcesContent":["/** @public */\nexport const VARIABLE_TYPE_PREFIX = 'pteInterpolationVariable'\n","import type {PortableTextComponents, PortableTextTypeComponentProps} from '@portabletext/react'\n\nimport {VARIABLE_TYPE_PREFIX} from './constants'\nimport type {\n  InterpolationFallback,\n  InterpolationValues,\n  PteInterpolationVariableBlock,\n} from './types'\n\nfunction defaultFallback(variableKey: string): string {\n  return `{${variableKey}}`\n}\n\n/** @public */\nexport function createInterpolationComponents(\n  values: InterpolationValues,\n  fallback: InterpolationFallback = defaultFallback,\n): PortableTextComponents {\n  function VariableComponent(props: PortableTextTypeComponentProps<PteInterpolationVariableBlock>) {\n    const {variableKey} = props.value\n    const resolvedValue =\n      values[variableKey] !== undefined ? values[variableKey] : fallback(variableKey)\n\n    return <span data-variable-key={variableKey}>{resolvedValue}</span>\n  }\n\n  return {\n    types: {\n      [VARIABLE_TYPE_PREFIX]: VariableComponent,\n    },\n  }\n}\n","import {PortableText} from '@portabletext/react'\nimport {useMemo} from 'react'\n\nimport {createInterpolationComponents} from './createInterpolationComponents'\nimport type {InterpolatedPortableTextProps} from './types'\n\n/** @public */\nexport function InterpolatedPortableText({\n  interpolationValues,\n  components: userComponents,\n  fallback,\n  ...rest\n}: InterpolatedPortableTextProps) {\n  const mergedComponents = useMemo(() => {\n    const interpolationComponents = createInterpolationComponents(interpolationValues, fallback)\n\n    if (!userComponents) {\n      return interpolationComponents\n    }\n\n    return {\n      ...userComponents,\n      types: {\n        ...userComponents.types,\n        ...interpolationComponents.types,\n      },\n    }\n  }, [interpolationValues, fallback, userComponents])\n\n  return <PortableText {...rest} components={mergedComponents} />\n}\n"],"names":[],"mappings":";;;AACO,MAAM,uBAAuB;ACQpC,SAAS,gBAAgB,aAA6B;AACpD,SAAO,IAAI,WAAW;AACxB;AAGO,SAAS,8BACd,QACA,WAAkC,iBACV;AACxB,WAAS,kBAAkB,OAAsE;AAC/F,UAAM,EAAC,YAAA,IAAe,MAAM,OACtB,gBACJ,OAAO,WAAW,MAAM,SAAY,OAAO,WAAW,IAAI,SAAS,WAAW;AAEhF,WAAO,oBAAC,QAAA,EAAK,qBAAmB,aAAc,UAAA,eAAc;AAAA,EAC9D;AAEA,SAAO;AAAA,IACL,OAAO;AAAA,MACL,CAAC,oBAAoB,GAAG;AAAA,IAAA;AAAA,EAC1B;AAEJ;ACxBO,SAAS,yBAAyB;AAAA,EACvC;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EACA,GAAG;AACL,GAAkC;AAChC,QAAM,mBAAmB,QAAQ,MAAM;AACrC,UAAM,0BAA0B,8BAA8B,qBAAqB,QAAQ;AAE3F,WAAK,iBAIE;AAAA,MACL,GAAG;AAAA,MACH,OAAO;AAAA,QACL,GAAG,eAAe;AAAA,QAClB,GAAG,wBAAwB;AAAA,MAAA;AAAA,IAC7B,IARO;AAAA,EAUX,GAAG,CAAC,qBAAqB,UAAU,cAAc,CAAC;AAElD,SAAO,oBAAC,cAAA,EAAc,GAAG,MAAM,YAAY,kBAAkB;AAC/D;"}
+{"version":3,"file":"index.js","sources":["../src/createInterpolationComponents.tsx","../src/InterpolatedPortableText.tsx"],"sourcesContent":["import type {PortableTextComponents, PortableTextTypeComponentProps} from '@portabletext/react'\n\nimport {VARIABLE_TYPE_PREFIX} from './constants'\nimport type {\n  InterpolationFallback,\n  InterpolationValues,\n  PteInterpolationVariableBlock,\n} from './types'\n\nfunction defaultFallback(variableKey: string): string {\n  return `{${variableKey}}`\n}\n\n/** @public */\nexport function createInterpolationComponents(\n  values: InterpolationValues,\n  fallback: InterpolationFallback = defaultFallback,\n): PortableTextComponents {\n  function VariableComponent(props: PortableTextTypeComponentProps<PteInterpolationVariableBlock>) {\n    const {variableKey} = props.value\n    const resolvedValue =\n      values[variableKey] !== undefined ? values[variableKey] : fallback(variableKey)\n\n    return <span data-variable-key={variableKey}>{resolvedValue}</span>\n  }\n\n  return {\n    types: {\n      [VARIABLE_TYPE_PREFIX]: VariableComponent,\n    },\n  }\n}\n","import {PortableText} from '@portabletext/react'\nimport {useMemo} from 'react'\n\nimport {createInterpolationComponents} from './createInterpolationComponents'\nimport type {InterpolatedPortableTextProps} from './types'\n\n/** @public */\nexport function InterpolatedPortableText({\n  interpolationValues,\n  components: userComponents,\n  fallback,\n  ...rest\n}: InterpolatedPortableTextProps) {\n  const mergedComponents = useMemo(() => {\n    const interpolationComponents = createInterpolationComponents(interpolationValues, fallback)\n\n    if (!userComponents) {\n      return interpolationComponents\n    }\n\n    return {\n      ...userComponents,\n      types: {\n        ...userComponents.types,\n        ...interpolationComponents.types,\n      },\n    }\n  }, [interpolationValues, fallback, userComponents])\n\n  return <PortableText {...rest} components={mergedComponents} />\n}\n"],"names":[],"mappings":";;;;;AASA,SAAS,gBAAgB,aAA6B;AACpD,SAAO,IAAI,WAAW;AACxB;AAGO,SAAS,8BACd,QACA,WAAkC,iBACV;AACxB,WAAS,kBAAkB,OAAsE;AAC/F,UAAM,EAAC,YAAA,IAAe,MAAM,OACtB,gBACJ,OAAO,WAAW,MAAM,SAAY,OAAO,WAAW,IAAI,SAAS,WAAW;AAEhF,WAAO,oBAAC,QAAA,EAAK,qBAAmB,aAAc,UAAA,eAAc;AAAA,EAC9D;AAEA,SAAO;AAAA,IACL,OAAO;AAAA,MACL,CAAC,oBAAoB,GAAG;AAAA,IAAA;AAAA,EAC1B;AAEJ;ACxBO,SAAS,yBAAyB;AAAA,EACvC;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EACA,GAAG;AACL,GAAkC;AAChC,QAAM,mBAAmB,QAAQ,MAAM;AACrC,UAAM,0BAA0B,8BAA8B,qBAAqB,QAAQ;AAE3F,WAAK,iBAIE;AAAA,MACL,GAAG;AAAA,MACH,OAAO;AAAA,QACL,GAAG,eAAe;AAAA,QAClB,GAAG,wBAAwB;AAAA,MAAA;AAAA,IAC7B,IARO;AAAA,EAUX,GAAG,CAAC,qBAAqB,UAAU,cAAc,CAAC;AAElD,SAAO,oBAAC,cAAA,EAAc,GAAG,MAAM,YAAY,kBAAkB;AAC/D;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pte-interpolation-react",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "type": "module",
   "license": "MIT",
   "description": "React components for rendering Portable Text with interpolated values",
@@ -40,7 +40,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@portabletext/react": "^6.0.2"
+    "@portabletext/react": "^6.0.2",
+    "pte-interpolation-core": "1.1.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"

package/src/__tests__/reexports.test.ts

@@ -0,0 +1,87 @@
+import {describe, expect, it} from 'vitest'
+import {
+  extractVariableKeys,
+  interpolateToString,
+  VARIABLE_TYPE_PREFIX,
+} from 'pte-interpolation-react'
+import type {
+  InterpolationFallback,
+  InterpolationValues,
+  PortableTextBlockLike,
+  PortableTextChild,
+  PteInterpolationVariableBlock,
+} from 'pte-interpolation-react'
+import {singleVariableBlock, multipleVariablesBlock, plainTextBlock} from './fixtures'
+
+describe('re-exports from pte-interpolation-core', () => {
+  describe('VARIABLE_TYPE_PREFIX', () => {
+    it('equals pteInterpolationVariable', () => {
+      expect(VARIABLE_TYPE_PREFIX).toBe('pteInterpolationVariable')
+    })
+  })
+
+  describe('extractVariableKeys', () => {
+    it('extracts variable keys from blocks', () => {
+      const keys = extractVariableKeys(singleVariableBlock)
+      expect(keys).toEqual(['firstName'])
+    })
+
+    it('extracts multiple variable keys', () => {
+      const keys = extractVariableKeys(multipleVariablesBlock)
+      expect(keys).toEqual(['firstName', 'lastName', 'email'])
+    })
+
+    it('returns empty array for plain text', () => {
+      const keys = extractVariableKeys(plainTextBlock)
+      expect(keys).toEqual([])
+    })
+  })
+
+  describe('interpolateToString', () => {
+    it('interpolates variable values into text', () => {
+      const result = interpolateToString(singleVariableBlock, {firstName: 'Alice'})
+      expect(result).toBe('Hello, Alice!')
+    })
+
+    it('uses default fallback for missing values', () => {
+      const result = interpolateToString(singleVariableBlock, {})
+      expect(result).toBe('Hello, {firstName}!')
+    })
+
+    it('uses custom fallback for missing values', () => {
+      const customFallback: InterpolationFallback = (variableKey) => `[${variableKey}]`
+      const result = interpolateToString(singleVariableBlock, {}, customFallback)
+      expect(result).toBe('Hello, [firstName]!')
+    })
+  })
+
+  describe('type exports', () => {
+    it('InterpolationValues type works as a record of strings', () => {
+      const values: InterpolationValues = {firstName: 'Alice', lastName: 'Smith'}
+      expect(values).toEqual({firstName: 'Alice', lastName: 'Smith'})
+    })
+
+    it('PortableTextBlockLike type is compatible with fixture blocks', () => {
+      const blocks: PortableTextBlockLike[] = singleVariableBlock
+      expect(blocks).toHaveLength(1)
+    })
+
+    it('PortableTextChild type is compatible with block children', () => {
+      const child: PortableTextChild = {
+        _type: 'span',
+        _key: 'span-1',
+        text: 'Hello',
+      }
+      expect(child._type).toBe('span')
+    })
+
+    it('PteInterpolationVariableBlock type is compatible with variable blocks', () => {
+      const variableBlock: PteInterpolationVariableBlock = {
+        _type: 'pteInterpolationVariable',
+        _key: 'var-1',
+        variableKey: 'firstName',
+      }
+      expect(variableBlock.variableKey).toBe('firstName')
+    })
+  })
+})

package/src/constants.ts

@@ -1,2 +1 @@
-/** @public */
-export const VARIABLE_TYPE_PREFIX = 'pteInterpolationVariable'
+export {VARIABLE_TYPE_PREFIX} from 'pte-interpolation-core'

package/src/index.ts

@@ -1,9 +1,11 @@
 export {InterpolatedPortableText} from './InterpolatedPortableText'
 export {createInterpolationComponents} from './createInterpolationComponents'
 export {VARIABLE_TYPE_PREFIX} from './constants'
+export {extractVariableKeys, interpolateToString} from 'pte-interpolation-core'
 export type {
   InterpolatedPortableTextProps,
   InterpolationFallback,
   InterpolationValues,
   PteInterpolationVariableBlock,
 } from './types'
+export type {PortableTextBlockLike, PortableTextChild} from 'pte-interpolation-core'

package/src/types.ts

@@ -1,10 +1,7 @@
 import type {PortableTextComponents, PortableTextProps} from '@portabletext/react'
+import type {InterpolationFallback, InterpolationValues} from 'pte-interpolation-core'
 
-/** @public */
-export type InterpolationValues = Record<string, string>
-
-/** @public */
-export type InterpolationFallback = (variableKey: string) => string
+export type {InterpolationFallback, InterpolationValues} from 'pte-interpolation-core'
 
 /** @public */
 export interface PteInterpolationVariableBlock {