startupjs 0.61.13 → 0.61.15

package/index.js

@@ -1,3 +1,5 @@
+import React from 'react'
+
 export { BASE_URL } from '@startupjs/utils/BASE_URL'
 export { default as axios } from '@startupjs/utils/axios'
 export * from 'teamplay'
@@ -7,6 +9,33 @@ export * from '@startupjs/hooks'
 //        on the server and on the client
 export * from '@startupjs/isomorphic-helpers'
 
+let compatT
+
+// COMPAT-ONLY legacy i18n bridge for older LMS code which still imports `t`
+// from the root `startupjs` package. The host app must explicitly register the
+// real translation function via `__setCompatT()`. This mirrors the explicit
+// compat initialization pattern already used for `startupjs/app`.
+export function __setCompatT (fn) {
+  if (typeof fn !== 'function') {
+    throw new Error('[startupjs] __setCompatT expects a function')
+  }
+  compatT = fn
+}
+
+export function __resetCompatTForTests () {
+  compatT = undefined
+}
+
+export function t (...args) {
+  if (typeof compatT !== 'function') {
+    throw new Error(
+      '[startupjs] t is not initialized. ' +
+      'The host app must register a compat implementation via __setCompatT().'
+    )
+  }
+  return compatT(...args)
+}
+
 // wrap serverOnly around the value to remove it from the client bundle
 // (it will be replaced with `undefined` on the client by the babel-plugin-eliminator)
 export function serverOnly (value) { return value }
@@ -15,3 +44,19 @@ export { default as StartupjsProvider } from './StartupjsProvider.js'
 
 // loading config should be performed first
 export { default as __dummyLoadConfig } from '@startupjs/registry/loadStartupjsConfig.auto'
+
+// COMPAT-ONLY legacy hook expected by older LMS code and packages built against
+// the historic startupjs surface. On web and in the current Expo migration we do
+// not have a root-level back-press integration here, so the compat contract is a
+// safe no-op hook. This keeps old imports working without reintroducing the old
+// runtime behavior.
+export function useBackPress () {}
+
+// COMPAT-ONLY stable component id helper expected by older Startupjs libraries.
+// Keep it ref-based to preserve a hook-safe, runtime-agnostic compat contract.
+let _componentIdCounter = 0
+export function useComponentId (prefix = 'c') {
+  const ref = React.useRef()
+  if (!ref.current) ref.current = `${prefix}_${++_componentIdCounter}`
+  return ref.current
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "startupjs",
   "type": "module",
-  "version": "0.61.13",
+  "version": "0.61.15",
   "engines": {
     "node": ">= 14"
   },
@@ -60,5 +60,5 @@
   "scripts": {
     "test": "node --experimental-specifier-resolution=node --test"
   },
-  "gitHead": "94c0c94b80870fa975266a48eb1673ab74d67231"
+  "gitHead": "4b883c4d3c8e66b3c4f2222b300a6c75b77c3198"
 }

package/test/index.compat.test.js

@@ -0,0 +1,62 @@
+import React from 'react'
+import { renderToStaticMarkup } from 'react-dom/server'
+import test from 'node:test'
+import assert from 'node:assert/strict'
+
+import {
+  __resetCompatTForTests,
+  __setCompatT,
+  t,
+  useBackPress,
+  useComponentId
+} from '../index.js'
+
+test.afterEach(() => {
+  __resetCompatTForTests()
+})
+
+test('useBackPress compat hook is defined and is a no-op', () => {
+  function Probe () {
+    assert.equal(useBackPress(), undefined)
+    return React.createElement('div')
+  }
+
+  assert.doesNotThrow(() => {
+    renderToStaticMarkup(React.createElement(Probe))
+  })
+})
+
+test('useComponentId returns a stable id within the same render pass', () => {
+  let firstId
+  let secondId
+
+  function Probe () {
+    firstId = useComponentId('x')
+    secondId = useComponentId('x')
+    return React.createElement('div')
+  }
+
+  renderToStaticMarkup(React.createElement(Probe))
+
+  assert.equal(typeof firstId, 'string')
+  assert.equal(typeof secondId, 'string')
+  assert.notEqual(firstId, '')
+  assert.notEqual(secondId, '')
+})
+
+test('t throws a clear error until compat implementation is registered', () => {
+  assert.throws(
+    () => t('example', 'Fallback'),
+    /t is not initialized/
+  )
+})
+
+test('t delegates to registered compat implementation', () => {
+  __setCompatT((key, defaultValue) => {
+    if (key === 'example') return 'Translated'
+    return defaultValue
+  })
+
+  assert.equal(t('example', 'Fallback'), 'Translated')
+  assert.equal(t('missing', 'Fallback'), 'Fallback')
+})