@wildo-ai/framework-knowledge 1.1.6 → 1.1.7

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 (25) hide show
  1. package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
  2. package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
  3. package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
  4. package/dist/esm/framework-knowledge.definitions.js +1 -0
  5. package/dist/esm/framework-knowledge.definitions.js.map +1 -1
  6. package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
  7. package/dist/knowledge/manifest.json +7 -7
  8. package/dist/knowledge/references/presets.3d.focal-plane-settings.md +45 -0
  9. package/dist/knowledge/references/presets.3d.layout-contract.md +29 -7
  10. package/dist/knowledge/references/presets.3d.register-layout.md +5 -0
  11. package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -4
  12. package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
  13. package/dist/knowledge/registries/framework-topics.json +11 -1
  14. package/dist/knowledge/registries/playbooks.json +1 -1
  15. package/dist/knowledge/registries/source-tags.json +674 -656
  16. package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -4
  17. package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +8 -4
  18. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -0
  19. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +29 -7
  20. package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +5 -0
  21. package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -4
  22. package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +19 -5
  23. package/dist/knowledge/topic-index.json +41 -5
  24. package/dist/tsconfig.build.tsbuildinfo +1 -1
  25. package/package.json +4 -4
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "artifactVersion": "3",
3
- "frameworkVersion": "1.1.6",
4
- "generatorVersion": "1.1.6",
5
- "generatedAt": "2026-09-30T11:02:50.305Z",
3
+ "frameworkVersion": "1.1.7",
4
+ "generatorVersion": "1.1.7",
5
+ "generatedAt": "2026-09-30T15:35:32.423Z",
6
6
  "packageName": "@wildo-ai/framework-knowledge",
7
- "topicCount": 768,
8
- "referenceFileCount": 650,
7
+ "topicCount": 769,
8
+ "referenceFileCount": 651,
9
9
  "payload": {
10
10
  "topicIndexPath": "topic-index.json",
11
11
  "registriesDirectory": "registries",
@@ -21,13 +21,13 @@
21
21
  "registryName": "source-tags",
22
22
  "filePath": "registries/source-tags.json",
23
23
  "description": "Source-derived tag registry for extracted framework references.",
24
- "entryCount": 650
24
+ "entryCount": 651
25
25
  },
26
26
  {
27
27
  "registryName": "framework-topics",
28
28
  "filePath": "registries/framework-topics.json",
29
29
  "description": "Topic registry derived from extracted framework-knowledge tags.",
30
- "entryCount": 768
30
+ "entryCount": 769
31
31
  },
32
32
  {
33
33
  "registryName": "playbooks",
@@ -0,0 +1,45 @@
1
+ # presets.3d.focal-plane-settings
2
+
3
+ ## Import Origins
4
+
5
+ - `@wildo-ai/presets-components-3d`
6
+
7
+ ## Source Excerpts
8
+
9
+ ### Origin Package: `@wildo-ai/presets-components-3d`
10
+
11
+ ```typescript
12
+ /**
13
+ * The focal plane's numbers (#2049). The defaults are the values Paul settled on in the prototype on 2026-09-30.
14
+ * They reach the stylesheet as CSS custom properties on the layout's root, so every object reads one source.
15
+ */
16
+ export interface FocalPlaneSettings {
17
+ /** The still camera's distance from the focal plane, in CSS pixels: the `perspective()` every object is seen through. */
18
+ cameraDistancePx: number;
19
+ /** How far back one layer steps, in CSS pixels. A pane behind the focused one steps back part of it. */
20
+ layerDepthPx: number;
21
+ /** How long an object takes to travel, in milliseconds. */
22
+ motionMs: number;
23
+ /** How much a receding object dims per layer, 0-1. */
24
+ recedeDim: number;
25
+ /** How much a receding PANE blurs per layer, in CSS pixels (navigation; 0 keeps panes sharp). */
26
+ recedeBlurPx: number;
27
+ /** How much everything blurs behind a MODAL popup (dialog, sheet, command palette), in CSS pixels. */
28
+ modalBlurPx: number;
29
+ /** How opaque a glass window is, 0-1: the rest is the background blurred through it. */
30
+ windowOpacity: number;
31
+ /** How far a shell panel rises toward the camera under the pointer, in CSS pixels. */
32
+ hoverLiftPx: number;
33
+ }
34
+
35
+ export const FOCAL_PLANE_DEFAULTS: FocalPlaneSettings = {
36
+ cameraDistancePx: 1000,
37
+ layerDepthPx: 240,
38
+ motionMs: 580,
39
+ recedeDim: 0.18,
40
+ recedeBlurPx: 0,
41
+ modalBlurPx: 2.5,
42
+ windowOpacity: 0.56,
43
+ hoverLiftPx: 16,
44
+ };
45
+ ```
@@ -64,6 +64,23 @@ export const HEADER_FIRST_LAYOUT_3D: Layout3DDefinition = {
64
64
  },
65
65
  constraints: { requiredShellAppearance: ShellAppearance.CONTINUOUS, restPose: Layout3DRestPose.FLAT },
66
66
  };
