@lumiastream/ui 0.2.8-alpha.17 → 0.2.8-alpha.18

package/dist/index.js

@@ -3785,6 +3785,16 @@ function mapSingleAlert(widget, lumiaAlertKey, ctx) {
   return buildUnit(widget, "alert", { alert: { ...baseAlert, events } }, ctx);
 }
 
+// src/se-import/mappers/importMeta.ts
+function buildImportMeta(widget, config) {
+  return {
+    source: "streamelements",
+    widgetType: widget.type,
+    importedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    ...config && Object.keys(config).length > 0 ? { config } : {}
+  };
+}
+
 // src/se-import/mappers/goal.ts
 function currentForListener(listener) {
   if (!listener) return "0";
@@ -3860,9 +3870,12 @@ function mapGoal(widget, ctx) {
       border: "solid 1px transparent",
       borderRadius: "40px",
       highlightColor: "inherit",
-      // SE-only fields preserved as provenance — no native Lumia equivalent.
-      se_source_listener: listener,
-      se_simple_design: !!v.simpleDesign
+      // Source-side knobs without a native Lumia equivalent live under the
+      // generic `importMeta` envelope (see mappers/importMeta.ts).
+      importMeta: buildImportMeta(widget, {
+        sourceListener: listener,
+        simpleDesign: !!v.simpleDesign
+      })
     },
     css: {
       // `borderRadius` / `borderStyle` / `borderWidth` / `borderColor`
@@ -3885,7 +3898,7 @@ function mapGoal(widget, ctx) {
 }
 
 // src/se-import/mappers/custom.ts
-var SE_FIELD_TYPE_TO_LUMIA = {
+var SOURCE_TO_LUMIA_FIELD_TYPE = {
   text: "input",
   number: "number",
   checkbox: "checkbox",
@@ -3893,43 +3906,42 @@ var SE_FIELD_TYPE_TO_LUMIA = {
   slider: "slider",
   colorpicker: "colorpicker",
   fontpicker: "fontpicker",
-  // SE's font picker variant — same control surface as `fontpicker` for our
-  // purposes; the SE renderer pulls Google Fonts at runtime which Lumia's
-  // fontpicker also does.
+  // SE's `googleFont` picker is functionally the same as Lumia's native
+  // fontpicker (both load Google Fonts on demand).
   googleFont: "fontpicker",
-  // SE asset uploads — the asset URL lands in the `value` as a CDN string,
-  // which our `input` renders fine as-is. Once Lumia ships dedicated asset/
-  // audio pickers wired through the asset library, flip these mappings.
-  image: "input",
-  "image-input": "input",
-  "sound-input": "input",
-  "video-input": "input",
-  // Multi-line text — `input` accepts strings of any length; the editor
-  // surfaces a textarea by inspecting `value.length` heuristically.
-  textarea: "input",
+  // Asset uploads land on the native upload types added to Lumia's
+  // ConfigsFieldType. `image` (legacy SE alias) folds into `imageupload`.
+  image: "imageupload",
+  "image-input": "imageupload",
+  "sound-input": "soundupload",
+  "video-input": "videoupload",
+  // Multi-line text → native textarea.
+  textarea: "textarea",
+  // Hidden fields keep their value in `Overlay.data` but don't render a
+  // control; we map to `input` + the BaseConfigField `hidden: true` flag
+  // (applied below in translateConfigs).
   hidden: "input",
-  // SE's button is a "fire a JS action" trigger with no persisted value.
-  // Lumia has no equivalent; surface as a non-editable label.
-  button: "input"
+  // SE-side trigger buttons → native action button.
+  button: "actionbutton"
 };
-var SE_RESERVED_FIELD_KEYS = /* @__PURE__ */ new Set(["widgetName", "widgetAuthor", "widgetDuration"]);
-function translateConfigs(seFields) {
-  if (!seFields) return [];
-  return Object.entries(seFields).filter(([key]) => !SE_RESERVED_FIELD_KEYS.has(key)).map(([key, f]) => {
-    const seType = f.type ?? "text";
-    return {
+var RESERVED_FIELD_KEYS = /* @__PURE__ */ new Set(["widgetName", "widgetAuthor", "widgetDuration"]);
+function translateConfigs(sourceFields) {
+  if (!sourceFields) return [];
+  return Object.entries(sourceFields).filter(([key]) => !RESERVED_FIELD_KEYS.has(key)).map(([key, f]) => {
+    const sourceType = f.type ?? "text";
+    const nativeType = SOURCE_TO_LUMIA_FIELD_TYPE[sourceType] ?? "input";
+    const base = {
       key,
       label: f.label ?? key,
-      type: SE_FIELD_TYPE_TO_LUMIA[seType] ?? "input",
+      // The emitted `type` is a native Lumia ConfigsFieldType — no
+      // source-prefixed shadow field rides along. Anything that needs
+      // richer control behavior should land as a new native type.
+      type: nativeType,
       value: f.value,
-      options: f.options,
-      // Preserve the original SE type + group so a future editor UX
-      // upgrade can render the right control (e.g. an actual asset
-      // picker for `image-input`) without re-importing. Mentioned in
-      // docs/SE_IMPORT_GAPS.md under "Other widgets > custom-event-list".
-      seType,
-      ...f.group ? { seGroup: f.group } : {}
+      options: f.options
     };
+    if (sourceType === "hidden") base.hidden = true;
+    return base;
   });
 }
 function mapCustom(widget, ctx) {
@@ -4058,14 +4070,17 @@ function mapChatbox(widget, ctx) {
           twitch: { themeConfig: { primaryColor: accentColor, showUsernameColors: true } }
         }
       } : {},
-      // SE-only fields preserved as provenance — no native Lumia equivalent.
-      // `delay` / `messageDelay` (initial + per-message hold), and the
-      // raw highlight block in case a future Lumia feature wants the
-      // fine-grained styling.
-      se_message_delay: v.messageDelay,
-      se_initial_delay: v.delay,
-      se_highlight_users: v.highlight,
-      se_text_css: textCss
+      // Source-side knobs preserved under the generic importMeta envelope —
+      // no native Lumia equivalent today. `messageDelay` is per-message
+      // hold, `initialDelay` is the show-after-connect delay, and we
+      // stash the raw highlight block + text css for any future feature
+      // that wants the fine-grained styling.
+      importMeta: buildImportMeta(widget, {
+        messageDelay: v.messageDelay,
+        initialDelay: v.delay,
+        highlightUsers: v.highlight,
+        textCss
+      })
     }
   }, ctx);
 }
@@ -4339,12 +4354,15 @@ function mapCredits(widget, ctx) {
       audio: {
         content: { src: [], name: [], loop: false, volume: 1 }
       },
-      // SE-specific knobs preserved as provenance; no direct Lumia equivalent for
-      // these. `chosenFilter` would narrow eventsToShow if we had a clean mapping;
-      // `separator` would join entries but Lumia credits uses sectioned cards instead.
-      se_chosen_filter: v.chosenFilter,
-      se_separator: v.separator,
-      se_amount: v.amount
+      // Source-side knobs with no direct Lumia equivalent — preserved
+      // under the generic importMeta envelope. `chosenFilter` would
+      // narrow eventsToShow if we had a clean mapping; `separator` would
+      // join entries but Lumia credits uses sectioned cards instead.
+      importMeta: buildImportMeta(widget, {
+        chosenFilter: v.chosenFilter,
+        separator: v.separator,
+        amount: v.amount
+      })
     },
     css: {
       fontSize: 30,
@@ -4412,8 +4430,10 @@ function mapSlideshow(widget, ctx) {
         enterAnimationDelay: (seAnim.inDelay ?? 0) * 1e3,
         exitAnimationDelay: (seAnim.outDelay ?? 0) * 1e3
       },
-      se_interval: v.interval,
-      se_raw_duration: v.duration
+      importMeta: buildImportMeta(widget, {
+        interval: v.interval,
+        rawDuration: v.duration
+      })
     }
   }, ctx);
 }
@@ -4493,9 +4513,11 @@ function mapTimer(widget, ctx) {
       changeMessageAfter: !!v.changeMessageAfterCountdown,
       countDate: hasValidAbsoluteDate && (!!v.exactTime || !!v.datePicker || !!absoluteDate),
       date: hasValidAbsoluteDate ? new Date(target).toISOString() : "",
-      se_date: absoluteDate,
-      se_date_picker: v.datePicker,
-      se_exact_time: v.exactTime
+      importMeta: buildImportMeta(widget, {
+        rawDate: absoluteDate,
+        datePicker: v.datePicker,
+        exactTime: v.exactTime
+      })
     }
   }, ctx);
 }
