package: apigo.cc/web/ui

rules:
  - Read only documents required by the task.
  - Preserve declarative bindings when extending a component.
  - Do not change framework internals unless framework changes are requested.
  - Add or update a regression test for every public behavior change.
  - Before declaring a public API complete, compare its YAML attributes, properties, methods, events, slots, state fields, options, and rules against named test assertions and examples. Every documented item needs coverage; examples must visibly demonstrate the core behavior declaratively.
  - In an ordered value list, the first value is the default.
  - Treat each component test as a concise, declarative usage sample: prepare immutable top-level `const` data before DOM parsing, then bind it directly (for example `$.state.list="users"`). Do not add State or window bridge assignments unless shared mutable state is required.
  - Prefer framework directives ($if, $bind, $onclick, slots) and Bootstrap classes over imperative page setup or custom CSS. Keep test actions limited to assertions and interaction verification.
  - Test pages use full-height flex layouts: the component area fills remaining space and result output is a bounded, internally scrollable region.
  - The outer test console keeps the selected test active and represents pass/fail with a visible status badge; detailed output belongs inside the selected test page.
  - Public source and YAML use the same PascalCase basename (for example `components/List.js` and `components/List.yaml`, `frameworks/State.js` and `frameworks/State.yaml`).

loading:
  example: '<script src="https://cdn.jsdelivr.net/npm/@apigo.cc/ui@1.0.0/ui.js" components="List,AutoForm"></script>'
  rules:
    - Load ui.js in head without async, defer, or type="module".
    - Always write components with every public component used by the page.
    - Do not list utilities or framework dependencies.
    - ui.js loads frameworks/State.js and frameworks/Bootstrap.js beside itself.
    - npm run build writes source modification versions into ui.js; ui.min.js loads matching adjacent .min.js files.

framework:
    - frameworks/State.yaml
    - frameworks/Bootstrap.yaml

components:
    - components/API.yaml
    - components/AutoForm.yaml
    - components/List.yaml
    - components/Modal.yaml
    - components/Dialog.yaml
    - components/Toast.yaml
    - components/Nav.yaml
    - components/Resizer.yaml
    - components/form/DatePicker.yaml
    - components/form/ColorPicker.yaml
    - components/form/IconPicker.yaml
    - components/form/TagsInput.yaml
    - components/DataTable.yaml
    - components/DataChart.yaml

utilities:
    - utilities/HTTP.yaml
    - utilities/VirtualScroll.yaml