tosijs-3d 0.7.2 → 0.7.4

package/dist/vector-field.js

@@ -0,0 +1,321 @@
+/*#
+# vector-field
+
+**A coordinate on ONE row.** `vector3d` edits an `{x, y, z}`; `euler3d` edits an
+orientation in degrees. Both are [[widgets3d|Widget3d]]s, so they drop into a
+`panel3d` beside a slider or a button and work identically flat, in-scene and in
+VR.
+
+## Why this exists
+
+Three stacked labelled fields is the obvious way to edit a coordinate and it is
+the reason an inspector panel ends up three times taller than it needs to be.
+Tonio, on the adopter that prompted it: ensemble's UI is "an utter mess right now
+because simple things like XYZ coords take up huge amounts of space".
+
+A coordinate is **one value**, not three, and it should occupy one row. That is
+also why the axis letter is drawn *inside* the row rather than as its own label
+column — a column of `x:` `y:` `z:` labels costs more width than the numbers do,
+and every 3D tool worth using puts the letter against the field.
+
+## Degrees, and why `euler3d` is a separate function
+
+`euler3d` is `vector3d` with the angle rules applied, not a styling variant: it
+**wraps** (181° is −179°, and dragging through the bottom of a turn should not
+stop), and it is **degrees**, which per CLAUDE.md's suffix rule means the bare
+`value` is already degrees and no conversion is implied.
+
+Wrapping is the whole difference and it is not a detail — a wrapping value with a
+`min`/`max` clamp fights you at exactly the angles you most want to scrub
+through.
+
+## Focus and typing
+
+The fields are exposed as `fields` so a
+[[keyboard|fieldGroup]] can wire focus traversal and an on-screen keyboard across
+a whole panel. A vector row is three tab stops, not one, because that is what it
+is to a person filling it in.
+
+## Demo
+
+```js
+import { b3d, b3dLight, panelScene, panel3d, label3d, vector3d, euler3d } from 'tosijs-3d'
+import { elements } from 'tosijs'
+const { div, pre } = elements
+
+const readout = pre({ style: 'margin:8px 16px;color:#8ea;font:12px ui-monospace,monospace' }, '')
+const state = { pos: { x: 1.5, y: 0, z: -3.25 }, rot: { x: 0, y: 45, z: 0 } }
+const show = () => {
+  readout.textContent =
+    `position  ${state.pos.x}, ${state.pos.y}, ${state.pos.z}\n` +
+    `rotation  ${state.rot.x}°, ${state.rot.y}°, ${state.rot.z}°`
+}
+show()
+
+// panel3d takes its widgets as REST ARGS and returns the <svg> itself — it is
+// both the DOM view and the texture source, and `handlePointer` hangs off it.
+const panel = panel3d(
+  { width: 300 },
+  label3d({ text: 'position', muted: true, compact: true }),
+  vector3d({
+    value: state.pos,
+    step: 0.25,
+    scrub: 0.02,
+    onChange: (v) => { state.pos = v; show() },
+  }),
+  label3d({ text: 'rotation (degrees)', muted: true, compact: true }),
+  euler3d({
+    value: state.rot,
+    step: 5,
+    scrub: 0.5,
+    onChange: (v) => { state.rot = v; show() },
+  })
+)
+
+const { plane, sceneCreated } = panelScene({ svg: panel, target: panel, width: 2.4, camera: { radius: 3.2 } })
+const scene = b3d({ style: 'border-radius:8px;overflow:hidden', sceneCreated }, b3dLight({ intensity: 1 }), plane)
+
+preview.append(
+  div(
+    { style: 'display:flex;flex-direction:column;height:100%;background:#0c0e14' },
+    div(
+      { style: 'display:flex;gap:24px;flex:1;min-height:0;padding:16px 16px 4px' },
+      div({ style: 'color:#9ab;font:12px system-ui;display:flex;flex-direction:column;gap:6px;flex:1;min-width:0' }, 'DOM — drag a number to scrub', panel),
+      div({ style: 'color:#9ab;font:12px system-ui;display:flex;flex-direction:column;gap:6px;flex:1;min-width:0' }, '3D texture — same widget', scene)
+    ),
+    readout
+  )
+)
+```
+```css
+.preview {
+  height: 100%;
+}
+```
+*/
+/*{ "parent": "UI", "order": 250 }*/
+import { svgElements } from 'tosijs';
+import { inputField } from './keyboard';
+import { w3dTheme } from './w3d-theme';
+const { g, text } = svgElements;
+/** Trim to `precision`, then drop trailing zeros: `1.500` reads as `1.5`. */
+function show(n, precision) {
+    if (!Number.isFinite(n))
+        return '0';
+    const s = n.toFixed(precision);
+    return s.includes('.') ? s.replace(/\.?0+$/, '') : s;
+}
+/**
+ * Wrap into `(-180, 180]`.
+ *
+ * Exported because it is the entire behavioural difference between `euler3d` and
+ * `vector3d`, and a pure function with a stated range is worth pinning in a test
+ * rather than trusting a modulo written from memory. JS `%` keeps the sign of the
+ * dividend, so the naive form returns −180 for +180 and disagrees at exactly the
+ * boundary you are most likely to hit by dragging.
+ */
+export function wrapDegrees(deg) {
+    if (!Number.isFinite(deg))
+        return 0;
+    const wrapped = ((((deg + 180) % 360) + 360) % 360) - 180;
+    // The half-open end: +180 is the same orientation as −180, and a control that
+    // flips sign as you cross the back of a turn reads as a glitch.
+    return wrapped === -180 ? 180 : wrapped;
+}
+/** Shared builder — `vector3d` and `euler3d` differ only in how a value settles. */
+function coordinateRow(config, settle) {
+    const axes = config.axes ?? ['x', 'y', 'z'];
+    const precision = config.precision ?? 3;
+    const gap = config.gap ?? Math.max(4, Math.round(w3dTheme.spacing * 0.5));
+    const fontSize = config.fontSize ?? w3dTheme.fontSize;
+    const current = { ...(config.value ?? { x: 0, y: 0, z: 0 }) };
+    const el = g();
+    const keys = ['x', 'y', 'z'];
+    /*
+    The axis letter is drawn HERE, not inside the field.
+  
+    It has to sit in the row's own coordinate space so it can be positioned against
+    the field it labels, and keeping it out of `inputField` means the field stays
+    the general-purpose control it already is — a vector row is a composition, not
+    a new kind of field.
+    */
+    const letters = axes.map((a) => text({
+        'font-family': w3dTheme.fontFamily,
+        'font-size': String(Math.round(fontSize * 0.85)),
+        fill: w3dTheme.muted,
+    }, a));
+    const fields = keys.map((key, i) => inputField({
+        type: 'number',
+        value: show(current[key], precision),
+        fontSize,
+        height: config.height,
+        step: config.step,
+        scrub: config.scrub,
+        // A wrapping value must NOT be clamped — see `euler3d`. The caller's
+        // min/max only reaches a non-wrapping row.
+        min: settle === identity ? config.min : undefined,
+        max: settle === identity ? config.max : undefined,
+        onChange: (raw) => {
+            const n = Number(raw);
+            if (!Number.isFinite(n))
+                return;
+            const v = settle(n);
+            if (v === current[key])
+                return;
+            current[key] = v;
+            // Write the settled value back when it differs from what was typed, so
+            // `190` visibly becomes `-170` rather than being silently reinterpreted.
+            if (v !== n)
+                fields[i].setValue(show(v, precision));
+            config.onChange?.({ ...current });
+        },
+    }));
+    const wraps = fields.map((f) => {
+        const wrap = g();
+        wrap.appendChild(f.el);
+        el.appendChild(wrap);
+        return wrap;
+    });
+    letters.forEach((l) => el.appendChild(l));
+    // Geometry from the last layout, so pointer routing uses exactly what was
+    // drawn — the same rule `row3d` follows, and for the same reason.
+    let cols = [];
+    let rowHeight = 0;
+    /*
+    WHICH field is focused — the row is three tab stops, not one.
+  
+    The host tracks focus per WIDGET, so it can only tell this row "you are
+    focused". Forwarding that to all three fields lit all three carets at once
+    (six on a panel with a position and a rotation), and since the caret IS the
+    focus indicator, that says focus is everywhere, which is the same as saying
+    nothing. So the row keeps its own index and reflects the host's state onto
+    exactly one field.
+    */
+    let active = 0;
+    const at = (x, y) => {
+        for (let i = 0; i < cols.length; i++) {
+            const c = cols[i];
+            if (x >= c.x && x <= c.x + c.width)
+                return { i, lx: x - c.x, ly: y };
+        }
+        return null;
+    };
+    return {
+        el,
+        layout(width) {
+            const letterW = Math.round(fontSize * 0.7);
+            const cell = (width - gap * 2) / 3;
+            const fieldW = Math.max(8, cell - letterW);
+            cols = [];
+            rowHeight = 0;
+            keys.forEach((_, i) => {
+                const cellX = i * (cell + gap);
+                const h = fields[i].layout(fieldW);
+                rowHeight = Math.max(rowHeight, h);
+                cols.push({ x: cellX + letterW, width: fieldW });
+                wraps[i].setAttribute('transform', `translate(${cellX + letterW}, 0)`);
+            });
+            letters.forEach((l, i) => {
+                l.setAttribute('x', String(i * (cell + gap)));
+                // Optical centring against the field, which owns its own height.
+                l.setAttribute('y', String(Math.round(rowHeight / 2 + fontSize * 0.32)));
+            });
+            return rowHeight;
+        },
+        handle(kind, x, y) {
+            const hit = at(x, y);
+            if (hit == null)
+                return;
+            // A press is what moves focus between the fields, exactly as clicking one
+            // input in a form row does.
+            if (kind === 'down')
+                active = hit.i;
+            fields[hit.i].handle?.(kind, hit.lx, hit.ly);
+        },
+        hitTest(x, y) {
+            const hit = at(x, y);
+            if (hit == null)
+                return false;
+            const f = fields[hit.i];
+            return f.hitTest ? f.hitTest(hit.lx, hit.ly) : f.handle != null;
+        },
+        setState(state) {
+            fields.forEach((f, i) => {
+                const mine = i === active;
+                f.setState?.({
+                    hovered: state.hovered && mine,
+                    pressed: state.pressed && mine,
+                    focused: state.focused && mine,
+                });
+            });
+        },
+        /*
+        Left/right walks the axes; up/down escapes to the next row.
+    
+        Returning `false` is what hands focus back to the host, so a D-pad user
+        traverses x → y → z and then leaves — rather than being trapped in a row or
+        skipping two thirds of it. Same escape contract as `BoxChild.focusMove`.
+        */
+        focusMove(dx, dy) {
+            if (dy !== 0)
+                return false;
+            if (dx === 0)
+                return true;
+            // Entry from the host seeds at the edge it arrived from, so coming back
+            // leftwards lands on z rather than on x.
+            const next = active + (dx > 0 ? 1 : -1);
+            if (next < 0 || next > 2)
+                return false;
+            active = next;
+            return true;
+        },
+        focusClear() {
+            active = 0;
+            for (const f of fields) {
+                f.setState?.({ hovered: false, pressed: false, focused: false });
+            }
+        },
+        get value() {
+            return { ...current };
+        },
+        setValue(v) {
+            keys.forEach((key, i) => {
+                const n = settle(v[key] ?? 0);
+                current[key] = n;
+                fields[i].setValue(show(n, precision));
+            });
+        },
+        get fields() {
+            return fields;
+        },
+    };
+}
+/** Identity settle — a plain coordinate clamps (if asked) but never wraps. */
+function identity(n) {
+    return n;
+}
+/**
+ * Edit an `{x, y, z}` on one row.
+ *
+ * ```js
+ * vector3d({ value: { x: 1, y: 0, z: -3 }, step: 0.25, scrub: 0.02, onChange: (v) => …  })
+ * ```
+ */
+export function vector3d(config = {}) {
+    return coordinateRow(config, identity);
+}
+/**
+ * Edit an orientation on one row, in **degrees**.
+ *
+ * Values wrap into `(-180, 180]` rather than clamping — see `wrapDegrees`. Per
+ * the project's angle rule, the bare `value` is already degrees: there is no
+ * `Deg` sibling because there is no radian form to disambiguate from.
+ *
+ * ```js
+ * euler3d({ value: { x: 0, y: 45, z: 0 }, step: 5, scrub: 0.5, onChange: (v) => …  })
+ * ```
+ */
+export function euler3d(config = {}) {
+    return coordinateRow(config, wrapDegrees);
+}
+//# sourceMappingURL=vector-field.js.map