@@ -4515,7 +4537,7 @@ function mapNowPlaying(widget, ctx) {
       showImg: true,
       oneLineTitle: false,
       highlightColor: "inherit",
-      se_simple_design: !!v.simpleDesign
+      importMeta: buildImportMeta(widget, { simpleDesign: !!v.simpleDesign })
     },
     css: {
       borderRadius: "0px",
@@ -4560,9 +4582,10 @@ function mapMediaShare(widget, ctx) {
       playerVisible: false,
       defaultVolume: 70,
       autoAdvanceOnEnd: true,
-      // SE-only knob preserved for round-trip provenance; Lumia ignores
-      // it (LumiaStream auto-advance fires on `durationSeconds + grace`).
-      se_timeLeft: v.timeLeft === true
+      // Source-side knob preserved for round-trip provenance; Lumia
+      // ignores it at runtime (auto-advance fires on
+      // `durationSeconds + grace`).
+      importMeta: buildImportMeta(widget, { timeLeft: v.timeLeft === true })
     },
     css: {
       fontFamily: "Roboto",
@@ -4636,15 +4659,18 @@ function mapKappagen(widget, ctx) {
           ffz: v.ffz !== false,
           sevenTv: v.sevenTv !== false
         },
-        // SE-only knobs preserved as provenance; no Lumia rendering for these.
-        se_mode: v.mode,
-        se_cheersplosions: !!v.cheersplosions,
-        se_emotesplosion: v.emotesplosion,
-        se_emotesplosion_dir: v.emotesplosiondir,
-        se_emotesplosion_duration: v.emotesplosionduration,
-        se_spawn_zone: v.spawnzone,
-        se_fullscreen: !!v.fullscreen,
-        se_direction: v.direction
+        // Source-side knobs preserved under the generic importMeta
+        // envelope — no Lumia rendering for these today.
+        importMeta: buildImportMeta(widget, {
+          mode: v.mode,
+          cheersplosions: !!v.cheersplosions,
+          emotesplosion: v.emotesplosion,
+          emotesplosionDir: v.emotesplosiondir,
+          emotesplosionDuration: v.emotesplosionduration,
+          spawnZone: v.spawnzone,
+          fullscreen: !!v.fullscreen,
+          direction: v.direction
+        })
       },
       css: { background: "transparent" }
     },
