@innspel/react-native 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -1,9 +1,61 @@
-import { InnspelClient, OpenFeedbackOptions, InnspelStorage, SubmissionStatus, SubmissionType } from '@innspel/core';
-export { CaptureInput, ContextInput, InnspelClient, InnspelOptions, InnspelStorage, MySubmission, OpenFeedbackOptions, SubmissionStatusView } from '@innspel/core';
-import React from 'react';
+import { MaskRect, InnspelClient, OpenFeedbackOptions, InnspelStorage, SubmissionStatus, SubmissionType } from '@innspel/core';
+export { AttachmentInput, AttachmentOutcome, CaptureInput, ContextInput, InnspelClient, InnspelOptions, InnspelStorage, MySubmission, OpenFeedbackOptions, SubmissionStatusView } from '@innspel/core';
+import React, { RefObject, ComponentRef } from 'react';
+import { View, StyleProp, ViewStyle } from 'react-native';
 
+/** Host-elementet bak en `View` — det som kan måles og fanges. RN 0.87: `View` er en funksjonskomponent, så typen hentes herfra. */
+type ViewRef = ComponentRef<typeof View>;
 /**
- * tokens.ts — GENERERT fra theme/theme.ts (avtrykk f03570c596e2).
+ * Fangst av skjermbilde er det ene stedet widgeten trenger noe React Native
+ * ikke har innebygd. Pakken tar INGEN avhengighet på det (K19, samme mønster som
+ * `createStorage`): verten sender inn `captureRef` fra `react-native-view-shot`,
+ * og uten adapter finnes ikke skjermbilde-steget (DD-26) — ikke som en grå
+ * knapp, det finnes ikke.
+ *
+ * Alt som rører plattformen går gjennom adapteren, også måling og fillesing, så
+ * widgeten kan testes med en fake og maskeringen bevises uten native kode.
+ */
+interface ScreenshotCapture {
+    /** Fil-URI fra fangsten. Forlater aldri enheten før den er maskert og rekomponert. */
+    uri: string;
+    /** Bitmapens størrelse i piksler. */
+    width: number;
+    height: number;
+}
+interface CaptureOptions {
+    format: 'jpg' | 'png';
+    /** 0–1, kun JPEG. */
+    quality: number;
+}
+interface ScreenshotAdapter {
+    /** Fanger viewen bak referansen til en fil. Kalles ved «Legg ved skjermbilde» (K4), og igjen på forhåndsvisningen for å rekomponere. */
+    capture(ref: RefObject<ViewRef | null>, options: CaptureOptions): Promise<ScreenshotCapture>;
+    /** Viewens rektangel i vinduskoordinater, i punkter. Null når den ikke er montert. */
+    measure(ref: RefObject<ViewRef | null>): Promise<MaskRect | null>;
+    /** Leser en fangst som Blob for opplasting. */
+    read(uri: string): Promise<Blob>;
+}
+/** Signaturen til `captureRef` i react-native-view-shot — det eneste verten trenger å sende inn. */
+type CaptureRefFn = (ref: RefObject<ViewRef | null> | ViewRef, options: {
+    format: 'jpg' | 'png';
+    quality: number;
+    result: 'tmpfile';
+}) => Promise<string>;
+/**
+ * Lager adapteren av vertens `captureRef`. Dimensjonene hentes med `Image.getSize`,
+ * målingen med `measureInWindow`, og fila leses med `fetch(uri).blob()` — alt fra
+ * React Native selv.
+ *
+ * @example
+ * ```tsx
+ * import { captureRef } from 'react-native-view-shot';
+ * <InnspelProvider client={innspel} screenshot={createScreenshotAdapter(captureRef)}>
+ * ```
+ */
+declare function createScreenshotAdapter(captureRef: CaptureRefFn): ScreenshotAdapter;
+
+/**
+ * tokens.ts — GENERERT fra theme/theme.ts (avtrykk 96a5d02e08c9).
  * Rediger aldri denne filen. Endre temaet i kilden og kjør
  * `node scripts/generate-tokens.ts`, som CI verifiserer med `--check`.
  *
@@ -194,6 +246,8 @@ declare const screenRules: {
     readonly autoMaskFill: "#101114";
     readonly autoMaskStroke: "#E5007D";
     readonly previewBackdrop: "#000000";
+    readonly brushWidth: 28;
+    readonly textBlurRadius: 24;
 };
 /** Formen widgeten tar imot. Verten sender et delvis tema; resten faller tilbake hit. */
 type InnspelTheme = typeof t;
