mamba-layout 0.45.0 → 0.47.0

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/README.md CHANGED
@@ -2,6 +2,41 @@
2
2
 
3
3
  Shared Mamba Vue layout shell, styles, locale helpers, and a standalone browser layout build.
4
4
 
5
+ ## ⚠️ Important: Required CDN Links and Styles
6
+
7
+ **The following CDN links and styles are REQUIRED and cannot be omitted or modified:**
8
+
9
+ ### Required Links (must be included in `<head>`):
10
+ ```html
11
+ <!-- Icon fonts - DO NOT modify or remove -->
12
+ <link type="text/css" rel="stylesheet" href="https://at.alicdn.com/t/c/font_4614982_ta3fsffdp7.css" />
13
+ <link type="text/css" rel="stylesheet" href="https://at.alicdn.com/t/c/font_4839395_zeh0j9u8an.css" />
14
+
15
+ <!-- Mamba Layout CSS - DO NOT modify or remove -->
16
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/mamba-layout@latest/dist/layout.css" />
17
+ ```
18
+
19
+ ### Required Styles (must be included in `<head>`):
20
+ ```html
21
+ <style>
22
+ html, body, mamba-layout {
23
+ width: 100%;
24
+ height: 100%;
25
+ margin: 0;
26
+ }
27
+ mamba-layout {
28
+ display: block;
29
+ }
30
+ </style>
31
+ ```
32
+
33
+ ### Required Script (must be included before closing `</body>`):
34
+ ```html
35
+ <script src="https://cdn.jsdelivr.net/npm/mamba-layout@latest/dist/layout.global.js"></script>
36
+ ```
37
+
38
+ **⚠️ CRITICAL:** All of the above links and styles are essential for the layout to function correctly. Do not skip, modify, or change any of these URLs.
39
+
5
40
  ### Quick Start
6
41
 
7
42
  ```html
@@ -12,7 +47,8 @@ Shared Mamba Vue layout shell, styles, locale helpers, and a standalone browser
12
47
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
13
48
  <title>My App</title>
14
49
  <link type="text/css" rel="stylesheet" href="https://at.alicdn.com/t/c/font_4614982_ta3fsffdp7.css" />
15
- <link rel="stylesheet" href="./node_modules/mamba-layout/dist/layout.css" />
50
+ <link type="text/css" rel="stylesheet" href="https://at.alicdn.com/t/c/font_4839395_zeh0j9u8an.css" />
51
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/mamba-layout@latest/dist/layout.css" />
16
52
  <style>
17
53
  html, body, mamba-layout {
18
54
  width: 100%;
@@ -94,3 +130,61 @@ To customize dark mode colors for your content:
94
130
  --ui-radius-control /* Border radius for controls */
95
131
  --ui-shadow-card /* Card shadow */
96
132
  ```
133
+
134
+ ### AI Usage Guidelines
135
+
136
+ **⚠️ Important for AI Code Generation:**
137
+
138
+ When using Mamba Layout, **DO NOT** generate the following components as they are already provided by the `<mamba-layout>` element:
139
+
140
+ - ❌ **Sidebar/Navigation Menu** - The layout includes a built-in sidebar with navigation
141
+ - ❌ **Top Header Bar** - The layout includes a built-in header with logo and actions
142
+ - ❌ **Layout Structure** - Do not create flex/grid containers for overall page layout
143
+ - ❌ **Theme Toggle Button** - Dark mode is handled automatically by the layout
144
+
145
+ **What to generate:**
146
+
147
+ - ✅ **Page Content Only** - Place your actual page content inside `<mamba-layout>` tags
148
+ - ✅ **Data Cards** - Statistics cards, metric displays
149
+ - ✅ **Charts & Visualizations** - Data charts, graphs
150
+ - ✅ **Tables** - Data tables, lists
151
+ - ✅ **Forms** - Input forms, filters
152
+ - ✅ **Custom Components** - Any business-specific UI components
153
+
154
+ **Example for AI Prompts:**
155
+
156
+ ```
157
+ Create a dashboard page with statistics cards and charts using Mamba Layout.
158
+ Only generate the page content that goes inside the <mamba-layout> element.
159
+ Do NOT create sidebar, header, or navigation as they are provided by the layout.
160
+ ```
161
+
162
+ **Correct Usage:**
163
+
164
+ ```html
165
+ <mamba-layout>
166
+ <!-- Only your page content here -->
167
+ <div class="dashboard-content">
168
+ <h1>Data Dashboard</h1>
169
+ <div class="stats-grid">...</div>
170
+ <div class="charts">...</div>
171
+ </div>
172
+ </mamba-layout>
173
+ ```
174
+
175
+ **Incorrect Usage (what NOT to do):**
176
+
177
+ ```html
178
+ <mamba-layout>
179
+ <!-- ❌ Don't create your own sidebar -->
180
+ <aside class="sidebar">...</aside>
181
+
182
+ <!-- ❌ Don't create your own header -->
183
+ <header class="top-bar">...</header>
184
+
185
+ <!-- ❌ Don't create layout containers -->
186
+ <div style="display: flex;">
187
+ <main>...</main>
188
+ </div>
189
+ </mamba-layout>
190
+ ```