fix(types): drain @superdoc/common/list-marker-utils shim (SD-2893)

packages/superdoc/scripts/audit-declarations.cjs

@@ -69,8 +69,10 @@ const RELOCATION_GUARD_PACKAGES = [
   '@superdoc/contracts',
   '@superdoc/dom-contract',
   '@superdoc/layout-bridge',
+  '@superdoc/layout-engine',
   '@superdoc/painter-dom',
   '@superdoc/pm-adapter',
+  '@superdoc/common/list-marker-utils',
 ];
 
 // Specifiers that may appear as bare imports in published d.ts files even

packages/superdoc/scripts/ensure-types.cjs

@@ -62,6 +62,41 @@ if (handwrittenCopiedSuperEditor > 0) {
   console.log(`[ensure-types] ✓ Copied ${handwrittenCopiedSuperEditor} hand-written .d.ts files from super-editor/src`);
 }
 
+// SD-2893: emit declarations for the shared/common subpaths reachable from the
+// public surface. Adding shared/ to vite-plugin-dts's `include` would shift the
+// common-ancestor of all source files to the repo root and reorganise the
+// entire dist tree, so we run tsc directly for just the files we relocate.
+// Today: list-marker-utils plus its sibling layout-constants. Add new entries
+// here in lockstep with `RELOCATION_RULES` below.
+const SHARED_COMMON_DTS_TARGETS = ['list-marker-utils.ts', 'layout-constants.ts'];
+{
+  const { spawnSync: _spawnSync } = require('node:child_process');
+  const tscBin = path.join(repoRoot, 'node_modules', '.bin', 'tsc');
+  const sharedCommonDistDir = path.join(distRoot, 'shared/common');
+  fs.mkdirSync(sharedCommonDistDir, { recursive: true });
+  const sources = SHARED_COMMON_DTS_TARGETS.map((f) => path.join(repoRoot, 'shared/common', f));
+  const tscResult = _spawnSync(
+    tscBin,
+    [
+      '--declaration',
+      '--emitDeclarationOnly',
+      '--skipLibCheck',
+      '--target', 'ES2022',
+      '--module', 'ESNext',
+      '--moduleResolution', 'bundler',
+      '--outDir', sharedCommonDistDir,
+      '--rootDir', path.join(repoRoot, 'shared/common'),
+      ...sources,
+    ],
+    { stdio: 'inherit' },
+  );
+  if (tscResult.status !== 0) {
+    console.error('[ensure-types] tsc failed emitting shared/common declarations');
+    process.exit(1);
+  }
+  console.log(`[ensure-types] ✓ Emitted ${SHARED_COMMON_DTS_TARGETS.length} shared/common declarations`);
+}
+
 const requiredEntryPoints = [
   'superdoc/src/index.d.ts',
   'superdoc/src/super-editor.d.ts',
@@ -219,6 +254,7 @@ const RELOCATION_RULES = [
   { pkg: '@superdoc/contracts',     distEntry: 'layout-engine/contracts/src/index.d.ts', matchSubpaths: true },
   { pkg: '@superdoc/dom-contract',  distEntry: 'layout-engine/dom-contract/src/index.d.ts', matchSubpaths: true },
   { pkg: '@superdoc/layout-bridge', distEntry: 'layout-engine/layout-bridge/src/index.d.ts', matchSubpaths: true },
+  { pkg: '@superdoc/layout-engine', distEntry: 'layout-engine/layout-engine/src/index.d.ts', matchSubpaths: true },
   { pkg: '@superdoc/painter-dom',   distEntry: 'layout-engine/painters/dom/src/index.d.ts', matchSubpaths: true },
   {
     pkg: '@superdoc/pm-adapter/converter-context.js',
@@ -230,6 +266,15 @@ const RELOCATION_RULES = [
     distEntry: 'layout-engine/pm-adapter/src/sections/types.d.ts',
     matchSubpaths: false,
   },
+  // SD-2893: list-marker-utils is the only @superdoc/common subpath publicly
+  // reachable today (via painter-dom). Relocate just this file so the bare
+  // @superdoc/common shim does not capture it; the parent @superdoc/common
+  // package and other subpaths stay shimmed until separately drained.
+  {
+    pkg: '@superdoc/common/list-marker-utils',
+    distEntry: 'shared/common/list-marker-utils.d.ts',
+    matchSubpaths: false,
+  },
 ];
 
 // Guard packages that must never fall back to `_internal-shims.d.ts`.
@@ -241,8 +286,10 @@ const RELOCATION_GUARD_PACKAGES = [
   '@superdoc/contracts',
   '@superdoc/dom-contract',
   '@superdoc/layout-bridge',
+  '@superdoc/layout-engine',
   '@superdoc/painter-dom',
   '@superdoc/pm-adapter',
+  '@superdoc/common/list-marker-utils',
 ];
 
 function isRelocatedSpecifier(mod) {

packages/superdoc/src/composables/useUiFontFamily.js

@@ -21,23 +21,6 @@ export const DEFAULT_UI_FONT_FAMILY = 'Arial, Helvetica, sans-serif';
  *
  * @returns {{ uiFontFamily: import('vue').ComputedRef<string> }} An object containing:
  *   - uiFontFamily: A computed reference to the UI font-family string
- *
- * @example
- * // In a Vue component
- * import { useUiFontFamily } from '@superdoc/composables/useUiFontFamily.js';
- *
- * export default {
- *   setup() {
- *     const { uiFontFamily } = useUiFontFamily();
- *
- *     // Use in template or computed styles
- *     return { uiFontFamily };
- *   }
- * }
- *
- * @example
- * // In a template
- * <CommentsDropdown :content-style="{ fontFamily: uiFontFamily }" />
  */
 export function useUiFontFamily() {
   const instance = getCurrentInstance();

packages/superdoc/tsconfig.json

@@ -29,6 +29,7 @@
     "../layout-engine/contracts/src",
     "../layout-engine/dom-contract/src",
     "../layout-engine/layout-bridge/src",
+    "../layout-engine/layout-engine/src",
     "../layout-engine/painters/dom/src",
     "../layout-engine/pm-adapter/src/converter-context.ts",
     "../layout-engine/pm-adapter/src/sections/types.ts"

packages/superdoc/vite.config.js

@@ -132,6 +132,7 @@ export default defineConfig(({ mode, command }) => {
         '../layout-engine/contracts/src/**/*',
         '../layout-engine/dom-contract/src/**/*',
         '../layout-engine/layout-bridge/src/**/*',
+        '../layout-engine/layout-engine/src/**/*',
         '../layout-engine/painters/dom/src/**/*',
         // SD-2893: pm-adapter is included file-by-file (not via `src/**/*`)
         // because the full barrel pulls in @superdoc/style-engine and other