@@ -4668,11 +4694,13 @@ function mapLeaderboardFromVariables(widget, currency, ctx) {
       showCurrentPoints: false,
       showAllTimePoints: true,
       itemGap: 8,
-      // Preserve SE knobs that don't map cleanly so they survive the round-trip
-      // and the user can re-introspect later if behaviour differs.
-      se_period: v.period,
-      se_offset: v.offset,
-      se_layout: v.layout
+      // Source-side knobs that don't map cleanly survive under the
+      // generic importMeta envelope so the user can re-introspect.
+      importMeta: buildImportMeta(widget, {
+        period: v.period,
+        offset: v.offset,
+        layout: v.layout
+      })
     }
   }, ctx);
 }
@@ -4702,8 +4730,6 @@ function mapGiveaway(widget, ctx) {
       // preference via provenance — a future renderer can read it without us
       // having lied about the toggle. Same for `displayTicketsPurchased`.
       hideParticipantOnStart: false,
-      se_displayEntrants: v.displayEntrants !== false,
-      se_displayTicketsPurchased: v.displayTicketsPurchased !== false,
       removeWhenRedeemed: false,
       showWinningModal: true,
       playSoundFx: true,
@@ -4720,12 +4746,18 @@ function mapGiveaway(widget, ctx) {
       raffleEndedText: "The raffle has ended, and the selection of the winner will take place shortly.",
       raffleTimerText: "Time since raffle started",
       raffleCountdownText: "Raffle will end after",
-      // SE-specific knobs with no Lumia equivalent — preserved as provenance.
-      se_timeout: v.timeout,
-      se_enable_timeout: v.enableTimeOut,
-      se_display_entrants: v.displayEntrants,
-      se_display_tickets_purchased: v.displayTicketsPurchased,
-      se_image_style_width: v.imageStyle?.width
+      // Source-side knobs with no Lumia equivalent — preserved under
+      // the generic importMeta envelope. `displayEntrants` / `displayTicketsPurchased`
+      // are SE's persistent "never show" toggles; Lumia has no equivalent
+      // today (its `hideParticipantOnStart` is transient), so we preserve
+      // the preference for a future renderer.
+      importMeta: buildImportMeta(widget, {
+        timeout: v.timeout,
+        enableTimeout: v.enableTimeOut,
+        displayEntrants: v.displayEntrants,
+        displayTicketsPurchased: v.displayTicketsPurchased,
+        imageStyleWidth: v.imageStyle?.width
+      })
     }
   }, ctx);
 }
@@ -4795,11 +4827,12 @@ function mapHypetrain(widget, ctx) {
       trainLocoImageUrl: "https://storage.lumiastream.com/overlays/global/hypetrain/train_loco_default.png",
       rocketImageUrl: "https://storage.lumiastream.com/overlays/global/hypetrain/rocket_default.png",
       infernoImageUrl: "https://storage.lumiastream.com/overlays/global/hypetrain/inferno_default.png",
-      // SE config preserved verbatim as provenance — no Lumia equivalent for
-      // most of these knobs (per-widget animation tunables, sound URLs the
-      // streamer might want to migrate manually, etc.). Users can inspect
-      // these via the overlay JSON if they want to recreate a specific look.
-      se_variables: v
+      // Source config preserved verbatim under the generic importMeta
+      // envelope — no Lumia equivalent for most of these knobs
+      // (per-widget animation tunables, sound URLs the streamer might
+      // want to migrate manually, etc.). Users can inspect via the
+      // overlay JSON if they want to recreate a specific look.
+      importMeta: buildImportMeta(widget, { variables: v })
     }
   }, ctx);
 }