package/dist/vector-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-field.js","sourceRoot":"","sources":["../src/vector-field.ts"],"names":[],"mappings":"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"}

package/dist/virtual-gamepad.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"virtual-gamepad.d.ts","sourceRoot":"","sources":["../src/virtual-gamepad.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"virtual-gamepad.d.ts","sourceRoot":"","sources":["../src/virtual-gamepad.ts"],"names":[],"mappings":"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"}

package/dist/virtual-gamepad.js

@@ -266,17 +266,52 @@ export const STICK_UP_IS_POSITIVE = true;
 // --- Built-in mapping presets ---
 export function bipedMapping(pad, _dt) {
     const input = emptyInput();
+    /*
+    GTA V LAYOUT: the left stick MOVES, the right stick TURNS.
+  
+    The biped was tank-controlled — left stick X turned the body — which nobody
+    has muscle memory for any more, and it left the right stick doing camera work
+    that could not steer. Turning the BODY with the right stick makes swim
+    direction and body facing ONE thing rather than two that can disagree, which
+    is what made look-directed swimming fiddly to control.
+  
+    Left stick X becomes strafe, which is worth having on land regardless.
+    */
     input.forward = pad.leftStickY;
-    input.turn = pad.leftStickX;
-    input.jump = pad.buttonA;
+    input.strafe = pad.leftStickX;
+    input.turn = pad.rightStickX;
     // Right trigger, not left bumper: movement is the LEFT stick, so a left-hand
     // sprint modifier fights the left thumb. Right trigger frees that up.
     input.sprint = pad.rightTrigger;
     input.interact = pad.buttonX;
     input.shoot = pad.buttonB;
-    input.cameraZoom = pad.rightStickY;
-    input.cameraPeek = pad.rightStickX; // temporary look left/right (snaps to centre)
-    input.sneak = pad.dpadDown;
+    /*
+    Right stick Y is PITCH — the camera's, and while swimming the body's. There is
+    no separate camera yaw, because X turns the body and the camera follows it, so
+    the view cannot be left pointing somewhere the character is not.
+  
+    It used to be zoom (Y) and a snap-back peek (X), which meant a character had
+    no aim at all: nothing to point at a thing, and — once swimming arrived —
+    nothing to point DOWN with. Zoom moved to the d-pad, which sneak vacated.
+    */
+    input.lookY = pad.rightStickY;
+    // Signed: up zooms out, down zooms in. It was wrapped in `Math.max(0, …)`,
+    // which silently discarded the entire zoom-in half — down produced 0, not −1,
+    // so the camera could only ever retreat. Tonio: "d-pad up zooms out and I
+    // can't zoom in."
+    input.cameraZoom = pad.dpadUp - pad.dpadDown;
+    /*
+    BUMPERS for the two vertical verbs: left bumper sneak, right bumper jump.
+  
+    `buttonA` deliberately does NOT jump, though it did originally and I kept it
+    as an alias on the grounds that A-to-jump is conventional. Tonio's call, and
+    the better one: the face buttons are **reserved for actions**, because they
+    are primary and secondary fire on the aircraft and a control vocabulary that
+    changes meaning per vehicle is a vocabulary you have to relearn. A convention
+    borrowed from other games is worth less than consistency within this one.
+    */
+    input.jump = pad.rightBumper;
+    input.sneak = pad.leftBumper;
     // Camera toggle: glass-gamepad view button, or Y (reachable on a controller).
     input.view = Math.max(pad.view, pad.buttonY);
     return input;
@@ -285,13 +320,15 @@ export const bipedMappingDescriptor = {
     map: bipedMapping,
     labels: {
         leftStickY: 'move',
-        leftStickX: 'turn',
-        buttonA: 'jump',
+        leftStickX: 'strafe',
+        rightStickX: 'turn',
+        rightBumper: 'jump',
+        leftBumper: 'sneak',
         rightTrigger: 'sprint',
         buttonX: 'interact',
         buttonB: 'shoot',
-        rightStickY: 'camera',
-        dpadDown: 'sneak',
+        rightStickY: 'pitch',
+        dpadUp: 'zoom',
     },
 };
 export function carMapping(pad, _dt) {

package/dist/virtual-gamepad.js.map

@@ -1 +1 @@
-{"version":3,"file":"virtual-gamepad.js","sourceRoot":"","sources":["../src/virtual-gamepad.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"virtual-gamepad.js","sourceRoot":"","sources":["../src/virtual-gamepad.ts"],"names":[],"mappings":"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"}

package/dist/w3d-theme.d.ts

@@ -6,22 +6,120 @@ export declare const cssVar: (name: string, fallback: string) => string;
  * common destructure.
  */
 export declare const w3dTheme: {
-    readonly fontSize: number;
-    readonly fontFamily: string;
-    readonly text: string;
-    readonly muted: string;
-    readonly headingWeight: string;
-    readonly textWeight: string;
-    readonly panelBg: string;
-    readonly buttonBg: string;
-    readonly buttonHover: string;
-    readonly buttonActive: string;
-    readonly track: string;
-    readonly accent: string;
-    readonly rowBg: string;
-    readonly rowHover: string;
-    readonly info: string;
-    readonly warning: string;
-    readonly error: string;
+    fontSize: number;
+    fontFamily: string;
+    text: string;
+    muted: string;
+    headingWeight: string;
+    textWeight: string;
+    panelBg: string;
+    buttonBg: string;
+    buttonHover: string;
+    buttonActive: string;
+    /**
+     * Label colour while a clickable is HELD or selected.
+     *
+     * Separate from `text` because the background under it has changed: a theme
+     * whose `buttonActive` is a strong accent needs a light label on it, and one
+     * whose active state is a subtle tint needs the ordinary text colour. Baking
+     * that choice into `text` would force every label in the panel to follow a
+     * decision that is only about buttons.
+     */
+    buttonActiveText: string;
+    track: string;
+    accent: string;
+    rowBg: string;
+    rowHover: string;
+    info: string;
+    warning: string;
+    error: string;
+    focus: string;
+    selectedBg: string;
+    disabledBg: string;
+    disabledText: string;
+    strokeWidth: number;
+    /**
+     * Padding INSIDE a control — what makes a button or a field feel roomy or
+     * cramped. Distinct from `spacing`, which is the gap BETWEEN them: a dense
+     * inspector wants small padding and comfortable spacing, and a touch UI
+     * usually wants the opposite, so one number cannot serve both.
+     *
+     * Row height derives from it (with `fontSize` and `lineHeight`), so raising
+     * it makes controls taller as well as wider — which is what "more spacious"
+     * means and what a single width-only padding fails to deliver.
+     */
+    padding: number;
+    roundedRadius: number;
+    spacing: number;
+    lineHeight: number;
+    codeFontFamily: string;
+    codeFontWeight: string;
+    overlay: string;
+    divider: string;
+    /** Placeholder and caret — the two field colours that were literals. */
+    placeholder: string;
+    caret: string;
 };
+export type W3dTheme = typeof w3dTheme;
+/**
+ * **Override the theme at runtime.**
+ *
+ * The `--w3d-*` variables are read ONCE at load, and deliberately so: an SVG
+ * destined to be rasterised onto a texture is serialised away from the
+ * document, where `var(--w3d-text)` resolves against nothing and paints black.
+ * Baking literals is what makes the same widget work in the DOM and in a scene.
+ *
+ * The cost of that is no live cascade — restyling the page after load changes
+ * nothing. This is the way back in, and it is what a theme editor (or the demo
+ * below) needs.
+ *
+ * **Widgets read the theme when they are BUILT**, so existing ones do not
+ * repaint. Rebuild them after calling this. That is a real constraint rather
+ * than an oversight: a widget that re-read its colours every frame would have
+ * to re-resolve them per rasterised texture too, which is the cost this design
+ * exists to avoid.
+ */
+export declare function setW3dTheme(partial: Partial<W3dTheme>): void;
+/**
+ * **Build something under a different theme**, then put the old one back.
+ *
+ * The theme is global — one table, read by every widget — and that is usually
+ * what you want: a palette exists so a UI looks like one UI. But an inspector
+ * beside a toolbar, a warning panel, or a preview of a theme you are editing
+ * all want to differ from their surroundings without becoming a second design
+ * system.
+ *
+ * This works because of the property that makes the global table safe in the
+ * first place: **a widget reads the theme when it is BUILT.** So a scope is
+ * just "set, build, restore" — no plumbing through every widget, no second
+ * table, and a widget built inside keeps its colours forever after, because
+ * they were baked into its attributes.
+ *
+ * ```js
+ * // `setW3dTheme` is the DEFAULT; this is the override for one panel.
+ * const warning = withTheme({ panelBg: '#6b2323', text: '#ffd7d7' }, () =>
+ *   panel3d({ width: 300 }, label3d({ text: 'Careful' })))
+ * ```
+ *
+ * **Why this rather than `panel3d({ theme })`.** A panel's children are
+ * constructed as ARGUMENTS, so they are already built by the time the panel
+ * function runs — an option on the panel could only re-colour the panel's own
+ * background while its contents kept the default, which is worse than not
+ * offering it. Wrapping the construction puts the children inside the scope,
+ * because that is when they evaluate.
+ *
+ * The unit that gets its own palette is therefore a panel, not a widget: you
+ * theme a thing you build, and a panel is the thing you build.
+ *
+ * **Synchronous only, and deliberately not enforced.** `build` must not await:
+ * the restore happens when it returns, so an async build would leak its theme
+ * into whatever ran next. Enforcing that would mean rejecting a function that
+ * merely returns a promise for an unrelated reason, and the honest constraint
+ * is "build synchronously", which is what widget construction already is.
+ *
+ * Only the keys you override are saved and restored, so nested scopes compose
+ * and an unrelated `setW3dTheme` from elsewhere is not clobbered on the way
+ * out.
+ */
+export declare function withTheme<T>(partial: Partial<W3dTheme>, build: () => T): T;
 //# sourceMappingURL=w3d-theme.d.ts.map

package/dist/w3d-theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"w3d-theme.d.ts","sourceRoot":"","sources":["../src/w3d-theme.ts"],"names":[],"mappings":"AAwBA,+EAA+E;AAC/E,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,EAAE,UAAU,MAAM,KAAG,MAGvD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAgCX,CAAA"}
+{"version":3,"file":"w3d-theme.d.ts","sourceRoot":"","sources":["../src/w3d-theme.ts"],"names":[],"mappings":"AAwJA,+EAA+E;AAC/E,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,EAAE,UAAU,MAAM,KAAG,MAGvD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;IAwBnB;;;;;;;;OAQG;;;;;;;;;;;;;;IAuDH;;;;;;;;;OASG;;;;;;;;;IA0BH,wEAAwE;;;CAGzE,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAA;AAsBtC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAE5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAc1E"}