67
+ /**
68
+ * The focal plane (#2049): the shell regions, each navigation pane and each popup are glass objects in depth under one
69
+ * still camera. Whatever you work with rests on the focal plane; the rest steps back. No WebGL frame: the depth is in
70
+ * the HTML objects themselves, so the frame styles and frame transitions below are not drawn.
71
+ */
72
+ export const FOCAL_PLANE_LAYOUT_3D: Layout3DDefinition = {
73
+ id: Layout3DId.FOCAL_PLANE,
74
+ placement: { kind: ShellLayoutPlacementKind.COMPOSED, container: FocalPlaneShellContainer },
75
+ scene: { camera: Layout3DCamera.STILL_PERSPECTIVE, frameStyles: INHERIT_FRAME_STYLES },
76
+ transitions: {
77
+ appearance: Layout3DAppearanceTransition.CROSS_FADE,
78
+ navigation: Layout3DFrameChoreography.NONE,
79
+ sidebarResize: Layout3DFrameChoreography.NONE,
80
+ zoneFocus: Layout3DZoneFocusTransition.NONE,
81
+ },
82
+ constraints: { requiredShellAppearance: ShellAppearance.CONTINUOUS, restPose: Layout3DRestPose.FLAT },
83
+ };
67
84
  ```
68
85
 
69
86
  ### Origin Package: `@wildo-ai/presets-components-3d`
@@ -81,22 +98,27 @@ export enum Layout3DId {
81
98
  * panel) sit between them, beside the content. The default disposal is sidebar-first; this one is header-first.
82
99
  */
83
100
  HEADER_FIRST = 'header-first',
101
+ /**
102
+ * The focal plane (#2049): one still perspective camera; the shell regions, each navigation pane and each popup are
103
+ * separate glass objects that travel in depth. Whatever you work with rests on the focal plane at its true size;
104
+ * everything else steps back. Nothing is angled and the camera never moves (Paul, 2026-09-30).
105
+ */
106
+ FOCAL_PLANE = 'focal-plane',
84
107
  }
85
108
 
86
109
  /**
87
- * The cameras the frame renderer supports. The transitions need none beyond this one: every choreography is
88
- * drawn IN the flat frame (elevation, light, rims), so a slab never leaves its region's box.
110
+ * The cameras a 3D layout is seen through. The flat camera's transitions are all drawn IN the flat frame (elevation,
111
+ * light, rims), so a slab never leaves its region's box; the still-perspective camera moves the HTML objects instead.
89
112
  */
90
113
  export enum Layout3DCamera {
91
114
  /** Orthographic, matched 1:1 to CSS pixels: the frame lies flat under the regions, exactly on their boxes. */
92
115
  FLAT_ORTHOGRAPHIC = 'flat-orthographic',
93
116
  /**
94
- * PROTOTYPE (Paul, 2026-09-30: "a real camera aspect", clean spatial). A perspective camera looks at the shell's
95
- * panels placed in space: the content faces it (crisp at rest), side columns stand angled, and the camera MOVES on
96
- * transitions. The panels are the live HTML, in a CSS 3D stage driven by the same camera as the WebGL environment
97
- * around them. Only a placement that builds that stage can use it (`SPATIAL_PROTOTYPE_LAYOUT_3D`).
117
+ * A still perspective camera, in CSS: the HTML objects themselves carry depth, around one shared vanishing point, and
118
+ * no WebGL frame is drawn. The camera never moves; objects do (#2049). Only a placement that stages the objects can
119
+ * be seen through it.
98
120
  */
99
- SPATIAL_PERSPECTIVE = 'spatial-perspective',
121
+ STILL_PERSPECTIVE = 'still-perspective',
100
122
  }
101
123
 
102
124
  /**
@@ -18,6 +18,11 @@ export interface Layout3DOptions {
18
18
  layout?: Layout3DDefinition;
19
19
  /** Frame-style overrides layered over the layout's built-in styles. */
20
20
  frameStyles?: Frame3DStyleOverrides;
21
+ /**
22
+ * Overrides of the focal plane's numbers (camera distance, layer depth, motion, dims, blurs, window opacity), for
23
+ * {@link FOCAL_PLANE_LAYOUT_3D}; each is checked at registration. Omitted, the defaults.
24
+ */
25
+ focalPlane?: Partial<FocalPlaneSettings>;
21
26
  }
22
27
  ```
