@wildo-ai/presets-components-3d 1.1.9 → 1.1.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/dist/esm/focal-plane/focal-plane-depth-axis.d.ts +17 -0
  2. package/dist/esm/focal-plane/focal-plane-depth-axis.d.ts.map +1 -0
  3. package/dist/esm/focal-plane/focal-plane-depth-axis.js +59 -0
  4. package/dist/esm/focal-plane/focal-plane-depth-axis.js.map +1 -0
  5. package/dist/esm/focal-plane/focal-plane-shell-container.d.ts.map +1 -1
  6. package/dist/esm/focal-plane/focal-plane-shell-container.js +10 -119
  7. package/dist/esm/focal-plane/focal-plane-shell-container.js.map +1 -1
  8. package/dist/esm/focal-plane/focal-plane-stylesheet.d.ts +2 -9
  9. package/dist/esm/focal-plane/focal-plane-stylesheet.d.ts.map +1 -1
  10. package/dist/esm/focal-plane/focal-plane-stylesheet.js +32 -80
  11. package/dist/esm/focal-plane/focal-plane-stylesheet.js.map +1 -1
  12. package/dist/esm/focal-plane/focal-plane-vanishing-point.d.ts +27 -0
  13. package/dist/esm/focal-plane/focal-plane-vanishing-point.d.ts.map +1 -0
  14. package/dist/esm/focal-plane/focal-plane-vanishing-point.js +21 -0
  15. package/dist/esm/focal-plane/focal-plane-vanishing-point.js.map +1 -0
  16. package/dist/esm/index.d.ts +0 -1
  17. package/dist/esm/index.d.ts.map +1 -1
  18. package/dist/esm/index.js +0 -1
  19. package/dist/esm/index.js.map +1 -1
  20. package/dist/esm/layout/layout-3d-definition.d.ts +5 -7
  21. package/dist/esm/layout/layout-3d-definition.d.ts.map +1 -1
  22. package/dist/esm/layout/layout-3d-definition.js +1 -1
  23. package/dist/esm/layout/layout-3d-definition.js.map +1 -1
  24. package/dist/esm/layout-3d-main-container.d.ts +13 -18
  25. package/dist/esm/layout-3d-main-container.d.ts.map +1 -1
  26. package/dist/esm/layout-3d-main-container.js +7 -15
  27. package/dist/esm/layout-3d-main-container.js.map +1 -1
  28. package/dist/esm/register-3d-layout.d.ts +8 -4
  29. package/dist/esm/register-3d-layout.d.ts.map +1 -1
  30. package/dist/esm/register-3d-layout.js +16 -36
  31. package/dist/esm/register-3d-layout.js.map +1 -1
  32. package/package.json +3 -3
  33. package/dist/esm/focal-plane/use-pane-depth.d.ts +0 -20
  34. package/dist/esm/focal-plane/use-pane-depth.d.ts.map +0 -1
  35. package/dist/esm/focal-plane/use-pane-depth.js +0 -162
  36. package/dist/esm/focal-plane/use-pane-depth.js.map +0 -1
  37. package/dist/esm/focal-plane/use-shared-vanishing-point.d.ts +0 -35
  38. package/dist/esm/focal-plane/use-shared-vanishing-point.d.ts.map +0 -1
  39. package/dist/esm/focal-plane/use-shared-vanishing-point.js +0 -86
  40. package/dist/esm/focal-plane/use-shared-vanishing-point.js.map +0 -1
  41. package/dist/esm/layout/shell-layout-placement.d.ts +0 -26
  42. package/dist/esm/layout/shell-layout-placement.d.ts.map +0 -1
  43. package/dist/esm/layout/shell-layout-placement.js +0 -18
  44. package/dist/esm/layout/shell-layout-placement.js.map +0 -1
  45. package/dist/tsconfig.build.tsbuildinfo +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"register-3d-layout.js","sourceRoot":"","sources":["../../../src/register-3d-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,EAAE,wBAAwB,EAAsC,MAAM,6BAA6B,CAAC;AAE3G,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAwB,MAAM,4BAA4B,CAAC;AAClH,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAE3D,mIAAmI;AACnI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA2B,EAAE;IAC5D,IAAI,sBAAsB,GAAG,KAAK,CAAC;IACnC,OAAO;QACL,YAAY,EAAE,qBAAqB,CAAC,0BAA0B;QAC9D,MAAM,EAAE,eAAe,CAAC,OAAO;QAC/B,IAAI,cAAc;YAChB,OAAO,sBAAsB,CAAC;QAChC,CAAC;QACD,aAAa,EAAE,KAAK,IAAI,EAAE;YACxB,MAAM,OAAO,GAAG,wBAAwB,CAAC,OAAO,CAAC,qBAAqB,CAAC,0BAA0B,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;YAC5H,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACb,wHAAwH;sBACtH,4GAA4G,CAC/G,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC;YACnD,8GAA8G;YAC9G,2DAA2D;YAC3D,IAAK,MAAM,CAAC,MAAM,CAAC,UAAU,CAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,EAAgB,CAAC,KAAK,MAAM,EAAE,CAAC;gBAC3H,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,CAAC,EAAE,qFAAqF,CAAC,CAAC;YACxJ,CAAC;YACD,IAAI,uBAAuB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC;gBACxE,MAAM,IAAI,KAAK,CACb,0EAA0E,OAAO,CAAC,MAAM,CAAC,EAAE,uBAAuB,MAAM,CAAC,EAAE,KAAK;sBAC9H,8GAA8G;sBAC9G,iEAAiE,CACpE,CAAC;YACJ,CAAC;YACD,sBAAsB,GAAG,wBAAwB,CAAC,WAAW,CAAC,qBAAqB,CAAC,0BAA0B,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,cAAc,IAAI,KAAK,CAAC;YAClK,OAAO,qBAAqB,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACvG,CAAC;KACF,CAAC;AACJ,CAAC;AACD,wDAAwD","sourcesContent":["import { CorePresetNames, FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { ComponentRegistryService, type FrontendComponentRegistration } from '@wildo-ai/saas-frontend-lib';\n\nimport { create3DMainContainer, isLayout3DMainContainer, type Layout3DOptions } from './layout-3d-main-container';\nimport { BUILT_IN_LAYOUTS_3D, INHERIT_LAYOUT_3D } from './layout/layout-3d-definition';\nimport { Layout3DId } from './layout/layout-3d-vocabulary';\n\n/** @wildo_source:part:start presets.3d.register-layout facet:layer:frontend facet:family:layout-3d facet:audience:app-developer */\n/**\n * Make an application's signed-in shell 3D: the shell's regions — unchanged HTML, with all their contexts —\n * arranged by a 3D layout, with a decorative WebGL frame drawn under them.\n *\n * There is no 2D/3D switch and no option to enable it. An application is 3D because it CALLS this, from\n * its engine module's `componentRegistrations` — the entries `registerFrontendComponentRegistrations`\n * runs AFTER the framework presets are registered, so the Default main container exists by then:\n *\n * ```ts\n * import { register3DLayout } from '@wildo-ai/presets-components-3d';\n *\n * export const engineComponentRegistrations: FrontendComponentRegistration[] = [register3DLayout()];\n * ```\n *\n * It registers under `Default` for `APP_LAYOUTS_MAIN_CONTAINER`, the only preset key the shell resolves,\n * after capturing the container registered there before it. An INHERIT layout renders that captured container,\n * unchanged; a layout with a disposal of its own renders its composed container instead, built from the same\n * shell building blocks — either way every region, context and behaviour is the application's own.\n *\n * - **Refuses** when nothing is registered yet: capturing `null` would render no shell at all, and the\n * cause — the registration running before the framework presets — is worth an error, not a blank app.\n * - **Idempotent**: a registration that finds a 3D container already there (a second call, or the\n * registry surviving a hot reload on `globalThis`) wraps the 2D container IT captured, never itself.\n * - **Keeps the registration's metadata**: the captured container's `isConfigurable` is carried over, so\n * nothing that reads the registry's metadata sees a difference.\n *\n * `options.layout` selects the layout (`INHERIT_LAYOUT_3D` by default); `options.frameStyles` layers an\n * application's frame styles over the layout's own (per theme id, or for all themes).\n *\n * - **One layout per application.** A registration that finds a 3D container of a DIFFERENT layout already\n * registered refuses: an application is not 3D in two ways, and a silent replacement would hide which one it\n * is. The same layout again is idempotent. (A layout changed in code during a hot reload needs a full page\n * reload, because the registry outlives the hot reload.)\n */\nexport function register3DLayout(options: Layout3DOptions = {}): FrontendComponentRegistration {\n let capturedIsConfigurable = false;\n return {\n componentRef: FrontendComponentType.APP_LAYOUTS_MAIN_CONTAINER,\n preset: CorePresetNames.DEFAULT,\n get isConfigurable(): boolean {\n return capturedIsConfigurable;\n },\n loadComponent: async () => {\n const current = ComponentRegistryService.resolve(FrontendComponentType.APP_LAYOUTS_MAIN_CONTAINER, CorePresetNames.DEFAULT);\n if (!current) {\n throw new Error(\n 'register3DLayout(): no Default APP_LAYOUTS_MAIN_CONTAINER is registered to capture. Call it from the engine module\\'s '\n + '`componentRegistrations`, which run after the framework presets — not from a module evaluated before them.',\n );\n }\n const layout = options.layout ?? INHERIT_LAYOUT_3D;\n // An application's own layout may not borrow a built-in id: the one-layout check compares ids, and a borrowed\n // one would make two different layouts look like the same.\n if ((Object.values(Layout3DId) as string[]).includes(layout.id) && BUILT_IN_LAYOUTS_3D[layout.id as Layout3DId] !== layout) {\n throw new Error(`register3DLayout(): the layout id '${layout.id}' belongs to a built-in layout; give the application's own layout an id of its own.`);\n }\n if (isLayout3DMainContainer(current) && current.layout.id !== layout.id) {\n throw new Error(\n `register3DLayout(): this application already registered the 3D layout '${current.layout.id}' and now asks for '${layout.id}'. `\n + 'An application uses one layout: remove the other registration — or, if you just changed the layout in code, '\n + 'reload the page (the component registry outlives a hot reload).',\n );\n }\n capturedIsConfigurable = ComponentRegistryService.getMetadata(FrontendComponentType.APP_LAYOUTS_MAIN_CONTAINER, CorePresetNames.DEFAULT)?.isConfigurable ?? false;\n return create3DMainContainer(isLayout3DMainContainer(current) ? current.captured : current, options);\n },\n };\n}\n/** @wildo_source:part:end presets.3d.register-layout */\n"]}
