feat(core): export internals needed for repl

Author: wmertens

packages/docs/src/repl/repl-output-panel.tsx

@@ -6,8 +6,7 @@ import { ReplTabButton } from './repl-tab-button';
 import { ReplTabButtons } from './repl-tab-buttons';
 import type { ReplAppInput, ReplStore } from './types';
 import { _deserialize, _getDomContainer } from '@qwik.dev/core/internal';
-import { dumpState, preprocessState } from '../../../qwik/src/core/shared/shared-serialization';
-import { vnode_toString } from '../../../qwik/src/core/client/vnode';
+import { _dumpState, _preprocessState, _vnode_toString } from '@qwik.dev/core/internal';
 
 export const ReplOutputPanel = component$(({ input, store }: ReplOutputPanelProps) => {
   const diagnosticsLen = useComputed$(
@@ -33,9 +32,9 @@ export const ReplOutputPanel = component$(({ input, store }: ReplOutputPanelProp
       if (qwikStates.length !== 0) {
         const data = qwikStates[qwikStates.length - 1];
         const origState = JSON.parse(data?.textContent || '[]');
-        preprocessState(origState, container as any);
+        _preprocessState(origState, container as any);
         return origState
-          ? dumpState(origState, false, '', null)
+          ? _dumpState(origState, false, '', null)
               //remove first new line
               .replace(/\n/, '')
           : 'No state found';
@@ -50,7 +49,7 @@ export const ReplOutputPanel = component$(({ input, store }: ReplOutputPanelProp
   const vdomTree = useComputed$(() => {
     try {
       const container = domContainerFromResultHtml.value;
-      return vnode_toString.call(
+      return _vnode_toString.call(
         container!.rootVNode as any,
         Number.MAX_SAFE_INTEGER,
         '',

packages/qwik/src/core/client/vnode.ts

@@ -1718,6 +1718,7 @@ export const vnode_getNode = (vnode: VNode | null): Element | Text | null => {
   return vnode[TextVNodeProps.node]!;
 };
 
+/** @internal */
 export function vnode_toString(
   this: VNode | null,
   depth: number = 20,

packages/qwik/src/core/internal.ts

@@ -1,41 +1,56 @@
 export { _noopQrl, _noopQrlDEV, _regSymbol } from './shared/qrl/qrl';
-export { _walkJSX } from './ssr/ssr-render-jsx';
-export { _SharedContainer } from './shared/shared-container';
-export { queueQRL as _run } from './client/queue-qrl';
-export { scheduleTask as _task } from './use/use-task';
-export { _wrapSignal, _wrapProp, _wrapStore } from './reactive-primitives/internal-api';
-export { _restProps } from './shared/utils/prop';
-export { _IMMUTABLE } from './shared/utils/constants';
-export { _CONST_PROPS, _VAR_PROPS } from './shared/utils/constants';
-export { _weakSerialize } from './shared/utils/serialize-utils';
-export { verifySerializable as _verifySerializable } from './shared/utils/serialize-utils';
+// ^ keep this above to avoid circular dependency issues
+
 export {
-  _getContextElement,
-  _getContextEvent,
-  _jsxBranch,
-  _waitUntilRendered,
-} from './use/use-core';
-export { _jsxSorted, _jsxSplit, isJSXNode as _isJSXNode } from './shared/jsx/jsx-runtime';
-export { _fnSignal } from './shared/qrl/inlined-fn';
+  DomContainer as _DomContainer,
+  getDomContainer as _getDomContainer,
+} from './client/dom-container';
+export { queueQRL as _run } from './client/queue-qrl';
 export type {
   ContainerElement as _ContainerElement,
+  ElementVNode as _ElementVNode,
+  QDocument as _QDocument,
+  TextVNode as _TextVNode,
+  VirtualVNode as _VirtualVNode,
   VNode as _VNode,
   VNodeFlags as _VNodeFlags,
-  VirtualVNode as _VirtualVNode,
-  TextVNode as _TextVNode,
-  QDocument as _QDocument,
-  ElementVNode as _ElementVNode,
 } from './client/types';
+export { vnode_toString as _vnode_toString } from './client/vnode';
+export { _wrapProp, _wrapSignal, _wrapStore } from './reactive-primitives/internal-api';
+export { SubscriptionData as _SubscriptionData } from './reactive-primitives/subscription-data';
+export { _EFFECT_BACK_REF } from './reactive-primitives/types';
 export {
   isStringifiable as _isStringifiable,
   type Stringifiable as _Stringifiable,
 } from './shared-types';
 export {
-  DomContainer as _DomContainer,
-  getDomContainer as _getDomContainer,
-} from './client/dom-container';
+  isJSXNode as _isJSXNode,
+  _jsxC,
+  _jsxQ,
+  _jsxS,
+  _jsxSorted,
+  _jsxSplit,
+} from './shared/jsx/jsx-runtime';
+export { _fnSignal } from './shared/qrl/inlined-fn';
+export { _SharedContainer } from './shared/shared-container';
+export {
+  _deserialize,
+  dumpState as _dumpState,
+  preprocessState as _preprocessState,
+  _serialize,
+} from './shared/shared-serialization';
+export { _CONST_PROPS, _IMMUTABLE, _VAR_PROPS } from './shared/utils/constants';
 export { EMPTY_ARRAY as _EMPTY_ARRAY } from './shared/utils/flyweight';
-export { _serialize, _deserialize } from './shared/shared-serialization';
-export { _jsxQ, _jsxC, _jsxS } from './shared/jsx/jsx-runtime';
-export { _EFFECT_BACK_REF } from './reactive-primitives/types';
-export { SubscriptionData as _SubscriptionData } from './reactive-primitives/subscription-data';
+export { _restProps } from './shared/utils/prop';
+export {
+  verifySerializable as _verifySerializable,
+  _weakSerialize,
+} from './shared/utils/serialize-utils';
+export { _walkJSX } from './ssr/ssr-render-jsx';
+export {
+  _getContextElement,
+  _getContextEvent,
+  _jsxBranch,
+  _waitUntilRendered,
+} from './use/use-core';
+export { scheduleTask as _task } from './use/use-task';

packages/qwik/src/core/qwik.core.api.md

@@ -246,6 +246,9 @@ class DomContainer extends _SharedContainer implements ClientContainer {
 export { DomContainer }
 export { DomContainer as _DomContainer }
 
+// @internal (undocumented)
+export const _dumpState: (state: unknown[], color?: boolean, prefix?: string, limit?: number | null) => string;
+
 // @internal (undocumented)
 export const _EFFECT_BACK_REF: unique symbol;
 
@@ -551,6 +554,11 @@ export const PrefetchServiceWorker: (opts: {
     nonce?: string;
 }) => JSXOutput;
 
+// Warning: (ae-forgotten-export) The symbol "DeserializeContainer" needs to be exported by the entry point index.d.ts
+//
+// @internal
+export function _preprocessState(data: unknown[], container: DeserializeContainer): void;
+
 // @public
 export type PropFunction<T> = QRL<T>;
 
@@ -1774,6 +1782,9 @@ export type VisibleTaskStrategy = 'intersection-observer' | 'document-ready' | '
 // @internal (undocumented)
 export type _VNode = _ElementVNode | _TextVNode | _VirtualVNode;
 
+// @internal (undocumented)
+export function _vnode_toString(this: _VNode | null, depth?: number, offset?: string, materialize?: boolean, siblings?: boolean, colorize?: boolean): string;
+
 // @internal
 export const enum _VNodeFlags {
     // (undocumented)

packages/qwik/src/core/shared/shared-serialization.ts

@@ -1614,6 +1614,7 @@ export function _createDeserializeContainer(
  *
  * @param data - The state data to preprocess
  * @returns The preprocessed state data
+ * @internal
  */
 export function preprocessState(data: unknown[], container: DeserializeContainer) {
   const isRootDeepRef = (type: TypeIds, value: unknown) => {
@@ -1934,6 +1935,7 @@ const printRaw = (value: any, prefix: string) => {
   return result.includes('\n') ? (result = `\n${prefix}${result}`) : result;
 };
 let hasRaw = false;
+/** @internal */
 export const dumpState = (
   state: unknown[],
   color = false,