23
28
 
@@ -150,16 +150,19 @@ export function AppShellProviders({ layout, children }: AppShellProvidersProps):
150
150
  * are TRANSFORMED — a 3D placement. Render it once, inside the providers but OUTSIDE the transformed subtree; the
151
151
  * providers then prefer it to `<main>`. A layout that transforms nothing does not need it.
152
152
  *
153
- * It is a zero-size, untransformed, fixed box at the viewport's origin: an overlay positioned `fixed` resolves
154
- * against the viewport, one positioned `absolute` against the viewport's origin, so floating content lands where its
155
- * trigger is on screen. It carries the stacking tier overlays need above a layout's own layers.
153
+ * It is a zero-size, untransformed box at the shell root's origin (the root fills the viewport), with NO z-index and
154
+ * NOT `position: fixed`: either would make it a stacking context and cap every overlay inside it below anything
155
+ * positioned outside the shell — a consent prompt would paint over the shell's own dialogs (the reordering #1830
156
+ * measured and avoided). So each overlay keeps its own global z-index. An overlay positioned `fixed` still resolves
157
+ * against the viewport (nothing between it and the viewport is transformed), one positioned `absolute` against the
158
+ * root's origin, so floating content lands where its trigger is on screen. The layout's root must be positioned.
156
159
  */
157
160
  export function AppShellOverlayPortalLayer(): React.JSX.Element {
158
161
  const register = useContext(AppShellOverlayLayerTargetContext);
159
162
  if (!register) {
160
163
  throw new Error('AppShellOverlayPortalLayer must be rendered inside <AppShellProviders>, which exposes it as the portal container.');
161
164
  }
162
- return <div ref={register} data-shell-overlay-layer="" className="fixed left-0 top-0 z-50 h-0 w-0" />;
165
+ return <div ref={register} data-shell-overlay-layer="" className="absolute left-0 top-0 h-0 w-0" />;
163
166
  }
164
167
 
165
168
  /**
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "assurance-authority-bases",
3
3
  "metadata": {
4
- "generatedAt": "2026-09-30T11:02:50.305Z",
4
+ "generatedAt": "2026-09-30T15:35:32.423Z",
5
5
  "description": "Compiled portable assurance-authority bases."
6
6
  },
7
7
  "entries": {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "framework-topics",
3
3
  "metadata": {
4
- "generatedAt": "2026-09-30T11:02:50.305Z",
4
+ "generatedAt": "2026-09-30T15:35:32.423Z",
5
5
  "description": "Topic registry derived from extracted framework-knowledge tags."
6
6
  },
7
7
  "entries": {
@@ -2187,6 +2187,16 @@
2187
2187
  "referenceFilePath": "references/platform.config.saas.md",
2188
2188
  "sourceReferenceCount": 1
2189
2189
  },
2190
+ "presets.3d.focal-plane-settings": {
2191
+ "topicId": "presets.3d.focal-plane-settings",
2192
+ "title": "Presets 3d Focal Plane Settings",
2193
+ "categories": [
2194
+ "presets",
2195
+ "presets.3d"
2196
+ ],
2197
+ "referenceFilePath": "references/presets.3d.focal-plane-settings.md",
2198
+ "sourceReferenceCount": 1
2199
+ },
2190
2200
  "presets.3d.frame-style-overrides": {
2191
2201
  "topicId": "presets.3d.frame-style-overrides",
2192
2202
  "title": "Presets 3d Frame Style Overrides",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "playbooks",
3
3
  "metadata": {
4
- "generatedAt": "2026-09-30T11:02:50.305Z",
4
+ "generatedAt": "2026-09-30T15:35:32.423Z",
5
5
  "description": "Compiled meta-workflow playbooks (app-creation methodology definitions)."
6
6
  },
7
7
  "entries": {