@@ -4934,13 +4967,16 @@ function mapHypeCup(widget, ctx) {
       // can enable in Settings; SE has no equivalent so nothing to lift.
       goal: { active: false, currency: "tips", target: 100, current: 0, readoutTemplate: "{{current}} / {{target}}", textColor: "#ffffff", hitAt: null },
       break: { enabled: false, command: "!breakjar", rebuildDelay: 5e3 },
-      // SE-only knobs that don't have a Lumia equivalent — preserved as
-      // provenance for future phases (per-cup polygons + enter/movement
-      // physics tweaks). `se_types` removed — now consumed into sprites above.
-      se_enter_from: v.enterFrom ?? null,
-      se_prevent_movement: !!v.preventMovement,
-      se_fullscreen: !!v.fullscreen,
-      se_cups: v.cups ?? null
+      // Source-side knobs without a Lumia equivalent — preserved under
+      // the generic `importMeta` envelope for future phases (per-cup
+      // polygons + enter/movement physics tweaks). The per-event
+      // sprite sets were already lifted into native `sprites` above.
+      importMeta: buildImportMeta(widget, {
+        enterFrom: v.enterFrom ?? null,
+        preventMovement: !!v.preventMovement,
+        fullscreen: !!v.fullscreen,
+        cups: v.cups ?? null
+      })
     },
     css: {
       background: "transparent"
@@ -5059,17 +5095,19 @@ function mapStreamBoss(widget, ctx) {
       bossNameColor: "",
       botChat: "off",
       chatAsSelf: false,
-      // SE-only knobs preserved as provenance for future passes. None
-      // have direct Lumia analogs today:
-      //   - `right`     anchors the boss to the right edge of its bounds;
-      //     Lumia uses layer position instead, so this is informational.
-      //   - `bossName`  controls vertical name position in SE; our themes
-      //     don't expose that level of fine-grained tweaking yet.
-      //   - `mode`      SE's gameplay mode hint ('overkill', etc.).
-      se_right: !!v.right,
-      se_bossNamePosition: typeof v.bossName === "string" ? v.bossName : null,
-      se_mode: typeof v.mode === "string" ? v.mode : null,
-      se_showName: v.showName !== false
+      // Source-side knobs preserved as provenance for future passes.
+      // None have direct Lumia analogs today:
+      //   - `right`            anchors the boss to the right edge of its
+      //                        bounds; Lumia uses layer position instead.
+      //   - `bossNamePosition` SE-controlled vertical name position; our
+      //                        themes don't expose that level of tweaking.
+      //   - `mode`             source-side gameplay mode hint ('overkill').
+      importMeta: buildImportMeta(widget, {
+        right: !!v.right,
+        bossNamePosition: typeof v.bossName === "string" ? v.bossName : null,
+        mode: typeof v.mode === "string" ? v.mode : null,
+        showName: v.showName !== false
+      })
     },
     css: {
       background: "transparent"
@@ -7911,6 +7949,7 @@ function extractErrorMessage(err) {
 }
 
 // src/se-import/index.ts
+var IMPORT_META_KEY = "importMeta";
 var REVIEW_REASONS = {
   "se-widget-bit-boss": "No native Lumia equivalent \u2014 bit boss fight bar with HP/damage states.",
   // `se-widget-hype-cup` intentionally omitted — it now routes to the native
@@ -8057,7 +8096,14 @@ function importSEBootstrap(bootstrap) {
       lights: [],
       css: {},
       content: {
-        se_provenance: { widget: w, reason: "Imported as native group", status: "group" }
+        [IMPORT_META_KEY]: {
+          source: "streamelements",
+          widgetType: w.type,
+          importedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          widget: w,
+          reason: "Imported as native group",
+          status: "group"
+        }
       },
       events: {},
       variables: {}
@@ -8080,7 +8126,10 @@ function importSEBootstrap(bootstrap) {
     if (result.status === "placeholder" || result.status === "template") {
       module.content = {
         ...module.content ?? {},
-        se_provenance: {
+        [IMPORT_META_KEY]: {
+          source: "streamelements",
+          widgetType: w.type,
+          importedAt: (/* @__PURE__ */ new Date()).toISOString(),
           widget: w,
           reason: reasonFor(w.type, result.status, result.flaggedOff),
           status: result.status,
@@ -8161,7 +8210,7 @@ function applyReviewAction(result, moduleId, action, payload) {
       bounds: existingLayer.bounds,
       state: existingLayer.state
     };
-    const provenance2 = existing2.content?.se_provenance;
+    const importMeta2 = existing2.content?.[IMPORT_META_KEY];
     const mergedLights = (existing2.lights?.length ?? 0) > 0 ? existing2.lights : transplant.module.lights;
     const mergedEvents = existing2.events && Object.keys(existing2.events).length > 0 ? { ...transplant.module.events, ...existing2.events } : transplant.module.events;
     const mergedVariables = existing2.variables && Object.keys(existing2.variables).length > 0 ? { ...transplant.module.variables, ...existing2.variables } : transplant.module.variables;
@@ -8171,7 +8220,7 @@ function applyReviewAction(result, moduleId, action, payload) {
       lights: mergedLights,
       events: mergedEvents,
       variables: mergedVariables,
-      content: { ...transplant.module.content ?? {}, se_provenance: provenance2 }
+      content: { ...transplant.module.content ?? {}, [IMPORT_META_KEY]: importMeta2 }
     };
     const rootOldNewId = transplant.layer.id;
     const remappedExtras = (transplant.extras ?? []).map((e) => ({
@@ -8198,7 +8247,7 @@ function applyReviewAction(result, moduleId, action, payload) {
   const existing = modules[moduleId];
   const generated = payload;
   if (!existing || !generated) return result;
-  const provenance = existing.content?.se_provenance;
+  const importMeta = existing.content?.[IMPORT_META_KEY];
   const replaced = {
     ...existing,
     settings: { ...existing.settings ?? {}, type: "custom" },
@@ -8212,7 +8261,7 @@ function applyReviewAction(result, moduleId, action, payload) {
       data: parseLooseJson(generated.data) ?? {},
       configs: parseLooseJson(generated.configs) ?? [],
       flavor: "ai-generated",
-      se_provenance: provenance
+      [IMPORT_META_KEY]: importMeta
     }
   };
   modules[moduleId] = replaced;

package/dist/se-import.d.ts

@@ -116,6 +116,7 @@ interface SECss {
     opacity?: number;
     top?: string | number;
     left?: string | number;
+    transform?: string;
 }
 interface SEText {
     type?: string;

package/dist/se-import.js

@@ -670,6 +670,16 @@ function mapSingleAlert(widget, lumiaAlertKey, ctx) {
   return buildUnit(widget, "alert", { alert: { ...baseAlert, events } }, ctx);
 }
 
+// src/se-import/mappers/importMeta.ts
+function buildImportMeta(widget, config) {
+  return {
+    source: "streamelements",
+    widgetType: widget.type,
+    importedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    ...config && Object.keys(config).length > 0 ? { config } : {}
+  };
+}
+
 // src/se-import/mappers/goal.ts
 function currentForListener(listener) {
   if (!listener) return "0";
@@ -745,9 +755,12 @@ function mapGoal(widget, ctx) {
       border: "solid 1px transparent",
       borderRadius: "40px",
       highlightColor: "inherit",
-      // SE-only fields preserved as provenance — no native Lumia equivalent.
-      se_source_listener: listener,
-      se_simple_design: !!v.simpleDesign
+      // Source-side knobs without a native Lumia equivalent live under the
+      // generic `importMeta` envelope (see mappers/importMeta.ts).
+      importMeta: buildImportMeta(widget, {
+        sourceListener: listener,
+        simpleDesign: !!v.simpleDesign
+      })
     },
     css: {
       // `borderRadius` / `borderStyle` / `borderWidth` / `borderColor`
@@ -770,7 +783,7 @@ function mapGoal(widget, ctx) {
 }
 
 // src/se-import/mappers/custom.ts
-var SE_FIELD_TYPE_TO_LUMIA = {
+var SOURCE_TO_LUMIA_FIELD_TYPE = {
   text: "input",
   number: "number",
   checkbox: "checkbox",
@@ -778,43 +791,42 @@ var SE_FIELD_TYPE_TO_LUMIA = {
   slider: "slider",
   colorpicker: "colorpicker",
   fontpicker: "fontpicker",
-  // SE's font picker variant — same control surface as `fontpicker` for our
-  // purposes; the SE renderer pulls Google Fonts at runtime which Lumia's
-  // fontpicker also does.
+  // SE's `googleFont` picker is functionally the same as Lumia's native
+  // fontpicker (both load Google Fonts on demand).
   googleFont: "fontpicker",
-  // SE asset uploads — the asset URL lands in the `value` as a CDN string,
-  // which our `input` renders fine as-is. Once Lumia ships dedicated asset/
-  // audio pickers wired through the asset library, flip these mappings.
-  image: "input",
-  "image-input": "input",
-  "sound-input": "input",
-  "video-input": "input",
-  // Multi-line text — `input` accepts strings of any length; the editor
-  // surfaces a textarea by inspecting `value.length` heuristically.
-  textarea: "input",
+  // Asset uploads land on the native upload types added to Lumia's
+  // ConfigsFieldType. `image` (legacy SE alias) folds into `imageupload`.
+  image: "imageupload",
+  "image-input": "imageupload",
+  "sound-input": "soundupload",
+  "video-input": "videoupload",
+  // Multi-line text → native textarea.
+  textarea: "textarea",
+  // Hidden fields keep their value in `Overlay.data` but don't render a
+  // control; we map to `input` + the BaseConfigField `hidden: true` flag
+  // (applied below in translateConfigs).
   hidden: "input",
-  // SE's button is a "fire a JS action" trigger with no persisted value.
-  // Lumia has no equivalent; surface as a non-editable label.
-  button: "input"
+  // SE-side trigger buttons → native action button.
+  button: "actionbutton"
 };
-var SE_RESERVED_FIELD_KEYS = /* @__PURE__ */ new Set(["widgetName", "widgetAuthor", "widgetDuration"]);
-function translateConfigs(seFields) {
-  if (!seFields) return [];
-  return Object.entries(seFields).filter(([key]) => !SE_RESERVED_FIELD_KEYS.has(key)).map(([key, f]) => {
-    const seType = f.type ?? "text";
-    return {
+var RESERVED_FIELD_KEYS = /* @__PURE__ */ new Set(["widgetName", "widgetAuthor", "widgetDuration"]);
+function translateConfigs(sourceFields) {
+  if (!sourceFields) return [];
+  return Object.entries(sourceFields).filter(([key]) => !RESERVED_FIELD_KEYS.has(key)).map(([key, f]) => {
+    const sourceType = f.type ?? "text";
+    const nativeType = SOURCE_TO_LUMIA_FIELD_TYPE[sourceType] ?? "input";
+    const base = {
       key,
       label: f.label ?? key,
-      type: SE_FIELD_TYPE_TO_LUMIA[seType] ?? "input",
+      // The emitted `type` is a native Lumia ConfigsFieldType — no
+      // source-prefixed shadow field rides along. Anything that needs
+      // richer control behavior should land as a new native type.
+      type: nativeType,
       value: f.value,
-      options: f.options,
-      // Preserve the original SE type + group so a future editor UX
-      // upgrade can render the right control (e.g. an actual asset
-      // picker for `image-input`) without re-importing. Mentioned in
-      // docs/SE_IMPORT_GAPS.md under "Other widgets > custom-event-list".
-      seType,
-      ...f.group ? { seGroup: f.group } : {}
+      options: f.options
     };
+    if (sourceType === "hidden") base.hidden = true;
+    return base;
   });
 }
 function mapCustom(widget, ctx) {
@@ -943,14 +955,17 @@ function mapChatbox(widget, ctx) {
           twitch: { themeConfig: { primaryColor: accentColor, showUsernameColors: true } }
         }
       } : {},
-      // SE-only fields preserved as provenance — no native Lumia equivalent.
-      // `delay` / `messageDelay` (initial + per-message hold), and the
-      // raw highlight block in case a future Lumia feature wants the
-      // fine-grained styling.
-      se_message_delay: v.messageDelay,
-      se_initial_delay: v.delay,
-      se_highlight_users: v.highlight,
-      se_text_css: textCss
+      // Source-side knobs preserved under the generic importMeta envelope —
+      // no native Lumia equivalent today. `messageDelay` is per-message
+      // hold, `initialDelay` is the show-after-connect delay, and we
+      // stash the raw highlight block + text css for any future feature
+      // that wants the fine-grained styling.
+      importMeta: buildImportMeta(widget, {
+        messageDelay: v.messageDelay,
+        initialDelay: v.delay,
+        highlightUsers: v.highlight,
+        textCss
+      })
     }
   }, ctx);
 }
@@ -1224,12 +1239,15 @@ function mapCredits(widget, ctx) {
       audio: {
         content: { src: [], name: [], loop: false, volume: 1 }
       },
-      // SE-specific knobs preserved as provenance; no direct Lumia equivalent for
-      // these. `chosenFilter` would narrow eventsToShow if we had a clean mapping;
-      // `separator` would join entries but Lumia credits uses sectioned cards instead.
-      se_chosen_filter: v.chosenFilter,
-      se_separator: v.separator,
-      se_amount: v.amount
+      // Source-side knobs with no direct Lumia equivalent — preserved
+      // under the generic importMeta envelope. `chosenFilter` would
+      // narrow eventsToShow if we had a clean mapping; `separator` would
+      // join entries but Lumia credits uses sectioned cards instead.
+      importMeta: buildImportMeta(widget, {
+        chosenFilter: v.chosenFilter,
+        separator: v.separator,
+        amount: v.amount
+      })
     },
     css: {
       fontSize: 30,
@@ -1297,8 +1315,10 @@ function mapSlideshow(widget, ctx) {
         enterAnimationDelay: (seAnim.inDelay ?? 0) * 1e3,
         exitAnimationDelay: (seAnim.outDelay ?? 0) * 1e3
       },
-      se_interval: v.interval,
-      se_raw_duration: v.duration
+      importMeta: buildImportMeta(widget, {
+        interval: v.interval,
+        rawDuration: v.duration
+      })
     }
   }, ctx);
 }
@@ -1378,9 +1398,11 @@ function mapTimer(widget, ctx) {
       changeMessageAfter: !!v.changeMessageAfterCountdown,
       countDate: hasValidAbsoluteDate && (!!v.exactTime || !!v.datePicker || !!absoluteDate),
       date: hasValidAbsoluteDate ? new Date(target).toISOString() : "",
-      se_date: absoluteDate,
-      se_date_picker: v.datePicker,
-      se_exact_time: v.exactTime
+      importMeta: buildImportMeta(widget, {
+        rawDate: absoluteDate,
+        datePicker: v.datePicker,
+        exactTime: v.exactTime
+      })
     }
   }, ctx);
 }
@@ -1400,7 +1422,7 @@ function mapNowPlaying(widget, ctx) {
       showImg: true,
       oneLineTitle: false,
       highlightColor: "inherit",
-      se_simple_design: !!v.simpleDesign
+      importMeta: buildImportMeta(widget, { simpleDesign: !!v.simpleDesign })
     },
     css: {
       borderRadius: "0px",
@@ -1445,9 +1467,10 @@ function mapMediaShare(widget, ctx) {
       playerVisible: false,
       defaultVolume: 70,
       autoAdvanceOnEnd: true,
-      // SE-only knob preserved for round-trip provenance; Lumia ignores
-      // it (LumiaStream auto-advance fires on `durationSeconds + grace`).
-      se_timeLeft: v.timeLeft === true
+      // Source-side knob preserved for round-trip provenance; Lumia
+      // ignores it at runtime (auto-advance fires on
+      // `durationSeconds + grace`).
+      importMeta: buildImportMeta(widget, { timeLeft: v.timeLeft === true })
     },
     css: {
       fontFamily: "Roboto",
@@ -1521,15 +1544,18 @@ function mapKappagen(widget, ctx) {
           ffz: v.ffz !== false,
           sevenTv: v.sevenTv !== false
         },
-        // SE-only knobs preserved as provenance; no Lumia rendering for these.
-        se_mode: v.mode,
-        se_cheersplosions: !!v.cheersplosions,
-        se_emotesplosion: v.emotesplosion,
-        se_emotesplosion_dir: v.emotesplosiondir,
-        se_emotesplosion_duration: v.emotesplosionduration,
-        se_spawn_zone: v.spawnzone,
-        se_fullscreen: !!v.fullscreen,
-        se_direction: v.direction
+        // Source-side knobs preserved under the generic importMeta
+        // envelope — no Lumia rendering for these today.
+        importMeta: buildImportMeta(widget, {
+          mode: v.mode,
+          cheersplosions: !!v.cheersplosions,
+          emotesplosion: v.emotesplosion,
+          emotesplosionDir: v.emotesplosiondir,
+          emotesplosionDuration: v.emotesplosionduration,
+          spawnZone: v.spawnzone,
+          fullscreen: !!v.fullscreen,
+          direction: v.direction
+        })
       },
       css: { background: "transparent" }
     },
@@ -1553,11 +1579,13 @@ function mapLeaderboardFromVariables(widget, currency, ctx) {
       showCurrentPoints: false,
       showAllTimePoints: true,
       itemGap: 8,
-      // Preserve SE knobs that don't map cleanly so they survive the round-trip
-      // and the user can re-introspect later if behaviour differs.
-      se_period: v.period,
-      se_offset: v.offset,
-      se_layout: v.layout
+      // Source-side knobs that don't map cleanly survive under the
+      // generic importMeta envelope so the user can re-introspect.
+      importMeta: buildImportMeta(widget, {
+        period: v.period,
+        offset: v.offset,
+        layout: v.layout
+      })
     }
   }, ctx);
 }
@@ -1587,8 +1615,6 @@ function mapGiveaway(widget, ctx) {
       // preference via provenance — a future renderer can read it without us
       // having lied about the toggle. Same for `displayTicketsPurchased`.
       hideParticipantOnStart: false,
-      se_displayEntrants: v.displayEntrants !== false,
-      se_displayTicketsPurchased: v.displayTicketsPurchased !== false,
       removeWhenRedeemed: false,
       showWinningModal: true,
       playSoundFx: true,
@@ -1605,12 +1631,18 @@ function mapGiveaway(widget, ctx) {
       raffleEndedText: "The raffle has ended, and the selection of the winner will take place shortly.",
       raffleTimerText: "Time since raffle started",
       raffleCountdownText: "Raffle will end after",
-      // SE-specific knobs with no Lumia equivalent — preserved as provenance.
-      se_timeout: v.timeout,
-      se_enable_timeout: v.enableTimeOut,
-      se_display_entrants: v.displayEntrants,
-      se_display_tickets_purchased: v.displayTicketsPurchased,
-      se_image_style_width: v.imageStyle?.width
+      // Source-side knobs with no Lumia equivalent — preserved under
+      // the generic importMeta envelope. `displayEntrants` / `displayTicketsPurchased`
+      // are SE's persistent "never show" toggles; Lumia has no equivalent
+      // today (its `hideParticipantOnStart` is transient), so we preserve
+      // the preference for a future renderer.
+      importMeta: buildImportMeta(widget, {
+        timeout: v.timeout,
+        enableTimeout: v.enableTimeOut,
+        displayEntrants: v.displayEntrants,
+        displayTicketsPurchased: v.displayTicketsPurchased,
+        imageStyleWidth: v.imageStyle?.width
+      })
     }
   }, ctx);
 }
@@ -1680,11 +1712,12 @@ function mapHypetrain(widget, ctx) {
       trainLocoImageUrl: "https://storage.lumiastream.com/overlays/global/hypetrain/train_loco_default.png",
       rocketImageUrl: "https://storage.lumiastream.com/overlays/global/hypetrain/rocket_default.png",
       infernoImageUrl: "https://storage.lumiastream.com/overlays/global/hypetrain/inferno_default.png",
-      // SE config preserved verbatim as provenance — no Lumia equivalent for
-      // most of these knobs (per-widget animation tunables, sound URLs the
-      // streamer might want to migrate manually, etc.). Users can inspect
-      // these via the overlay JSON if they want to recreate a specific look.
-      se_variables: v
+      // Source config preserved verbatim under the generic importMeta
+      // envelope — no Lumia equivalent for most of these knobs
+      // (per-widget animation tunables, sound URLs the streamer might
+      // want to migrate manually, etc.). Users can inspect via the
+      // overlay JSON if they want to recreate a specific look.
+      importMeta: buildImportMeta(widget, { variables: v })
     }
   }, ctx);
 }
@@ -1819,13 +1852,16 @@ function mapHypeCup(widget, ctx) {
       // can enable in Settings; SE has no equivalent so nothing to lift.
       goal: { active: false, currency: "tips", target: 100, current: 0, readoutTemplate: "{{current}} / {{target}}", textColor: "#ffffff", hitAt: null },
       break: { enabled: false, command: "!breakjar", rebuildDelay: 5e3 },
-      // SE-only knobs that don't have a Lumia equivalent — preserved as
-      // provenance for future phases (per-cup polygons + enter/movement
-      // physics tweaks). `se_types` removed — now consumed into sprites above.
-      se_enter_from: v.enterFrom ?? null,
-      se_prevent_movement: !!v.preventMovement,
-      se_fullscreen: !!v.fullscreen,
-      se_cups: v.cups ?? null
+      // Source-side knobs without a Lumia equivalent — preserved under
+      // the generic `importMeta` envelope for future phases (per-cup
+      // polygons + enter/movement physics tweaks). The per-event
+      // sprite sets were already lifted into native `sprites` above.
+      importMeta: buildImportMeta(widget, {
+        enterFrom: v.enterFrom ?? null,
+        preventMovement: !!v.preventMovement,
+        fullscreen: !!v.fullscreen,
+        cups: v.cups ?? null
+      })
     },
     css: {
       background: "transparent"
@@ -1944,17 +1980,19 @@ function mapStreamBoss(widget, ctx) {
       bossNameColor: "",
       botChat: "off",
       chatAsSelf: false,
-      // SE-only knobs preserved as provenance for future passes. None
-      // have direct Lumia analogs today:
-      //   - `right`     anchors the boss to the right edge of its bounds;
-      //     Lumia uses layer position instead, so this is informational.
-      //   - `bossName`  controls vertical name position in SE; our themes
-      //     don't expose that level of fine-grained tweaking yet.
-      //   - `mode`      SE's gameplay mode hint ('overkill', etc.).
-      se_right: !!v.right,
-      se_bossNamePosition: typeof v.bossName === "string" ? v.bossName : null,
-      se_mode: typeof v.mode === "string" ? v.mode : null,
-      se_showName: v.showName !== false
+      // Source-side knobs preserved as provenance for future passes.
+      // None have direct Lumia analogs today:
+      //   - `right`            anchors the boss to the right edge of its
+      //                        bounds; Lumia uses layer position instead.
+      //   - `bossNamePosition` SE-controlled vertical name position; our
+      //                        themes don't expose that level of tweaking.
+      //   - `mode`             source-side gameplay mode hint ('overkill').
+      importMeta: buildImportMeta(widget, {
+        right: !!v.right,
+        bossNamePosition: typeof v.bossName === "string" ? v.bossName : null,
+        mode: typeof v.mode === "string" ? v.mode : null,
+        showName: v.showName !== false
+      })
     },
     css: {
       background: "transparent"
@@ -6781,6 +6819,7 @@ function extractErrorMessage(err) {
 }
 
 // src/se-import/index.ts
+var IMPORT_META_KEY = "importMeta";
 var REVIEW_REASONS = {
   "se-widget-bit-boss": "No native Lumia equivalent \u2014 bit boss fight bar with HP/damage states.",
   // `se-widget-hype-cup` intentionally omitted — it now routes to the native
@@ -6927,7 +6966,14 @@ function importSEBootstrap(bootstrap) {
       lights: [],
       css: {},
       content: {
-        se_provenance: { widget: w, reason: "Imported as native group", status: "group" }
+        [IMPORT_META_KEY]: {
+          source: "streamelements",
+          widgetType: w.type,
+          importedAt: (/* @__PURE__ */ new Date()).toISOString(),
+          widget: w,
+          reason: "Imported as native group",
+          status: "group"
+        }
       },
       events: {},
       variables: {}
@@ -6950,7 +6996,10 @@ function importSEBootstrap(bootstrap) {
     if (result.status === "placeholder" || result.status === "template") {
       module.content = {
         ...module.content ?? {},
-        se_provenance: {
+        [IMPORT_META_KEY]: {
+          source: "streamelements",
+          widgetType: w.type,
+          importedAt: (/* @__PURE__ */ new Date()).toISOString(),
           widget: w,
           reason: reasonFor(w.type, result.status, result.flaggedOff),
           status: result.status,
@@ -7031,7 +7080,7 @@ function applyReviewAction(result, moduleId, action, payload) {
       bounds: existingLayer.bounds,
       state: existingLayer.state
     };
-    const provenance2 = existing2.content?.se_provenance;
+    const importMeta2 = existing2.content?.[IMPORT_META_KEY];
     const mergedLights = (existing2.lights?.length ?? 0) > 0 ? existing2.lights : transplant.module.lights;
     const mergedEvents = existing2.events && Object.keys(existing2.events).length > 0 ? { ...transplant.module.events, ...existing2.events } : transplant.module.events;
     const mergedVariables = existing2.variables && Object.keys(existing2.variables).length > 0 ? { ...transplant.module.variables, ...existing2.variables } : transplant.module.variables;
@@ -7041,7 +7090,7 @@ function applyReviewAction(result, moduleId, action, payload) {
       lights: mergedLights,
       events: mergedEvents,
       variables: mergedVariables,
-      content: { ...transplant.module.content ?? {}, se_provenance: provenance2 }
+      content: { ...transplant.module.content ?? {}, [IMPORT_META_KEY]: importMeta2 }
     };
     const rootOldNewId = transplant.layer.id;
     const remappedExtras = (transplant.extras ?? []).map((e) => ({
@@ -7068,7 +7117,7 @@ function applyReviewAction(result, moduleId, action, payload) {
   const existing = modules[moduleId];
   const generated = payload;
   if (!existing || !generated) return result;
-  const provenance = existing.content?.se_provenance;
+  const importMeta = existing.content?.[IMPORT_META_KEY];
   const replaced = {
     ...existing,
     settings: { ...existing.settings ?? {}, type: "custom" },
@@ -7082,7 +7131,7 @@ function applyReviewAction(result, moduleId, action, payload) {
       data: parseLooseJson(generated.data) ?? {},
       configs: parseLooseJson(generated.configs) ?? [],
       flavor: "ai-generated",
-      se_provenance: provenance
+      [IMPORT_META_KEY]: importMeta
     }
   };
   modules[moduleId] = replaced;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@lumiastream/ui",
-	"version": "0.2.8-alpha.17",
+	"version": "0.2.8-alpha.18",
 	"author": "Lumia Stream",
 	"license": "ISC",
 	"description": "Lumia UI Kit",