@wildo-ai/framework-knowledge 1.1.6 → 1.1.8
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.
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +1 -0
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/references/presets.3d.focal-plane-settings.md +45 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +29 -7
- package/dist/knowledge/references/presets.3d.register-layout.md +5 -0
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -4
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +11 -1
- package/dist/knowledge/registries/playbooks.json +1 -1
- package/dist/knowledge/registries/source-tags.json +674 -656
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -4
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +8 -4
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +29 -7
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +5 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -4
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +19 -5
- package/dist/knowledge/topic-index.json +41 -5
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +4 -4
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"artifactVersion": "3",
|
|
3
|
-
"frameworkVersion": "1.1.
|
|
4
|
-
"generatorVersion": "1.1.
|
|
5
|
-
"generatedAt": "2026-09-
|
|
3
|
+
"frameworkVersion": "1.1.8",
|
|
4
|
+
"generatorVersion": "1.1.8",
|
|
5
|
+
"generatedAt": "2026-09-30T18:27:18.976Z",
|
|
6
6
|
"packageName": "@wildo-ai/framework-knowledge",
|
|
7
|
-
"topicCount":
|
|
8
|
-
"referenceFileCount":
|
|
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":
|
|
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":
|
|
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
|
|
88
|
-
*
|
|
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
|
-
*
|
|
95
|
-
*
|
|
96
|
-
*
|
|
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
|
-
|
|
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
|
|
154
|
-
*
|
|
155
|
-
*
|
|
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="
|
|
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": "framework-topics",
|
|
3
3
|
"metadata": {
|
|
4
|
-
"generatedAt": "2026-09-
|
|
4
|
+
"generatedAt": "2026-09-30T18:27:18.976Z",
|
|
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",
|