@aastrika/ai-elements 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -6,6 +6,151 @@ see at a glance what to expect when they upgrade.
 Versions follow semver: a **minor** adds something, a **patch** fixes something,
 and neither removes anything a host was using.
 
+## 0.7.0
+
+A screen redesign rather than API: the tags, attributes and events are
+unchanged, so a host upgrades without touching a line.
+
+**Added**
+- Hear a voice before choosing it: the Voice picker (setup, and "Change the plan
+  with AI") is a menu of voices grouped by language, each with a play button
+  that speaks a short sample in the video's language without choosing it.
+  Needs the service's new `GET /v1/studio/list-voices/:voiceId/sample?lang=` — on an
+  older service the play buttons hide themselves and choosing works as before
+
+**Changed**
+- Clearer actions across the three screens: one way to change a finished video
+  (Make changes, beside it); Assessment's first tab is "Create assessment", as
+  Studio's is "Create video"; the usage list says Watch and Excel, as the
+  assessment list does; "Regenerate plan" says it starts over; costs always
+  show two decimals ("$0.50", not "$0.5")
+- Usage & spend has the other screens' look: glass figure tiles with the spend
+  split, a "Showing" picker, pill tabs, style names in colour instead of ids,
+  coloured status tags, creator initials, and quieter row actions pinned in
+  view on narrow screens
+- The Usage "Showing" picker is a menu of people with what each made and
+  spent, instead of a plain dropdown; it works by keyboard and closes on
+  Escape or a click outside
+- A video opened from My videos can be changed again: Make changes reopens its
+  scene plan, and Regenerate redoes only the scenes that changed
+- The render's technical log is hidden unless the host sets
+  `technical-log="on"` (new, optional attribute; default off)
+- Content Studio has the assessment screen's layout and look: Create video and
+  My videos tabs, a five-step stepper, the form beside a sticky summary with the
+  one action, style cards with a picture of each style, and the cost shown
+  beside the scene plan before anything is spent
+- Generate scene plan opens the plan screen at once, so the wait shows where the
+  scenes will appear; Edit setup reopens the form over the plan
+- Content Studio caps at 1600px and centres, as the assessment screen does
+- Content Studio offers the same languages as the assessment screen, read from
+  the service's one shared list (`GET /v1/quiz/languages`); if that list cannot
+  be fetched it keeps Hindi, English, Kannada and Telugu
+- Content Studio uses the assessment screen's compact type scale, so titles,
+  labels, buttons and the stepper are the same size on both
+- Content Studio's plan: a compact planning card with five named stages; each
+  scene shows its picture and title overlay, its words, and the picture's
+  description side by side
+- Content Studio's render shows the five stages on one line that fills as it
+  moves, what is being made beside the progress, and a tile per scene (voiced,
+  drawn, being made)
+- My videos uses the assessment list's layout — a search, then one row a video
+  with its style's picture as a thumbnail — and each row can show the settings
+  the video was made with (material, style, language, voice, format, scenes,
+  references, cost and the brief)
+- A finished video offers New video at the top of the screen, beside Edit setup
+
+**Fixed**
+- The creator's name now reaches the service: `configure({ creatorName })` was
+  dropped inside the elements, so every row was saved with no name and the
+  usage report showed the id instead
+- My videos showed the uploaded file's name instead of the video's title
+- Create video, after watching a finished or past video, kept showing that
+  video instead of opening a fresh form
+- The render no longer sits on "Drawing scenes · 11 of 11" while the video is
+  being joined; it moves to "Putting it together" as soon as every scene is drawn
+- The Content Studio title now shows in hosts whose router passes no `heading`
+  value, as the assessment screen's already did
+
+## 0.6.2
+
+Adds behaviour and a screen redesign rather than API: `configure()`, the tags,
+attributes and events are unchanged, so a host upgrades without touching a line.
+
+**Added**
+- Stop a generation you started by mistake. Assessment shows a Cancel button
+  while it runs; the run stops at its next step and the form comes back with
+  your sources and settings still in place. A model call already in flight
+  finishes and is still paid for — there is no way to un-send one
+- Your own history, under each feature. "Your assessments" and "Your videos"
+  list what the signed-in person created — open one to review, edit or download
+  again. Filtered to that person, so nobody sees another's work
+- The source a question came from now reads as a labelled chip, and difficulty
+  and Bloom's level are colour-coded (green/amber/red, and violet), so a long
+  set sorts at a glance
+
+**Changed**
+- One **Download Excel** button in place of the old Save / Excel / CSV trio.
+  Edits now save on their own a moment after you type and when you leave, and the
+  download always saves the latest first. CSV is dropped: Excel already carries
+  every language on its own sheet, where CSV carried one and looked like it lost
+  the others
+- The Assessment screen is rebuilt into smaller parts with a Material → Settings
+  → Review track, a sticky summary, and a more compact layout. Every existing
+  feature and API call works exactly as before
+
+**Fixed**
+- In an exported sheet, the Correct Answer column is the option **number**
+  (1, 2, 3, 4), not the option text — a grader reads it against the numbered
+  columns, and a number stays valid in every translation
+- The element now carries its own font. It named Inter but did not ship it, so
+  in a host that loads a different font (CBP ships Roboto) it fell back to the
+  system font and looked unlike the demo. The Latin subset of Inter is now
+  bundled and injected once, so the type is identical in every host with no
+  font loading, no `<link>`, and no CSP to satisfy. Adds ~100KB. Hindi keeps
+  using the system Devanagari font, as it always did — Inter has no Devanagari
+- Headings and icon-beside-text rows sat misaligned inside a host whose global
+  typography (Material, in CBP) set a taller line-height and a different heading
+  font: line-height inherits, and a bare `h2` lost to the host's `h1..h6` rule.
+  The element now states its own line-height on the root and its font on every
+  heading class, so it reads the same in any host with no host CSS
+- On a wide host (like the portal), the assessment screen stretched full-bleed —
+  the two-column steps put the label at one edge and the control at the other.
+  It now caps at 1600px and centres, the same in every host, with no host CSS;
+  `--aastrika-max-width` still overrides it
+- A question's source read backwards when it was a topic, not a file:
+  "Definition · Understanding the Fourth Stage of Labor" led with the subtopic
+  and buried the topic. A topic-shaped reference is now shown whole, in its
+  natural order; a real document still leads with its section
+
+**Removed**
+- The "past video's script" source picker in Assessment. It is not part of a
+  host's integration surface, so nothing a host configures changes
+
+Cancel and history need the service on this branch's backend build: cancel posts
+`status: 'cancelled'` to the quiz update endpoint, and history reads a `creator`
+filter on the list endpoints. On an older service, the Cancel button's request
+is rejected and history comes back empty — nothing else is affected.
+
+## 0.6.1
+
+**Fixed**
+- The usage report showed one person's figures instead of the whole
+  organisation's — and nothing at all when the signed-in name did not match the
+  name recorded on their content. Every request body was given the signed-in
+  `creator`, including the report, where that field means "filter to this
+  person" rather than "this is who I am". The report is no longer given one; the
+  dashboard's own picker still filters as before
+
+**Added**
+- `creatorName` in `configure()` — the signed-in person's display name, shown in
+  the report while `creator` stays what it groups by. A host can now use a
+  stable handle as `creator` and let people rename themselves without splitting
+  their history across two creators. Optional: omit it and the report shows
+  `creator`, exactly as today
+
+Needs the service to be on a build that stores `creator_name`; on an older one
+the field is ignored and nothing changes.
+
 ## 0.6.0
 
 Adds behaviour rather than API: the tags, attributes and events are exactly

package/aastrika-elements.d.ts

@@ -43,8 +43,20 @@ export interface AastrikaConfig {
   apiBase: string;
   /** Headers proving the caller may use the service. Called before every request. */
   getAuthHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
-  /** The username signed into YOUR application. Attribution, never verified. */
+  /**
+   * A STABLE key for whoever is signed into YOUR application — a login handle
+   * or an id, never a display name. The usage report groups and filters by it,
+   * so renaming somebody must not change it. Attribution, never verified.
+   */
   creator?: () => string | null;
+  /**
+   * The same person's display name, e.g. "Prince Gupta". Shown in the usage
+   * report; `creator` remains what it groups by, so people can rename
+   * themselves without splitting their history. Optional — omit it and the
+   * report shows `creator`, so send one whenever `creator` is an opaque id,
+   * or the report fills with UUIDs.
+   */
+  creatorName?: () => string | null;
   /** Called whenever a request fails, so your monitoring hears about it. */
   onError?: (error: AastrikaError) => void;
 }
@@ -92,6 +104,13 @@ interface AastrikaContentStudioElement extends HTMLElement {
    * same-origin host.
    */
   editMode?: 'on' | 'off';
+  /**
+   * `'on'` lets the render's technical log be opened. Defaults to `'off'`.
+   *
+   * The log is for support and admin pages; a creator sees the same progress
+   * in plain words without it.
+   */
+  technicalLog?: 'on' | 'off';
   /** Language the form opens on, e.g. `'hi'`, `'en'`, `'kn'`, `'te'`. */
   defaultLanguage?: string;
   /** `'16:9'` or `'9:16'`. */