@@ -249,9 +303,11 @@ interface InnspelKontekst {
 /**
  * Pakk appen i denne, og widgeten finnes.
  *
- * Provideren gjør tre ting: den registrerer visningen hos kjernen (så
+ * Provideren gjør fire ting: den registrerer visningen hos kjernen (så
  * `client.openFeedback()` virker hvor som helst i appen, også utenfor React),
- * den holder temaet, og den rendrer selve arket.
+ * den holder temaet, den rendrer selve arket — og den pakker vertsappen i én
+ * `View` med referanse, som er det skjermbildet tas av (K4). Modalen ligger
+ * utenfor den viewen og kommer aldri med på bildet.
  *
  * @example
  * ```tsx
@@ -259,14 +315,14 @@ interface InnspelKontekst {
  *
  * export default function App() {
  *   return (
- *     <InnspelProvider client={innspel}>
+ *     <InnspelProvider client={innspel} screenshot={createScreenshotAdapter(captureRef)}>
  *       <MinApp />
  *     </InnspelProvider>
  *   );
  * }
  * ```
  */
-declare function InnspelProvider({ client, children, theme, colorScheme, tenantName, }: {
+declare function InnspelProvider({ client, children, theme, colorScheme, tenantName, screenshot, }: {
     client: InnspelClient;
     children?: React.ReactNode;
     /** Vertens egne tokens. Alt som utelates faller tilbake på Innspels tema. */
@@ -274,6 +330,12 @@ declare function InnspelProvider({ client, children, theme, colorScheme, tenantN
     colorScheme?: 'dark' | 'light';
     /** Navnet som står på svaret i «Mine innspill» — leietakerens, ikke Innspels. */
     tenantName?: string;
+    /**
+     * Fangst av skjermbilde, typisk `createScreenshotAdapter(captureRef)` fra
+     * react-native-view-shot. Uten den finnes ikke skjermbilde-steget (DD-26) —
+     * og det finnes uansett ikke når `screenshotsEnabled` er av (K18).
+     */
+    screenshot?: ScreenshotAdapter;
 }): React.JSX.Element;
 /**
  * Klienten og `open` fra nærmeste {@link InnspelProvider}.
@@ -284,6 +346,24 @@ declare function InnspelProvider({ client, children, theme, colorScheme, tenantN
  */
 declare function useInnspel(): InnspelKontekst;
 
+/**
+ * Merk det som aldri skal være med på et skjermbilde (DD-39): navn i en liste,
+ * et kontonummer, en samtale. Pakk det inn, og widgeten maskerer det FØR
+ * innsenderen ser forhåndsvisningen — som «Maskert av appen», og penselen kan
+ * ikke oppheve det. Din kode er sannheten, ikke brukerens presisjon.
+ *
+ * Uten skjermbilde-adapter gjør komponenten ingenting utover å rendre barna.
+ *
+ * @example
+ * ```tsx
+ * <InnspelPrivate><Text>{bruker.navn}</Text></InnspelPrivate>
+ * ```
+ */
+declare function InnspelPrivate({ children, style }: {
+    children?: React.ReactNode;
+    style?: StyleProp<ViewStyle>;
+}): React.JSX.Element;
+
 /**
  * Formen på lagringspakkene i React Native-økosystemet: AsyncStorage, MMKV med
  * async-fasade, expo-secure-store. Alle tre har disse tre metodene.
@@ -388,6 +468,26 @@ declare const tekst: {
     readonly kontekstAldri: "Aldri: navn, e-post, telefon, posisjon eller det som står på skjermen.";
     readonly lenketTil: (tittel: string) => string;
     readonly fjernLenke: "Fjern lenken til den kjente feilen";
+    readonly leggVedSkjermbilde: "Legg ved skjermbilde";
+    readonly leggVedHint: "Bildet tas først når du trykker — du ser det før det sendes.";
+    readonly skjermbildeTittel: "Se over bildet";
+    readonly skjermbildeUnder: "Bildet ble tatt da du trykket. Det du maskerer, ser vi aldri.";
+    readonly maskering: "Maskering";
+    readonly maskerFelt: "Masker felt";
+    readonly tegnOver: "Tegn over";
+    readonly maskerAllTekst: "Masker all tekst";
+    readonly maskertAvAppen: "Maskert av appen";
+    readonly maskertAvAppenHint: "Registrert privat view. Penselen kan ikke oppheve den.";
+    readonly dittStrok: "▲ ditt strøk — maskert (kan angres med ett trykk)";
+    readonly allTekstHint: "Hele bildet er gjort uskarpt så tekst ikke kan leses. Layouten er synlig.";
+    readonly fjernBildet: "Fjern bildet";
+    readonly leggVedOgFortsett: "Legg ved og fortsett";
+    readonly leggVedHintDD42: "Teksten sendes først; bildet lastes opp for seg.";
+    readonly skjermbildeLagtVed: "Skjermbilde lagt ved — maskert";
+    readonly fjernSkjermbilde: "Fjern skjermbildet";
+    readonly sendHintMedBilde: "Teksten sendes først; bildet lastes opp for seg.";
+    readonly skjermbildeFeilet: "kunne ikke ta skjermbilde. Du kan sende uten.";
+    readonly skjermbildeA11y: (auto: number, egne: number, uskarpt: boolean) => string;
     readonly monsterSpm: {
         readonly email: "Dette ser ut som en e-postadresse. Vil du fjerne den?";
         readonly phone: "Dette ser ut som et telefonnummer. Vil du fjerne det?";
@@ -405,9 +505,16 @@ declare const tekst: {
     readonly kvitteringJaOgsa: "Du får beskjed når den er rettet.";
     readonly saksnummer: (nr: string) => string;
     readonly tilbakeTilAppen: "Tilbake til appen";
+    /** DD-42: saken er sendt, bildet kom ikke med — aldri en blokkert innsending. */
+    readonly kvitteringVedleggFeilet: "Sendt — skjermbildet kunne ikke legges ved";
+    readonly tekstenErLagret: "Teksten din er lagret.";
+    readonly vedleggFeiletBanner: "Bildet ble ikke lastet opp. Saken er sendt uten det — vil du, kan du sende et nytt innspill med bilde.";
+    readonly saksnummerUtenVedlegg: (nr: string) => string;
     readonly offlineTittel: "Ingen nett";
     readonly offlineBanner: "Ingen nett. Lagres og sendes automatisk — du ser det under «Mine innspill» til det er sendt.";
     readonly offlineLagre: "Lagre — sendes automatisk";
+    /** DD-41: et skjermbilde køes aldri. */
+    readonly offlineUtenBilde: "Skjermbilde kan ikke legges ved uten nett. Teksten sendes; bildet ble ikke lagret.";
     readonly sendefeilBanner: (arsak: string) => string;
     readonly provIgjen: "Prøv igjen";
     readonly mineTittel: "Mine innspill";
@@ -441,4 +548,4 @@ declare const lofte: {
     readonly avvist: "Vi har svart på denne.";
 };
 
-export { type AsyncStorageLike, type InnspelColors, InnspelProvider, type InnspelTheme, type PartialTheme, type StatusVisning, type Tema, byggTema, createMemoryStorage, createStorage, t as darkTokens, light, lofte, screenRules, statusVisning, tekst, useInnspel, useTema, venterVisning };
+export { type AsyncStorageLike, type CaptureOptions, type CaptureRefFn, type InnspelColors, InnspelPrivate, InnspelProvider, type InnspelTheme, type PartialTheme, type ScreenshotAdapter, type ScreenshotCapture, type StatusVisning, type Tema, byggTema, createMemoryStorage, createScreenshotAdapter, createStorage, t as darkTokens, light, lofte, screenRules, statusVisning, tekst, useInnspel, useTema, venterVisning };

package/dist/index.d.ts

@@ -1,9 +1,61 @@
-import { InnspelClient, OpenFeedbackOptions, InnspelStorage, SubmissionStatus, SubmissionType } from '@innspel/core';
-export { CaptureInput, ContextInput, InnspelClient, InnspelOptions, InnspelStorage, MySubmission, OpenFeedbackOptions, SubmissionStatusView } from '@innspel/core';
-import React from 'react';
+import { MaskRect, InnspelClient, OpenFeedbackOptions, InnspelStorage, SubmissionStatus, SubmissionType } from '@innspel/core';
+export { AttachmentInput, AttachmentOutcome, CaptureInput, ContextInput, InnspelClient, InnspelOptions, InnspelStorage, MySubmission, OpenFeedbackOptions, SubmissionStatusView } from '@innspel/core';
+import React, { RefObject, ComponentRef } from 'react';
+import { View, StyleProp, ViewStyle } from 'react-native';
 
+/** Host-elementet bak en `View` — det som kan måles og fanges. RN 0.87: `View` er en funksjonskomponent, så typen hentes herfra. */
+type ViewRef = ComponentRef<typeof View>;
 /**
- * tokens.ts — GENERERT fra theme/theme.ts (avtrykk f03570c596e2).
+ * Fangst av skjermbilde er det ene stedet widgeten trenger noe React Native
+ * ikke har innebygd. Pakken tar INGEN avhengighet på det (K19, samme mønster som
+ * `createStorage`): verten sender inn `captureRef` fra `react-native-view-shot`,
+ * og uten adapter finnes ikke skjermbilde-steget (DD-26) — ikke som en grå
+ * knapp, det finnes ikke.
+ *
+ * Alt som rører plattformen går gjennom adapteren, også måling og fillesing, så
+ * widgeten kan testes med en fake og maskeringen bevises uten native kode.
+ */
+interface ScreenshotCapture {
+    /** Fil-URI fra fangsten. Forlater aldri enheten før den er maskert og rekomponert. */
+    uri: string;
+    /** Bitmapens størrelse i piksler. */
+    width: number;
+    height: number;
+}
+interface CaptureOptions {
+    format: 'jpg' | 'png';
+    /** 0–1, kun JPEG. */
+    quality: number;
+}
+interface ScreenshotAdapter {
+    /** Fanger viewen bak referansen til en fil. Kalles ved «Legg ved skjermbilde» (K4), og igjen på forhåndsvisningen for å rekomponere. */
+    capture(ref: RefObject<ViewRef | null>, options: CaptureOptions): Promise<ScreenshotCapture>;
+    /** Viewens rektangel i vinduskoordinater, i punkter. Null når den ikke er montert. */
+    measure(ref: RefObject<ViewRef | null>): Promise<MaskRect | null>;
+    /** Leser en fangst som Blob for opplasting. */
+    read(uri: string): Promise<Blob>;
+}
+/** Signaturen til `captureRef` i react-native-view-shot — det eneste verten trenger å sende inn. */
+type CaptureRefFn = (ref: RefObject<ViewRef | null> | ViewRef, options: {
+    format: 'jpg' | 'png';
+    quality: number;
+    result: 'tmpfile';
+}) => Promise<string>;
+/**
+ * Lager adapteren av vertens `captureRef`. Dimensjonene hentes med `Image.getSize`,
+ * målingen med `measureInWindow`, og fila leses med `fetch(uri).blob()` — alt fra
+ * React Native selv.
+ *
+ * @example
+ * ```tsx
+ * import { captureRef } from 'react-native-view-shot';
+ * <InnspelProvider client={innspel} screenshot={createScreenshotAdapter(captureRef)}>
+ * ```
+ */
+declare function createScreenshotAdapter(captureRef: CaptureRefFn): ScreenshotAdapter;
+
+/**
+ * tokens.ts — GENERERT fra theme/theme.ts (avtrykk 96a5d02e08c9).
  * Rediger aldri denne filen. Endre temaet i kilden og kjør
  * `node scripts/generate-tokens.ts`, som CI verifiserer med `--check`.
  *
@@ -194,6 +246,8 @@ declare const screenRules: {
     readonly autoMaskFill: "#101114";
     readonly autoMaskStroke: "#E5007D";
     readonly previewBackdrop: "#000000";
+    readonly brushWidth: 28;
+    readonly textBlurRadius: 24;
 };
 /** Formen widgeten tar imot. Verten sender et delvis tema; resten faller tilbake hit. */
 type InnspelTheme = typeof t;
@@ -249,9 +303,11 @@ interface InnspelKontekst {
 /**
  * Pakk appen i denne, og widgeten finnes.
  *
- * Provideren gjør tre ting: den registrerer visningen hos kjernen (så
+ * Provideren gjør fire ting: den registrerer visningen hos kjernen (så
  * `client.openFeedback()` virker hvor som helst i appen, også utenfor React),
- * den holder temaet, og den rendrer selve arket.
+ * den holder temaet, den rendrer selve arket — og den pakker vertsappen i én
+ * `View` med referanse, som er det skjermbildet tas av (K4). Modalen ligger
+ * utenfor den viewen og kommer aldri med på bildet.
  *
  * @example
  * ```tsx
@@ -259,14 +315,14 @@ interface InnspelKontekst {
  *
  * export default function App() {
  *   return (
- *     <InnspelProvider client={innspel}>
+ *     <InnspelProvider client={innspel} screenshot={createScreenshotAdapter(captureRef)}>
  *       <MinApp />
  *     </InnspelProvider>
  *   );
  * }
  * ```
  */
-declare function InnspelProvider({ client, children, theme, colorScheme, tenantName, }: {
+declare function InnspelProvider({ client, children, theme, colorScheme, tenantName, screenshot, }: {
     client: InnspelClient;
     children?: React.ReactNode;
     /** Vertens egne tokens. Alt som utelates faller tilbake på Innspels tema. */
@@ -274,6 +330,12 @@ declare function InnspelProvider({ client, children, theme, colorScheme, tenantN
     colorScheme?: 'dark' | 'light';
     /** Navnet som står på svaret i «Mine innspill» — leietakerens, ikke Innspels. */
     tenantName?: string;
+    /**
+     * Fangst av skjermbilde, typisk `createScreenshotAdapter(captureRef)` fra
+     * react-native-view-shot. Uten den finnes ikke skjermbilde-steget (DD-26) —
+     * og det finnes uansett ikke når `screenshotsEnabled` er av (K18).
+     */
+    screenshot?: ScreenshotAdapter;
 }): React.JSX.Element;
 /**
  * Klienten og `open` fra nærmeste {@link InnspelProvider}.
@@ -284,6 +346,24 @@ declare function InnspelProvider({ client, children, theme, colorScheme, tenantN
  */
 declare function useInnspel(): InnspelKontekst;
 
+/**
+ * Merk det som aldri skal være med på et skjermbilde (DD-39): navn i en liste,
+ * et kontonummer, en samtale. Pakk det inn, og widgeten maskerer det FØR
+ * innsenderen ser forhåndsvisningen — som «Maskert av appen», og penselen kan
+ * ikke oppheve det. Din kode er sannheten, ikke brukerens presisjon.
+ *
+ * Uten skjermbilde-adapter gjør komponenten ingenting utover å rendre barna.
+ *
+ * @example
+ * ```tsx
+ * <InnspelPrivate><Text>{bruker.navn}</Text></InnspelPrivate>
+ * ```
+ */
+declare function InnspelPrivate({ children, style }: {
+    children?: React.ReactNode;
+    style?: StyleProp<ViewStyle>;
+}): React.JSX.Element;
+
 /**
  * Formen på lagringspakkene i React Native-økosystemet: AsyncStorage, MMKV med
  * async-fasade, expo-secure-store. Alle tre har disse tre metodene.
@@ -388,6 +468,26 @@ declare const tekst: {
     readonly kontekstAldri: "Aldri: navn, e-post, telefon, posisjon eller det som står på skjermen.";
     readonly lenketTil: (tittel: string) => string;
     readonly fjernLenke: "Fjern lenken til den kjente feilen";
+    readonly leggVedSkjermbilde: "Legg ved skjermbilde";
+    readonly leggVedHint: "Bildet tas først når du trykker — du ser det før det sendes.";
+    readonly skjermbildeTittel: "Se over bildet";
+    readonly skjermbildeUnder: "Bildet ble tatt da du trykket. Det du maskerer, ser vi aldri.";
+    readonly maskering: "Maskering";
+    readonly maskerFelt: "Masker felt";
+    readonly tegnOver: "Tegn over";
+    readonly maskerAllTekst: "Masker all tekst";
+    readonly maskertAvAppen: "Maskert av appen";
+    readonly maskertAvAppenHint: "Registrert privat view. Penselen kan ikke oppheve den.";
+    readonly dittStrok: "▲ ditt strøk — maskert (kan angres med ett trykk)";
+    readonly allTekstHint: "Hele bildet er gjort uskarpt så tekst ikke kan leses. Layouten er synlig.";
+    readonly fjernBildet: "Fjern bildet";
+    readonly leggVedOgFortsett: "Legg ved og fortsett";
+    readonly leggVedHintDD42: "Teksten sendes først; bildet lastes opp for seg.";
+    readonly skjermbildeLagtVed: "Skjermbilde lagt ved — maskert";
+    readonly fjernSkjermbilde: "Fjern skjermbildet";
+    readonly sendHintMedBilde: "Teksten sendes først; bildet lastes opp for seg.";
+    readonly skjermbildeFeilet: "kunne ikke ta skjermbilde. Du kan sende uten.";
+    readonly skjermbildeA11y: (auto: number, egne: number, uskarpt: boolean) => string;
     readonly monsterSpm: {
         readonly email: "Dette ser ut som en e-postadresse. Vil du fjerne den?";
         readonly phone: "Dette ser ut som et telefonnummer. Vil du fjerne det?";
@@ -405,9 +505,16 @@ declare const tekst: {
     readonly kvitteringJaOgsa: "Du får beskjed når den er rettet.";
     readonly saksnummer: (nr: string) => string;
     readonly tilbakeTilAppen: "Tilbake til appen";
+    /** DD-42: saken er sendt, bildet kom ikke med — aldri en blokkert innsending. */
+    readonly kvitteringVedleggFeilet: "Sendt — skjermbildet kunne ikke legges ved";
+    readonly tekstenErLagret: "Teksten din er lagret.";
+    readonly vedleggFeiletBanner: "Bildet ble ikke lastet opp. Saken er sendt uten det — vil du, kan du sende et nytt innspill med bilde.";
+    readonly saksnummerUtenVedlegg: (nr: string) => string;
     readonly offlineTittel: "Ingen nett";
     readonly offlineBanner: "Ingen nett. Lagres og sendes automatisk — du ser det under «Mine innspill» til det er sendt.";
     readonly offlineLagre: "Lagre — sendes automatisk";
+    /** DD-41: et skjermbilde køes aldri. */
+    readonly offlineUtenBilde: "Skjermbilde kan ikke legges ved uten nett. Teksten sendes; bildet ble ikke lagret.";
     readonly sendefeilBanner: (arsak: string) => string;
     readonly provIgjen: "Prøv igjen";
     readonly mineTittel: "Mine innspill";
@@ -441,4 +548,4 @@ declare const lofte: {
     readonly avvist: "Vi har svart på denne.";
 };
 
-export { type AsyncStorageLike, type InnspelColors, InnspelProvider, type InnspelTheme, type PartialTheme, type StatusVisning, type Tema, byggTema, createMemoryStorage, createStorage, t as darkTokens, light, lofte, screenRules, statusVisning, tekst, useInnspel, useTema, venterVisning };
+export { type AsyncStorageLike, type CaptureOptions, type CaptureRefFn, type InnspelColors, InnspelPrivate, InnspelProvider, type InnspelTheme, type PartialTheme, type ScreenshotAdapter, type ScreenshotCapture, type StatusVisning, type Tema, byggTema, createMemoryStorage, createScreenshotAdapter, createStorage, t as darkTokens, light, lofte, screenRules, statusVisning, tekst, useInnspel, useTema, venterVisning };