1
+ {"version":3,"file":"register-3d-layout.js","sourceRoot":"","sources":["../../../src/register-3d-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAsC,MAAM,6BAA6B,CAAC;AAEzH,OAAO,EAAE,qBAAqB,EAAwB,MAAM,4BAA4B,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvF,mIAAmI;AACnI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA2B,EAAE;IAC5D,OAAO,mBAAmB,CAAC,OAAO,CAAC,MAAM,IAAI,iBAAiB,EAAE;QAC9D,UAAU,EAAE,oBAAoB;QAChC,MAAM,EAAE,iBAAiB,CAAC,SAAS;QACnC,cAAc,EAAE,mBAAmB;QACnC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,qBAAqB,CAAC,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC;KAC/F,CAAC,CAAC;AACL,CAAC;AACD,wDAAwD","sourcesContent":["import { registerShellLayout, ShellLayoutFamily, type FrontendComponentRegistration } from '@wildo-ai/saas-frontend-lib';\n\nimport { create3DMainContainer, type Layout3DOptions } from './layout-3d-main-container';\nimport { BUILT_IN_LAYOUTS_3D, INHERIT_LAYOUT_3D } from './layout/layout-3d-definition';\n\n/** @wildo_source:part:start presets.3d.register-layout facet:layer:frontend facet:family:layout-3d facet:audience:app-developer */\n/**\n * Make an application's signed-in shell 3D: the shell's regions — unchanged HTML, with all their contexts —\n * arranged by a 3D layout, with a decorative WebGL frame drawn under them.\n *\n * There is no 2D/3D switch and no option to enable it. An application is 3D because it CALLS this, from\n * its engine module's `componentRegistrations` — the entries `registerFrontendComponentRegistrations`\n * runs AFTER the framework presets are registered, so the Default main container exists by then:\n *\n * ```ts\n * import { register3DLayout } from '@wildo-ai/presets-components-3d';\n *\n * export const engineComponentRegistrations: FrontendComponentRegistration[] = [register3DLayout()];\n * ```\n *\n * It registers under `Default` for `APP_LAYOUTS_MAIN_CONTAINER`, the only preset key the shell resolves,\n * after capturing the container registered there before it. An INHERIT layout renders that captured container,\n * unchanged; a layout with a disposal of its own renders its composed container instead, built from the same\n * shell building blocks — either way every region, context and behaviour is the application's own.\n *\n * - **Refuses** when nothing is registered yet: capturing `null` would render no shell at all, and the\n * cause — the registration running before the framework presets — is worth an error, not a blank app.\n * - **Idempotent**: a registration that finds a 3D container already there (a second call, or the\n * registry surviving a hot reload on `globalThis`) wraps the 2D container IT captured, never itself.\n * - **Keeps the registration's metadata**: the captured container's `isConfigurable` is carried over, so\n * nothing that reads the registry's metadata sees a difference.\n *\n * `options.layout` selects the layout (`INHERIT_LAYOUT_3D` by default); `options.frameStyles` layers an\n * application's frame styles over the layout's own (per theme id, or for all themes).\n *\n * - **One layout per application, 2D or 3D.** A registration that finds a layout container of a DIFFERENT layout\n * already registered refuses — including a 2D layout registered with `registerShellLayout`: an application is\n * laid out one way, and a silent replacement would hide which one it is. The same layout again is idempotent. (A\n * layout changed in code during a hot reload needs a full page reload, because the registry outlives the hot\n * reload.)\n *\n * It is `registerShellLayout` from `@wildo-ai/saas-frontend-lib` — the registration every layout family shares —\n * with the 3D built-ins guarded and a container that adds the frame and the focal-plane settings.\n */\nexport function register3DLayout(options: Layout3DOptions = {}): FrontendComponentRegistration {\n return registerShellLayout(options.layout ?? INHERIT_LAYOUT_3D, {\n callerName: 'register3DLayout()',\n family: ShellLayoutFamily.LAYOUT_3D,\n builtInLayouts: BUILT_IN_LAYOUTS_3D,\n createContainer: (captured, layout) => create3DMainContainer(captured, { ...options, layout }),\n });\n}\n/** @wildo_source:part:end presets.3d.register-layout */\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wildo-ai/presets-components-3d",
3
- "version": "1.1.9",
3
+ "version": "1.1.11",
4
4
  "license": "SEE LICENSE IN LICENSE",
5
5
  "description": "Optional 3D layouts for the Wildo AI application shell: its regions, unchanged HTML, arranged by a 3D layout over a decorative WebGL frame",
6
6
  "author": "Wildo AI",
@@ -29,8 +29,8 @@
29
29
  "test:watch": "vitest"
30
30
  },
31
31
  "dependencies": {
32
- "@wildo-ai/presets-components-models": "1.1.9",
33
- "@wildo-ai/saas-frontend-lib": "1.1.9",
32
+ "@wildo-ai/presets-components-models": "1.1.11",
33
+ "@wildo-ai/saas-frontend-lib": "1.1.11",
34
34
  "culori": "^4.0.2"
35
35
  },
36
36
  "peerDependencies": {
@@ -1,20 +0,0 @@
1
- import { type RefObject } from 'react';
2
- import type { FocalPlaneSettings } from './focal-plane-settings';
3
- /**
4
- * What the stylesheet cannot do alone, because the engine unmounts or hides a pane at once (#2049 step 2):
5
- *
6
- * - **Discard.** A side pane dismissed by its close control is removed from the DOM immediately. The removed node,
7
- * no longer React's, is re-parented into a ghost layer at the box it last had, and flies away into depth and fades.
8
- * - **Expand.** An emphasized side pane takes the width, and the engine HIDES the other panes (`hidden`). A still,
9
- * inert image of each hidden pane is left behind, stepped back, visible through the expanded pane's glass. It is a
10
- * picture, not a control: stepped back, it shrinks inside the expanded pane's outline, which covers it, so a click
11
- * could never reach it (an earlier version offered one; a live probe found it unreachable). Returning to side by
12
- * side is the pane's own restore control, or Escape. The image travels forward and goes as the emphasis ends.
13
- * - **Swap.** A pane whose content changes in place dips back and returns (`dip`).
14
- *
15
- * Ghosts are aria-hidden and inert: they are pictures of panes, never a second copy anyone can use.
16
- */
17
- export declare function usePaneDepth(rootRef: RefObject<HTMLElement | null>, settings: FocalPlaneSettings, reducedMotion: boolean): {
18
- dip: (zone: string) => void;
19
- };
20
- //# sourceMappingURL=use-pane-depth.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"use-pane-depth.d.ts","sourceRoot":"","sources":["../../../../src/focal-plane/use-pane-depth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAM3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACtC,QAAQ,EAAE,kBAAkB,EAC5B,aAAa,EAAE,OAAO,GACrB;IAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,CAqHjC"}
@@ -1,162 +0,0 @@
1
- import { useEffect, useLayoutEffect, useRef } from 'react';
2
- import { ShellRegion } from '@wildo-ai/presets-components-models';
3
- import { NavigationZone } from '@wildo-ai/saas-frontend-lib';
4
- import { FOCAL_PLANE_PANE_SELECTOR } from './focal-plane-stylesheet.js';
5
- import { lastStageRects, VANISHING_POINT } from './use-shared-vanishing-point.js';
6
- /**
7
- * What the stylesheet cannot do alone, because the engine unmounts or hides a pane at once (#2049 step 2):
8
- *
9
- * - **Discard.** A side pane dismissed by its close control is removed from the DOM immediately. The removed node,
10
- * no longer React's, is re-parented into a ghost layer at the box it last had, and flies away into depth and fades.
11
- * - **Expand.** An emphasized side pane takes the width, and the engine HIDES the other panes (`hidden`). A still,
12
- * inert image of each hidden pane is left behind, stepped back, visible through the expanded pane's glass. It is a
13
- * picture, not a control: stepped back, it shrinks inside the expanded pane's outline, which covers it, so a click
14
- * could never reach it (an earlier version offered one; a live probe found it unreachable). Returning to side by
15
- * side is the pane's own restore control, or Escape. The image travels forward and goes as the emphasis ends.
16
- * - **Swap.** A pane whose content changes in place dips back and returns (`dip`).
17
- *
18
- * Ghosts are aria-hidden and inert: they are pictures of panes, never a second copy anyone can use.
19
- */
20
- export function usePaneDepth(rootRef, settings, reducedMotion) {
21
- useLayoutEffect(() => {
22
- const root = rootRef.current;
23
- if (!root)
24
- return undefined;
25
- const back = root.querySelector('.fp-ghosts:not(.fp-ghosts-front)');
26
- const front = root.querySelector('.fp-ghosts-front');
27
- if (!back || !front)
28
- return undefined;
29
- const behind = new Map();
30
- const motion = reducedMotion ? 0 : settings.motionMs;
31
- const place = (ghost, rect) => {
32
- const vx = root.clientWidth * VANISHING_POINT.x;
33
- const vy = root.clientHeight * VANISHING_POINT.y;
34
- Object.assign(ghost.style, { left: `${rect.left}px`, top: `${rect.top}px`, width: `${rect.width}px`, height: `${rect.height}px` });
35
- ghost.style.setProperty('--fp-ox', `${vx - rect.left}px`);
36
- ghost.style.setProperty('--fp-oy', `${vy - rect.top}px`);
37
- };
38
- const inertCopy = (node) => {
39
- const copy = node.cloneNode(true);
40
- sanitise(copy);
41
- return copy;
42
- };
43
- const discard = (node) => {
44
- const rect = lastStageRects.get(node);
45
- // Moved rather than removed (taken out and put back in one batch): it is still on screen, not discarded.
46
- if (!rect || motion === 0 || node.isConnected)
47
- return;
48
- const ghost = document.createElement('div');
49
- ghost.className = 'fp-ghost';
50
- sanitise(node);
51
- ghost.appendChild(node);
52
- place(ghost, rect);
53
- front.appendChild(ghost);
54
- requestAnimationFrame(() => requestAnimationFrame(() => {
55
- ghost.style.setProperty('--fp-z', `${-settings.layerDepthPx * 1.5}px`);
56
- ghost.style.opacity = '0';
57
- }));
58
- setTimeout(() => ghost.remove(), motion + 60);
59
- };
60
- const syncBehind = () => {
61
- const emphasized = root.querySelector('[data-zone-emphasized]');
62
- const hidden = emphasized ? [...root.querySelectorAll(FOCAL_PLANE_PANE_SELECTOR)].filter((pane) => pane.hasAttribute('data-zone-hidden')) : [];
63
- for (const [pane, ghost] of behind) {
64
- if (hidden.includes(pane))
65
- continue;
66
- behind.delete(pane);
67
- ghost.style.setProperty('--fp-z', '0px');
68
- ghost.style.opacity = '0';
69
- setTimeout(() => ghost.remove(), motion);
70
- }
71
- for (const pane of hidden) {
72
- if (behind.has(pane))
73
- continue;
74
- const rect = lastStageRects.get(pane);
75
- if (!rect)
76
- continue;
77
- const ghost = document.createElement('div');
78
- ghost.className = 'fp-ghost fp-ghost-behind';
79
- const copy = inertCopy(pane);
80
- copy.classList.remove('hidden');
81
- copy.removeAttribute('data-zone-hidden');
82
- copy.style.width = '100%';
83
- copy.style.height = '100%';
84
- ghost.appendChild(copy);
85
- place(ghost, rect);
86
- ghost.style.opacity = '0';
87
- back.appendChild(ghost);
88
- behind.set(pane, ghost);
89
- requestAnimationFrame(() => requestAnimationFrame(() => {
90
- ghost.style.setProperty('--fp-z', `${-settings.layerDepthPx}px`);
91
- ghost.style.setProperty('--fp-filter', `brightness(${1 - settings.recedeDim}) saturate(${1 - settings.recedeDim * 0.9})`);
92
- ghost.style.opacity = '1';
93
- }));
94
- }
95
- };
96
- const observer = new MutationObserver((records) => {
97
- let emphasisMayHaveChanged = false;
98
- for (const record of records) {
99
- if (record.type === 'attributes') {
100
- emphasisMayHaveChanged = true;
101
- continue;
102
- }
103
- for (const node of record.removedNodes) {
104
- if (!(node instanceof HTMLElement))
105
- continue;
106
- // A detached node matches no selector that names its ancestors, so the pane is recognised by the box the
107
- // stage last measured for it: only objects (a zone, or a resizable panel) have one.
108
- // Only a SIDE pane is ever dismissed. The primary pane leaves only when the content remounts (a breakpoint
109
- // flip to the single-zone branch), which is not a discard and must not fly a ghost away.
110
- if (lastStageRects.has(node) && isSidePane(node))
111
- discard(node);
112
- }
113
- emphasisMayHaveChanged = true;
114
- }
115
- if (emphasisMayHaveChanged)
116
- syncBehind();
117
- });
118
- const content = root.querySelector(`[data-component-area="${ShellRegion.CONTENT}"]`) ?? root;
119
- observer.observe(content, { childList: true, subtree: true, attributes: true, attributeFilter: ['data-zone-hidden', 'data-zone-emphasized'] });
120
- syncBehind();
121
- return () => {
122
- observer.disconnect();
123
- for (const ghost of behind.values())
124
- ghost.remove();
125
- };
126
- }, [rootRef, settings, reducedMotion]);
127
- const dipRef = useRef(() => undefined);
128
- useEffect(() => {
129
- dipRef.current = (zone) => {
130
- const root = rootRef.current;
131
- if (!root || reducedMotion)
132
- return;
133
- const pane = root.querySelector(`[data-component-area="${ShellRegion.CONTENT}"] :is([data-content-area="${zone}"]:not([data-panel-id] *), [data-panel-id="nav-${zone}"])`);
134
- if (!pane || typeof pane.animate !== 'function')
135
- return;
136
- // Implicit first and last keyframes: the pane dips from, and returns to, whatever depth it rests at.
137
- pane.animate([{ offset: 0.45, transform: `perspective(${settings.cameraDistancePx}px) translate3d(0, 0, ${-settings.layerDepthPx * 0.5}px)`, opacity: 0.55 }], { duration: settings.motionMs, easing: 'cubic-bezier(0.2, 0.9, 0.25, 1)' });
138
- };
139
- }, [rootRef, settings, reducedMotion]);
140
- return { dip: (zone) => dipRef.current(zone) };
141
- }
142
- const SIDE_ZONES = new Set([NavigationZone.SECONDARY, NavigationZone.COMPANION]);
143
- function isSidePane(element) {
144
- const zone = element.dataset.contentArea ?? element.dataset.panelId?.replace(/^nav-/, '');
145
- return zone !== undefined && SIDE_ZONES.has(zone);
146
- }
147
- /**
148
- * Makes a pane a picture: no ids, no focus, invisible to assistive technology, and none of the markers a query for the
149
- * REAL pane would find (a document-level lookup of the primary pane must never return its image). Embedded frames and
150
- * media are dropped rather than loaded a second time.
151
- */
152
- function sanitise(element) {
153
- element.setAttribute('aria-hidden', 'true');
154
- element.setAttribute('inert', '');
155
- for (const node of [element, ...element.querySelectorAll('*')]) {
156
- for (const attribute of ['id', 'data-content-area', 'data-panel-id', 'data-zone-hidden', 'data-zone-emphasized', 'data-component-area'])
157
- node.removeAttribute(attribute);
158
- }
159
- for (const media of element.querySelectorAll('iframe, video, audio'))
160
- media.remove();
161
- }
162
- //# sourceMappingURL=use-pane-depth.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"use-pane-depth.js","sourceRoot":"","sources":["../../../../src/focal-plane/use-pane-depth.ts"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useLayoutEffect, useRef, type RefObject } from 'react';\n\nimport { ShellRegion } from '@wildo-ai/presets-components-models';\nimport { NavigationZone } from '@wildo-ai/saas-frontend-lib';\n\nimport { FOCAL_PLANE_PANE_SELECTOR } from './focal-plane-stylesheet';\nimport type { FocalPlaneSettings } from './focal-plane-settings';\nimport { lastStageRects, VANISHING_POINT, type StageRect } from './use-shared-vanishing-point';\n\n/**\n * What the stylesheet cannot do alone, because the engine unmounts or hides a pane at once (#2049 step 2):\n *\n * - **Discard.** A side pane dismissed by its close control is removed from the DOM immediately. The removed node,\n * no longer React's, is re-parented into a ghost layer at the box it last had, and flies away into depth and fades.\n * - **Expand.** An emphasized side pane takes the width, and the engine HIDES the other panes (`hidden`). A still,\n * inert image of each hidden pane is left behind, stepped back, visible through the expanded pane's glass. It is a\n * picture, not a control: stepped back, it shrinks inside the expanded pane's outline, which covers it, so a click\n * could never reach it (an earlier version offered one; a live probe found it unreachable). Returning to side by\n * side is the pane's own restore control, or Escape. The image travels forward and goes as the emphasis ends.\n * - **Swap.** A pane whose content changes in place dips back and returns (`dip`).\n *\n * Ghosts are aria-hidden and inert: they are pictures of panes, never a second copy anyone can use.\n */\nexport function usePaneDepth(\n rootRef: RefObject<HTMLElement | null>,\n settings: FocalPlaneSettings,\n reducedMotion: boolean,\n): { dip: (zone: string) => void } {\n useLayoutEffect(() => {\n const root = rootRef.current;\n if (!root) return undefined;\n const back = root.querySelector<HTMLElement>('.fp-ghosts:not(.fp-ghosts-front)');\n const front = root.querySelector<HTMLElement>('.fp-ghosts-front');\n if (!back || !front) return undefined;\n const behind = new Map<Element, HTMLElement>();\n const motion = reducedMotion ? 0 : settings.motionMs;\n\n const place = (ghost: HTMLElement, rect: StageRect): void => {\n const vx = root.clientWidth * VANISHING_POINT.x;\n const vy = root.clientHeight * VANISHING_POINT.y;\n Object.assign(ghost.style, { left: `${rect.left}px`, top: `${rect.top}px`, width: `${rect.width}px`, height: `${rect.height}px` });\n ghost.style.setProperty('--fp-ox', `${vx - rect.left}px`);\n ghost.style.setProperty('--fp-oy', `${vy - rect.top}px`);\n };\n const inertCopy = (node: Element): HTMLElement => {\n const copy = node.cloneNode(true) as HTMLElement;\n sanitise(copy);\n return copy;\n };\n\n const discard = (node: HTMLElement): void => {\n const rect = lastStageRects.get(node);\n // Moved rather than removed (taken out and put back in one batch): it is still on screen, not discarded.\n if (!rect || motion === 0 || node.isConnected) return;\n const ghost = document.createElement('div');\n ghost.className = 'fp-ghost';\n sanitise(node);\n ghost.appendChild(node);\n place(ghost, rect);\n front.appendChild(ghost);\n requestAnimationFrame(() => requestAnimationFrame(() => {\n ghost.style.setProperty('--fp-z', `${-settings.layerDepthPx * 1.5}px`);\n ghost.style.opacity = '0';\n }));\n setTimeout(() => ghost.remove(), motion + 60);\n };\n\n const syncBehind = (): void => {\n const emphasized = root.querySelector('[data-zone-emphasized]');\n const hidden = emphasized ? [...root.querySelectorAll<HTMLElement>(FOCAL_PLANE_PANE_SELECTOR)].filter((pane) => pane.hasAttribute('data-zone-hidden')) : [];\n for (const [pane, ghost] of behind) {\n if (hidden.includes(pane as HTMLElement)) continue;\n behind.delete(pane);\n ghost.style.setProperty('--fp-z', '0px');\n ghost.style.opacity = '0';\n setTimeout(() => ghost.remove(), motion);\n }\n for (const pane of hidden) {\n if (behind.has(pane)) continue;\n const rect = lastStageRects.get(pane);\n if (!rect) continue;\n const ghost = document.createElement('div');\n ghost.className = 'fp-ghost fp-ghost-behind';\n const copy = inertCopy(pane);\n copy.classList.remove('hidden');\n copy.removeAttribute('data-zone-hidden');\n copy.style.width = '100%';\n copy.style.height = '100%';\n ghost.appendChild(copy);\n place(ghost, rect);\n ghost.style.opacity = '0';\n back.appendChild(ghost);\n behind.set(pane, ghost);\n requestAnimationFrame(() => requestAnimationFrame(() => {\n ghost.style.setProperty('--fp-z', `${-settings.layerDepthPx}px`);\n ghost.style.setProperty('--fp-filter', `brightness(${1 - settings.recedeDim}) saturate(${1 - settings.recedeDim * 0.9})`);\n ghost.style.opacity = '1';\n }));\n }\n };\n\n const observer = new MutationObserver((records) => {\n let emphasisMayHaveChanged = false;\n for (const record of records) {\n if (record.type === 'attributes') {\n emphasisMayHaveChanged = true;\n continue;\n }\n for (const node of record.removedNodes) {\n if (!(node instanceof HTMLElement)) continue;\n // A detached node matches no selector that names its ancestors, so the pane is recognised by the box the\n // stage last measured for it: only objects (a zone, or a resizable panel) have one.\n // Only a SIDE pane is ever dismissed. The primary pane leaves only when the content remounts (a breakpoint\n // flip to the single-zone branch), which is not a discard and must not fly a ghost away.\n if (lastStageRects.has(node) && isSidePane(node)) discard(node);\n }\n emphasisMayHaveChanged = true;\n }\n if (emphasisMayHaveChanged) syncBehind();\n });\n const content = root.querySelector(`[data-component-area=\"${ShellRegion.CONTENT}\"]`) ?? root;\n observer.observe(content, { childList: true, subtree: true, attributes: true, attributeFilter: ['data-zone-hidden', 'data-zone-emphasized'] });\n syncBehind();\n return () => {\n observer.disconnect();\n for (const ghost of behind.values()) ghost.remove();\n };\n }, [rootRef, settings, reducedMotion]);\n\n const dipRef = useRef<(zone: string) => void>(() => undefined);\n useEffect(() => {\n dipRef.current = (zone: string): void => {\n const root = rootRef.current;\n if (!root || reducedMotion) return;\n const pane = root.querySelector<HTMLElement>(`[data-component-area=\"${ShellRegion.CONTENT}\"] :is([data-content-area=\"${zone}\"]:not([data-panel-id] *), [data-panel-id=\"nav-${zone}\"])`);\n if (!pane || typeof pane.animate !== 'function') return;\n // Implicit first and last keyframes: the pane dips from, and returns to, whatever depth it rests at.\n pane.animate(\n [{ offset: 0.45, transform: `perspective(${settings.cameraDistancePx}px) translate3d(0, 0, ${-settings.layerDepthPx * 0.5}px)`, opacity: 0.55 }],\n { duration: settings.motionMs, easing: 'cubic-bezier(0.2, 0.9, 0.25, 1)' },\n );\n };\n }, [rootRef, settings, reducedMotion]);\n return { dip: (zone) => dipRef.current(zone) };\n}\n\nconst SIDE_ZONES: ReadonlySet<string> = new Set([NavigationZone.SECONDARY, NavigationZone.COMPANION]);\nfunction isSidePane(element: HTMLElement): boolean {\n const zone = element.dataset.contentArea ?? element.dataset.panelId?.replace(/^nav-/, '');\n return zone !== undefined && SIDE_ZONES.has(zone);\n}\n\n/**\n * Makes a pane a picture: no ids, no focus, invisible to assistive technology, and none of the markers a query for the\n * REAL pane would find (a document-level lookup of the primary pane must never return its image). Embedded frames and\n * media are dropped rather than loaded a second time.\n */\nfunction sanitise(element: HTMLElement): void {\n element.setAttribute('aria-hidden', 'true');\n element.setAttribute('inert', '');\n for (const node of [element, ...element.querySelectorAll<HTMLElement>('*')]) {\n for (const attribute of ['id', 'data-content-area', 'data-panel-id', 'data-zone-hidden', 'data-zone-emphasized', 'data-component-area']) node.removeAttribute(attribute);\n }\n for (const media of element.querySelectorAll('iframe, video, audio')) media.remove();\n}\n"]}
@@ -1,35 +0,0 @@
1
- import { type RefObject } from 'react';
2
- /** Where the vanishing point sits in the stage: centred, a little above the middle (the eye line of the prototype). */
3
- export declare const VANISHING_POINT: {
4
- x: number;
5
- y: number;
6
- };
7
- /** An object's laid-out box in the stage (untransformed), as last measured. */
8
- export interface StageRect {
9
- left: number;
10
- top: number;
11
- width: number;
12
- height: number;
13
- }
14
- /**
15
- * The last laid-out box of every object, kept so a pane that has just been REMOVED or HIDDEN can still be drawn where
16
- * it was (its ghost flies into depth from there). A zero-size reading never replaces a real one: a hidden pane measures
17
- * as nothing, and its last visible box is the one that matters.
18
- */
19
- export declare const lastStageRects: WeakMap<Element, StageRect>;
20
- /**
21
- * Keeps every object's `transform-origin` on the stage's ONE vanishing point, so objects that each carry their own
22
- * `perspective()` are seen through a single still camera (see `focal-plane-stylesheet.ts`).
23
- *
24
- * The origin is written as two custom properties on each object (`--fp-ox`, `--fp-oy`): the vanishing point minus the
25
- * object's own offset in the stage. Offsets are read from `offsetLeft`/`offsetTop`, which ignore transforms, so an object
26
- * that is currently stepped back still reports where it is laid out. Custom properties written this way are left alone
27
- * by React, which only manages the style properties it set itself.
28
- */
29
- export declare function useSharedVanishingPoint(rootRef: RefObject<HTMLElement | null>): void;
30
- /** An element's layout offset inside `root`, walking the offset-parent chain (transforms are not part of it). */
31
- export declare function offsetWithin(element: HTMLElement, root: HTMLElement): {
32
- left: number;
33
- top: number;
34
- };
35
- //# sourceMappingURL=use-shared-vanishing-point.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"use-shared-vanishing-point.d.ts","sourceRoot":"","sources":["../../../../src/focal-plane/use-shared-vanishing-point.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIxD,uHAAuH;AACvH,eAAO,MAAM,eAAe;;;CAAsB,CAAC;AAEnD,+EAA+E;AAC/E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,6BAAoC,CAAC;AAEhE;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,IAAI,CAuCpF;AAED,iHAAiH;AACjH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAYnG"}
@@ -1,86 +0,0 @@
1
- import { useLayoutEffect } from 'react';
2
- import { FOCAL_PLANE_PANE_SELECTOR } from './focal-plane-stylesheet.js';
3
- /** Where the vanishing point sits in the stage: centred, a little above the middle (the eye line of the prototype). */
4
- export const VANISHING_POINT = { x: 0.5, y: 0.42 };
5
- /**
6
- * The last laid-out box of every object, kept so a pane that has just been REMOVED or HIDDEN can still be drawn where
7
- * it was (its ghost flies into depth from there). A zero-size reading never replaces a real one: a hidden pane measures
8
- * as nothing, and its last visible box is the one that matters.
9
- */
10
- export const lastStageRects = new WeakMap();
11
- /**
12
- * Keeps every object's `transform-origin` on the stage's ONE vanishing point, so objects that each carry their own
13
- * `perspective()` are seen through a single still camera (see `focal-plane-stylesheet.ts`).
14
- *
15
- * The origin is written as two custom properties on each object (`--fp-ox`, `--fp-oy`): the vanishing point minus the
16
- * object's own offset in the stage. Offsets are read from `offsetLeft`/`offsetTop`, which ignore transforms, so an object
17
- * that is currently stepped back still reports where it is laid out. Custom properties written this way are left alone
18
- * by React, which only manages the style properties it set itself.
19
- */
20
- export function useSharedVanishingPoint(rootRef) {
21
- useLayoutEffect(() => {
22
- const root = rootRef.current;
23
- if (!root)
24
- return undefined;
25
- let frame = 0;
26
- // Absent in some environments (a test DOM): the window resize and the mutations below still re-measure.
27
- const resize = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(() => schedule());
28
- const observed = new Set();
29
- const measure = () => {
30
- frame = 0;
31
- const vx = root.clientWidth * VANISHING_POINT.x;
32
- const vy = root.clientHeight * VANISHING_POINT.y;
33
- const objects = new Set(root.querySelectorAll(`[data-fp-object], ${FOCAL_PLANE_PANE_SELECTOR}`));
34
- // Every object is observed, not only the stage: a sidebar collapsing MOVES the content column without resizing
35
- // the stage, and a moved object with a stale origin would be seen from the wrong point.
36
- for (const element of objects)
37
- if (!observed.has(element)) {
38
- resize?.observe(element);
39
- observed.add(element);
40
- }
41
- for (const element of observed)
42
- if (!objects.has(element)) {
43
- resize?.unobserve(element);
44
- observed.delete(element);
45
- }
46
- for (const element of objects) {
47
- const { left, top } = offsetWithin(element, root);
48
- element.style.setProperty('--fp-ox', `${(vx - left).toFixed(1)}px`);
49
- element.style.setProperty('--fp-oy', `${(vy - top).toFixed(1)}px`);
50
- if (element.offsetWidth > 0 && element.offsetHeight > 0)
51
- lastStageRects.set(element, { left, top, width: element.offsetWidth, height: element.offsetHeight });
52
- }
53
- };
54
- const schedule = () => {
55
- if (!frame)
56
- frame = requestAnimationFrame(measure);
57
- };
58
- measure();
59
- resize?.observe(root);
60
- const mutations = new MutationObserver(schedule);
61
- mutations.observe(root, { childList: true, subtree: true });
62
- window.addEventListener('resize', schedule);
63
- return () => {
64
- cancelAnimationFrame(frame);
65
- resize?.disconnect();
66
- mutations.disconnect();
67
- window.removeEventListener('resize', schedule);
68
- };
69
- }, [rootRef]);
70
- }
71
- /** An element's layout offset inside `root`, walking the offset-parent chain (transforms are not part of it). */
72
- export function offsetWithin(element, root) {
73
- let left = 0;
74
- let top = 0;
75
- let node = element;
76
- while (node && node !== root) {
77
- left += node.offsetLeft;
78
- top += node.offsetTop;
79
- const parent = node.offsetParent;
80
- if (!parent || !root.contains(parent) && parent !== root)
81
- break;
82
- node = parent;
83
- }
84
- return { left, top };
85
- }
86
- //# sourceMappingURL=use-shared-vanishing-point.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"use-shared-vanishing-point.js","sourceRoot":"","sources":["../../../../src/focal-plane/use-shared-vanishing-point.ts"],"names":[],"mappings":"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","sourcesContent":["import { useLayoutEffect, type RefObject } from 'react';\n\nimport { FOCAL_PLANE_PANE_SELECTOR } from './focal-plane-stylesheet';\n\n/** Where the vanishing point sits in the stage: centred, a little above the middle (the eye line of the prototype). */\nexport const VANISHING_POINT = { x: 0.5, y: 0.42 };\n\n/** An object's laid-out box in the stage (untransformed), as last measured. */\nexport interface StageRect {\n left: number;\n top: number;\n width: number;\n height: number;\n}\n\n/**\n * The last laid-out box of every object, kept so a pane that has just been REMOVED or HIDDEN can still be drawn where\n * it was (its ghost flies into depth from there). A zero-size reading never replaces a real one: a hidden pane measures\n * as nothing, and its last visible box is the one that matters.\n */\nexport const lastStageRects = new WeakMap<Element, StageRect>();\n\n/**\n * Keeps every object's `transform-origin` on the stage's ONE vanishing point, so objects that each carry their own\n * `perspective()` are seen through a single still camera (see `focal-plane-stylesheet.ts`).\n *\n * The origin is written as two custom properties on each object (`--fp-ox`, `--fp-oy`): the vanishing point minus the\n * object's own offset in the stage. Offsets are read from `offsetLeft`/`offsetTop`, which ignore transforms, so an object\n * that is currently stepped back still reports where it is laid out. Custom properties written this way are left alone\n * by React, which only manages the style properties it set itself.\n */\nexport function useSharedVanishingPoint(rootRef: RefObject<HTMLElement | null>): void {\n useLayoutEffect(() => {\n const root = rootRef.current;\n if (!root) return undefined;\n let frame = 0;\n // Absent in some environments (a test DOM): the window resize and the mutations below still re-measure.\n const resize = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(() => schedule());\n const observed = new Set<HTMLElement>();\n const measure = (): void => {\n frame = 0;\n const vx = root.clientWidth * VANISHING_POINT.x;\n const vy = root.clientHeight * VANISHING_POINT.y;\n const objects = new Set(root.querySelectorAll<HTMLElement>(`[data-fp-object], ${FOCAL_PLANE_PANE_SELECTOR}`));\n // Every object is observed, not only the stage: a sidebar collapsing MOVES the content column without resizing\n // the stage, and a moved object with a stale origin would be seen from the wrong point.\n for (const element of objects) if (!observed.has(element)) { resize?.observe(element); observed.add(element); }\n for (const element of observed) if (!objects.has(element)) { resize?.unobserve(element); observed.delete(element); }\n for (const element of objects) {\n const { left, top } = offsetWithin(element, root);\n element.style.setProperty('--fp-ox', `${(vx - left).toFixed(1)}px`);\n element.style.setProperty('--fp-oy', `${(vy - top).toFixed(1)}px`);\n if (element.offsetWidth > 0 && element.offsetHeight > 0) lastStageRects.set(element, { left, top, width: element.offsetWidth, height: element.offsetHeight });\n }\n };\n const schedule = (): void => {\n if (!frame) frame = requestAnimationFrame(measure);\n };\n measure();\n resize?.observe(root);\n const mutations = new MutationObserver(schedule);\n mutations.observe(root, { childList: true, subtree: true });\n window.addEventListener('resize', schedule);\n return () => {\n cancelAnimationFrame(frame);\n resize?.disconnect();\n mutations.disconnect();\n window.removeEventListener('resize', schedule);\n };\n }, [rootRef]);\n}\n\n/** An element's layout offset inside `root`, walking the offset-parent chain (transforms are not part of it). */\nexport function offsetWithin(element: HTMLElement, root: HTMLElement): { left: number; top: number } {\n let left = 0;\n let top = 0;\n let node: HTMLElement | null = element;\n while (node && node !== root) {\n left += node.offsetLeft;\n top += node.offsetTop;\n const parent = node.offsetParent as HTMLElement | null;\n if (!parent || !root.contains(parent) && parent !== root) break;\n node = parent;\n }\n return { left, top };\n}\n"]}
@@ -1,26 +0,0 @@
1
- import type React from 'react';
2
- import type { AppLayoutPreset_MainContainer_DefaultProps } from '@wildo-ai/saas-frontend-lib';
3
- /** @wildo_source:part:start presets.3d.layout-contract facet:layer:frontend facet:family:layout-3d facet:audience:app-developer */
4
- /**
5
- * How a shell layout disposes the regions — the half of a layout with nothing 3D in it.
6
- *
7
- * Named for the SHELL, not for 3D, on purpose: a composed placement is an ordinary shell container built from the
8
- * building blocks of `@wildo-ai/saas-frontend-lib` (`AppShellProviders`, the region, content and overlays outlets,
9
- * `AppShellLoadingState`), so the same shape can serve a general layout system for 2D shells — planned, not built —
10
- * without renaming. The 3D half (scene, transitions, rest pose) lives in `Layout3DDefinition`.
11
- */
12
- export declare enum ShellLayoutPlacementKind {
13
- /** The main container the registration captured (the 2D default, or an application's own), rendered unchanged. */
14
- INHERIT = "inherit",
15
- /** A container of the layout's own, composed from the shell building blocks. */
16
- COMPOSED = "composed"
17
- }
18
- /** A shell layout's disposal. */
19
- export type ShellLayoutPlacement = {
20
- kind: ShellLayoutPlacementKind.INHERIT;
21
- } | {
22
- kind: ShellLayoutPlacementKind.COMPOSED;
23
- container: React.ComponentType<AppLayoutPreset_MainContainer_DefaultProps>;
24
- };
25
- /** @wildo_source:part:end presets.3d.layout-contract */
26
- //# sourceMappingURL=shell-layout-placement.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"shell-layout-placement.d.ts","sourceRoot":"","sources":["../../../../src/layout/shell-layout-placement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,6BAA6B,CAAC;AAE9F,mIAAmI;AACnI;;;;;;;GAOG;AACH,oBAAY,wBAAwB;IAClC,kHAAkH;IAClH,OAAO,YAAY;IACnB,gFAAgF;IAChF,QAAQ,aAAa;CACtB;AAED,iCAAiC;AACjC,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,wBAAwB,CAAC,OAAO,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,wBAAwB,CAAC,QAAQ,CAAC;IAAC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,0CAA0C,CAAC,CAAA;CAAE,CAAC;AAC5H,wDAAwD"}
@@ -1,18 +0,0 @@
1
- /** @wildo_source:part:start presets.3d.layout-contract facet:layer:frontend facet:family:layout-3d facet:audience:app-developer */
2
- /**
3
- * How a shell layout disposes the regions — the half of a layout with nothing 3D in it.
4
- *
5
- * Named for the SHELL, not for 3D, on purpose: a composed placement is an ordinary shell container built from the
6
- * building blocks of `@wildo-ai/saas-frontend-lib` (`AppShellProviders`, the region, content and overlays outlets,
7
- * `AppShellLoadingState`), so the same shape can serve a general layout system for 2D shells — planned, not built —
8
- * without renaming. The 3D half (scene, transitions, rest pose) lives in `Layout3DDefinition`.
9
- */
10
- export var ShellLayoutPlacementKind;
11
- (function (ShellLayoutPlacementKind) {
12
- /** The main container the registration captured (the 2D default, or an application's own), rendered unchanged. */
13
- ShellLayoutPlacementKind["INHERIT"] = "inherit";
14
- /** A container of the layout's own, composed from the shell building blocks. */
15
- ShellLayoutPlacementKind["COMPOSED"] = "composed";
16
- })(ShellLayoutPlacementKind || (ShellLayoutPlacementKind = {}));
17
- /** @wildo_source:part:end presets.3d.layout-contract */
18
- //# sourceMappingURL=shell-layout-placement.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"shell-layout-placement.js","sourceRoot":"","sources":["../../../../src/layout/shell-layout-placement.ts"],"names":[],"mappings":"AAIA,mIAAmI;AACnI;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,wBAKX;AALD,WAAY,wBAAwB;IAClC,kHAAkH;IAClH,+CAAmB,CAAA;IACnB,gFAAgF;IAChF,iDAAqB,CAAA;AACvB,CAAC,EALW,wBAAwB,KAAxB,wBAAwB,QAKnC;AAMD,wDAAwD","sourcesContent":["import type React from 'react';\n\nimport type { AppLayoutPreset_MainContainer_DefaultProps } from '@wildo-ai/saas-frontend-lib';\n\n/** @wildo_source:part:start presets.3d.layout-contract facet:layer:frontend facet:family:layout-3d facet:audience:app-developer */\n/**\n * How a shell layout disposes the regions — the half of a layout with nothing 3D in it.\n *\n * Named for the SHELL, not for 3D, on purpose: a composed placement is an ordinary shell container built from the\n * building blocks of `@wildo-ai/saas-frontend-lib` (`AppShellProviders`, the region, content and overlays outlets,\n * `AppShellLoadingState`), so the same shape can serve a general layout system for 2D shells — planned, not built —\n * without renaming. The 3D half (scene, transitions, rest pose) lives in `Layout3DDefinition`.\n */\nexport enum ShellLayoutPlacementKind {\n /** The main container the registration captured (the 2D default, or an application's own), rendered unchanged. */\n INHERIT = 'inherit',\n /** A container of the layout's own, composed from the shell building blocks. */\n COMPOSED = 'composed',\n}\n\n/** A shell layout's disposal. */\nexport type ShellLayoutPlacement =\n | { kind: ShellLayoutPlacementKind.INHERIT }\n | { kind: ShellLayoutPlacementKind.COMPOSED; container: React.ComponentType<AppLayoutPreset_MainContainer_DefaultProps> };\n/** @wildo_source:part:end presets.3d.layout-contract */\n"]}