create-caspian-app 0.4.0-rc.7 → 0.4.0-rc.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.
Files changed (2) hide show
  1. package/dist/AGENTS.md +1 -143
  2. package/package.json +1 -1
package/dist/AGENTS.md CHANGED
@@ -132,146 +132,4 @@ Before merging doc or runtime changes:
132
132
  1. Compare the claim or behavior against `main.py`, `src/lib/**`, and `.venv/Lib/site-packages/casp/**`.
133
133
  2. Update the matching packaged doc in `node_modules/caspian-utils/dist/docs/` if the running behavior changed.
134
134
  3. Update `.github/copilot-instructions.md` if the repo-wide implementation rules changed.
135
- 4. Update this file if the decision order, task routing, workspace clarifications, or packaged-doc maintenance rules changed.
136
-
137
- <!-- maddex:start -->
138
- # Maddex AI Context
139
-
140
- This project uses `maddex` to generate reusable Python UI component modules.
141
-
142
- - Config file: maddex.json
143
- - Maddex instructions file: .github/instructions/maddex.instructions.md
144
- - Components directory: src/lib/maddex
145
- - Configured Python source path: src/lib/maddex
146
- - Suggested module path: src.lib.maddex
147
- - Tailwind CSS file: src/app/globals.css
148
- - Icon library: ppicons
149
- - Installed component count: 57
150
- - Installed component inventory and project metadata: `maddex.json` (under `manifest`)
151
-
152
- ## Installing Components
153
-
154
- When a requested UI component does not exist yet, install it with `maddex` instead of hand-writing generated component modules.
155
-
156
- - Add one component: `npx maddex add <component-name>`
157
- - Add multiple components: `npx maddex add <component-a> <component-b>`
158
- - Add the full catalogue: `npx maddex add --all`
159
- - Refresh installed components: `npx maddex update`
160
-
161
- ## Discovering Available Components
162
-
163
- Use the Maddex catalogue API to find component names before installing them.
164
-
165
- - Fetch all available components: `GET https://maddex.tsnc.tech/cli?component=all`
166
- - Fetch one component by name: `GET https://maddex.tsnc.tech/cli?component=Button`
167
- - The `component=all` endpoint returns a JSON array of component names.
168
- - The single-component endpoint may return a `files` array for multi-file components or a legacy `content` string for a single Python module.
169
-
170
- Single component response example:
171
-
172
- ```json
173
- {
174
- "name": "Button",
175
- "files": [
176
- {
177
- "name": "Button.py",
178
- "content": "class Button:\n ...generated Python source..."
179
- },
180
- {
181
- "name": "Button.html",
182
- "content": "<button>...generated template...</button>"
183
- }
184
- ]
185
- }
186
- ```
187
-
188
- ## Importing and Using Components
189
-
190
- Use the installed Python module as the source for template `@import` comments, then copy the live docs example for the component you are rendering.
191
-
192
- - Adjust the relative `@import` path to match the current file location.
193
- - Maddex docs URLs use kebab-case component names such as `https://maddex.tsnc.tech/docs/button` and `https://maddex.tsnc.tech/docs/alert-dialog`.
194
- - For any installed component, derive the docs page as `https://maddex.tsnc.tech/docs/<component-kebab-name>`.
195
-
196
- Button example:
197
-
198
- ```html
199
- <!-- @import { Button } from ../../../../lib/maddex/Button.py -->
200
-
201
- <div class="flex w-full flex-wrap items-center justify-center gap-3">
202
- <x-button>Default</x-button>
203
- <x-button variant="secondary">Secondary</x-button>
204
- <x-button variant="destructive">Destructive</x-button>
205
- <x-button variant="outline">Outline</x-button>
206
- <x-button variant="ghost">Ghost</x-button>
207
- <x-button variant="link">Link</x-button>
208
- </div>
209
- ```
210
-
211
- ## Installed Components
212
-
213
- - Accordion: `src/lib/maddex/Accordion.py` (docs: `https://maddex.tsnc.tech/docs/accordion`)
214
- - Alert: `src/lib/maddex/Alert.py` (docs: `https://maddex.tsnc.tech/docs/alert`)
215
- - AlertDialog: `src/lib/maddex/AlertDialog.py` (docs: `https://maddex.tsnc.tech/docs/alert-dialog`)
216
- - AspectRatio: `src/lib/maddex/AspectRatio.py` (docs: `https://maddex.tsnc.tech/docs/aspect-ratio`)
217
- - Avatar: `src/lib/maddex/Avatar.py` (docs: `https://maddex.tsnc.tech/docs/avatar`)
218
- - Badge: `src/lib/maddex/Badge.py` (docs: `https://maddex.tsnc.tech/docs/badge`)
219
- - Breadcrumb: `src/lib/maddex/Breadcrumb.py` (docs: `https://maddex.tsnc.tech/docs/breadcrumb`)
220
- - Button: `src/lib/maddex/Button.py` (docs: `https://maddex.tsnc.tech/docs/button`)
221
- - ButtonGroup: `src/lib/maddex/ButtonGroup.py` (docs: `https://maddex.tsnc.tech/docs/button-group`)
222
- - Calendar: `src/lib/maddex/Calendar.py` (docs: `https://maddex.tsnc.tech/docs/calendar`)
223
- - Card: `src/lib/maddex/Card.py` (docs: `https://maddex.tsnc.tech/docs/card`)
224
- - Carousel: `src/lib/maddex/Carousel.py` (docs: `https://maddex.tsnc.tech/docs/carousel`)
225
- - Chart: `src/lib/maddex/Chart.py` (docs: `https://maddex.tsnc.tech/docs/chart`)
226
- - Checkbox: `src/lib/maddex/Checkbox.py` (docs: `https://maddex.tsnc.tech/docs/checkbox`)
227
- - Collapsible: `src/lib/maddex/Collapsible.py` (docs: `https://maddex.tsnc.tech/docs/collapsible`)
228
- - Combobox: `src/lib/maddex/Combobox.py` (docs: `https://maddex.tsnc.tech/docs/combobox`)
229
- - Command: `src/lib/maddex/Command.py` (docs: `https://maddex.tsnc.tech/docs/command`)
230
- - ContextMenu: `src/lib/maddex/ContextMenu.py` (docs: `https://maddex.tsnc.tech/docs/context-menu`)
231
- - DataTable: `src/lib/maddex/DataTable.py` (docs: `https://maddex.tsnc.tech/docs/data-table`)
232
- - DatePicker: `src/lib/maddex/DatePicker.py` (docs: `https://maddex.tsnc.tech/docs/date-picker`)
233
- - Dialog: `src/lib/maddex/Dialog.py` (docs: `https://maddex.tsnc.tech/docs/dialog`)
234
- - Drawer: `src/lib/maddex/Drawer.py` (docs: `https://maddex.tsnc.tech/docs/drawer`)
235
- - DropdownMenu: `src/lib/maddex/DropdownMenu.py` (docs: `https://maddex.tsnc.tech/docs/dropdown-menu`)
236
- - Editor: `src/lib/maddex/Editor.py` (docs: `https://maddex.tsnc.tech/docs/editor`)
237
- - Empty: `src/lib/maddex/Empty.py` (docs: `https://maddex.tsnc.tech/docs/empty`)
238
- - Field: `src/lib/maddex/Field.py` (docs: `https://maddex.tsnc.tech/docs/field`)
239
- - HoverCard: `src/lib/maddex/HoverCard.py` (docs: `https://maddex.tsnc.tech/docs/hover-card`)
240
- - Input: `src/lib/maddex/Input.py` (docs: `https://maddex.tsnc.tech/docs/input`)
241
- - InputGroup: `src/lib/maddex/InputGroup.py` (docs: `https://maddex.tsnc.tech/docs/input-group`)
242
- - InputOTP: `src/lib/maddex/InputOTP.py` (docs: `https://maddex.tsnc.tech/docs/input-otp`)
243
- - Item: `src/lib/maddex/Item.py` (docs: `https://maddex.tsnc.tech/docs/item`)
244
- - Kbd: `src/lib/maddex/Kbd.py` (docs: `https://maddex.tsnc.tech/docs/kbd`)
245
- - Label: `src/lib/maddex/Label.py` (docs: `https://maddex.tsnc.tech/docs/label`)
246
- - Menubar: `src/lib/maddex/Menubar.py` (docs: `https://maddex.tsnc.tech/docs/menubar`)
247
- - NavigationMenu: `src/lib/maddex/NavigationMenu.py` (docs: `https://maddex.tsnc.tech/docs/navigation-menu`)
248
- - Popover: `src/lib/maddex/Popover.py` (docs: `https://maddex.tsnc.tech/docs/popover`)
249
- - Portal: `src/lib/maddex/Portal.py` (docs: `https://maddex.tsnc.tech/docs/portal`)
250
- - Radio: `src/lib/maddex/Radio.py` (docs: `https://maddex.tsnc.tech/docs/radio`)
251
- - RadioGroup: `src/lib/maddex/RadioGroup.py` (docs: `https://maddex.tsnc.tech/docs/radio-group`)
252
- - Resizable: `src/lib/maddex/Resizable.py` (docs: `https://maddex.tsnc.tech/docs/resizable`)
253
- - ScrollArea: `src/lib/maddex/ScrollArea.py` (docs: `https://maddex.tsnc.tech/docs/scroll-area`)
254
- - Select: `src/lib/maddex/Select.py` (docs: `https://maddex.tsnc.tech/docs/select`)
255
- - Separator: `src/lib/maddex/Separator.py` (docs: `https://maddex.tsnc.tech/docs/separator`)
256
- - Sheet: `src/lib/maddex/Sheet.py` (docs: `https://maddex.tsnc.tech/docs/sheet`)
257
- - Sidebar: `src/lib/maddex/Sidebar.py` (docs: `https://maddex.tsnc.tech/docs/sidebar`)
258
- - Skeleton: `src/lib/maddex/Skeleton.py` (docs: `https://maddex.tsnc.tech/docs/skeleton`)
259
- - Slider: `src/lib/maddex/Slider.py` (docs: `https://maddex.tsnc.tech/docs/slider`)
260
- - Slot: `src/lib/maddex/Slot.py` (docs: `https://maddex.tsnc.tech/docs/slot`)
261
- - Switch: `src/lib/maddex/Switch.py` (docs: `https://maddex.tsnc.tech/docs/switch`)
262
- - Table: `src/lib/maddex/Table.py` (docs: `https://maddex.tsnc.tech/docs/table`)
263
- - Tabs: `src/lib/maddex/Tabs.py` (docs: `https://maddex.tsnc.tech/docs/tabs`)
264
- - Textarea: `src/lib/maddex/Textarea.py` (docs: `https://maddex.tsnc.tech/docs/textarea`)
265
- - Toast: `src/lib/maddex/Toast.py` (docs: `https://maddex.tsnc.tech/docs/toast`)
266
- - Toggle: `src/lib/maddex/Toggle.py` (docs: `https://maddex.tsnc.tech/docs/toggle`)
267
- - ToggleGroup: `src/lib/maddex/ToggleGroup.py` (docs: `https://maddex.tsnc.tech/docs/toggle-group`)
268
- - Tooltip: `src/lib/maddex/Tooltip.py` (docs: `https://maddex.tsnc.tech/docs/tooltip`)
269
- - utils: `src/lib/maddex/utils.py` (docs: `https://maddex.tsnc.tech/docs/utils`)
270
-
271
- ## Usage Notes
272
-
273
- - Generated Python files follow this pattern: `src/lib/maddex/<ComponentName>.py`
274
- - Prefer the configured module path `src.lib.maddex` when the host project exposes that package path for imports.
275
- - Some components may include sidecar template or asset files next to the main Python module.
276
- - Manual content outside this managed block is preserved.
277
- <!-- maddex:end -->
135
+ 4. Update this file if the decision order, task routing, workspace clarifications, or packaged-doc maintenance rules changed.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-caspian-app",
3
- "version": "0.4.0-rc.7",
3
+ "version": "0.4.0-rc.8",
4
4
  "description": "Scaffold a new Caspian project (FastAPI-powered reactive Python framework).",
5
5
  "main": "dist/index.js",
6
6
  "type": "module",