@innspel/react-native 0.5.0 → 0.6.0

package/README.md

@@ -98,7 +98,7 @@ Innspels. Innsenderen skal se hvem som svarte.
 | Kjente feil | I feilsporet **før** feltet, i ønskesporet etter. Tre svar per kort: «Ja, jeg også» (teller deg uten ny sak), «Ligner, men ikke helt» (ditt eget innspill med lenke), «Nei, det er noe annet». Tom liste hopper skjermen over — treffene er et tilbud, aldri en sperre. |
 | Feltet | Ett tekstfelt. Send er aktiv fra N tegn, og **ingenting annet er obligatorisk**. Konteksten som legges ved er synlig og kan fjernes linje for linje. |
 | Mønstervarsel | Ser teksten ut til å inneholde e-post, telefonnummer, kortnummer, IP eller en tilgangsnøkkel, spør widgeten om det skal fjernes. Den fjerner **aldri** noe selv. |
-| Skjermbilde | Valgfritt. Tas ved trykk, forhåndsvises, maskeres på enheten — private views automatisk, resten med felt, pensel eller «Masker all tekst». Se under. |
+| Skjermbilde | Valgfritt, én eller to veier: «Legg ved skjermbilde» (skjermen bak arket, tatt ved trykk) og «Velg bilde» (fra galleriet, med din velger). Forhåndsvises og maskeres på enheten — private views automatisk på en fangst, resten med felt, pensel eller «Masker all tekst». Se under. |
 | Kvittering | Lover noe konkret, per spor, med saksnummer. Ber aldri om en vurdering av appen. Feilet bildet, sier den det — saken er sendt uansett. |
 | Mine innspill | Status, løftet som hører til, og svaret fra deg under saken. Det som venter på nett står øverst. |
 
@@ -132,6 +132,47 @@ import { createScreenshotAdapter, InnspelPrivate } from '@innspel/react-native';
 <InnspelProvider client={innspel} screenshot={createScreenshotAdapter(captureRef)}>
 ```
 
+**Bilde fra galleriet.** Et innspill handler sjelden om skjermen widgeten åpnes fra — åpnes
+den fra en profilside, viser fangsten profilen, ikke feilen. Gi adapteren din egen
+bildevelger, så får innsenderen «Velg bilde» og kan legge ved et systemskjermbilde tatt
+der feilen er. Pakken tar ingen avhengighet på velgeren:
+
+```tsx
+import * as ImagePicker from 'expo-image-picker';
+import { createScreenshotAdapter, type PickImageFn } from '@innspel/react-native';
+
+const pickImage: PickImageFn = async () => {
+  const r = await ImagePicker.launchImageLibraryAsync({ mediaTypes: ['images'], exif: false });
+  return r.canceled ? null : { uri: r.assets[0]!.uri, width: r.assets[0]!.width, height: r.assets[0]!.height };
+};
+
+// Begge veiene:
+<InnspelProvider client={innspel} screenshot={createScreenshotAdapter(captureRef, { pickImage })}>
+// Bare «Velg bilde» — skjermen bak arket fanges aldri:
+<InnspelProvider client={innspel} screenshot={createScreenshotAdapter(captureRef, { pickImage, captureScreen: false })}>
+```
+
+`captureRef` trengs fortsatt: forhåndsvisningen med maskene fanges på nytt, og det er
+komposittet som lastes opp — aldri fila fra galleriet. Systemets bildevelger trenger ingen
+tillatelse til biblioteket på Android 13+ og iOS. `<InnspelPrivate>` kan ikke gjelde et
+bilde fra et annet sted, og forhåndsvisningen sier det til innsenderen.
+
+**Din egen setning ved bildesteget.** Du kjenner brukerne dine og hva som er greit å legge
+ved; plattformen eier ikke den setningen. Den står ved knappene og i forhåndsvisningen:
+
+```tsx
+<InnspelProvider
+  client={innspel}
+  screenshot={adapter}
+  imageStepNote={{
+    feil: 'Legg ved et skjermbilde av feilen. Ikke send bilder av andre personer.',
+    onske: 'Vis gjerne hvor i appen du savner det.',
+  }}
+>
+```
+
+En streng gjelder begge spor. Et spor uten setning viser ingen.
+
 Uten `screenshot` finnes ikke steget — ikke som en grå knapp, det finnes ikke.
 Det samme gjelder når leietakeren har skjermbilde av (`screenshotsEnabled: false`,
 tvunget ved mindreårige).