@innspel/react-native 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Niclas Amundsen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,115 @@
+# @innspel/react-native
+
+Innsendingswidgeten for React Native. Et ark over vertsappen din — aldri en
+flytende knapp over innholdet.
+
+```bash
+npm install @innspel/react-native @innspel/core
+```
+
+`react` og `react-native` er peer-avhengigheter. Widgeten krever ikke Expo, men
+virker i Expo.
+
+## Quickstart
+
+```tsx
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { init } from '@innspel/core';
+import { createStorage, InnspelProvider, useInnspel } from '@innspel/react-native';
+
+const innspel = init({
+  baseUrl: 'https://api.innspel.example',
+  tenantKey: 'ik_pub_xxxxxxxx',
+  identityProvider: hentFeedbackToken,   // eller null = anonym modus
+  storage: createStorage(AsyncStorage),
+  context: { platform: 'ios', appVersion: '1.4.2' },
+});
+
+export default () => (
+  <InnspelProvider client={innspel}>
+    <MinApp />
+  </InnspelProvider>
+);
+```
+
+Åpne widgeten hvor som helst under provideren:
+
+```tsx
+const { open } = useInnspel();
+<Button title="Send innspill" onPress={() => open({ screen: 'Dørlista' })} />;
+```
+
+`screen` er rutens NAVN, aldri data i den. Det styrer hvilke kjente feil
+innsenderen får se før hun skriver.
+
+Utenfor React — en navigasjonshandler, en krasjlytter — bruker du klienten
+direkte: `innspel.openFeedback({ screen: 'Dørlista' })`.
+
+## Token-endepunktet
+
+Det eneste du må bygge selv. Se
+[integrasjonsguiden](../../../docs/sdk/README.md), som viser det med kjørbar
+ES256-kode. `identityProvider: null` er anonym modus — et eksplisitt valg, ikke
+noe du havner i ved å glemme opsjonen.
+
+## Tema
+
+Widgeten arver vertsappens flate. Send det du vil overstyre; resten faller
+tilbake på Innspels eget tema, som er målt mot WCAG AA i begge paletter.
+
+```tsx
+<InnspelProvider
+  client={innspel}
+  colorScheme="light"
+  theme={{ color: { brand: '#E5007D', actionPrimary: '#E5007D' } }}
+  tenantName="Følget"
+>
+```
+
+`tenantName` er navnet som står på svaret i «Mine innspill» — ditt, ikke
+Innspels. Innsenderen skal se hvem som svarte.
+
+`fontFamily` finnes ikke som token: systemfonten er standard i React Native, og
+å sette den ville brutt med appen rundt.
+
+## Hva innsenderen møter
+
+| Skjerm | Hva |
+|---|---|
+| Første valg | «Noe virker ikke» eller «Jeg ønsker meg noe». Aldri et tredje, aldri spørsmål om kategori eller alvorlighet. |
+| 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. |
+| Kvittering | Lover noe konkret, per spor, med saksnummer. Ber aldri om en vurdering av appen. |
+| Mine innspill | Status, løftet som hører til, og svaret fra deg under saken. Det som venter på nett står øverst. |
+
+## Offline
+
+Faller nettet, køes innspillet lokalt — kun teksten. Køen tømmes når widgeten
+åpnes eller nettet kommer tilbake, aldri ved oppstart, og innsenderen ser hele
+tiden at det ligger noe og venter. Taket er 30.
+
+## Tilgjengelighet
+
+Widgeten er en dialog og oppfører seg som en: modal for skjermlesere, lukkes med
+Android-tilbake og ESC, kvitteringen annonseres, og hver trykkflate er minst 48
+punkter. Ikoner er skjult for skjermlesere — etiketten bærer meningen, aldri
+fargen alene.
+
+WCAG 2.1 AA er grønt-kriterium, ikke en ambisjon. Kontrasten måles i
+tema-generatoren, som nekter å skrive tokens under kravet.
+
+## Vedlegg og betaprogram
+
+Skjermbilde med maskering kommer i M1.3, betaprogram-fanen i M3.
+`innspel.programs.list()` finnes allerede i kjernen om du vil bygge din egen.
+
+## Versjoner
+
+Semver fra `0.1.0`. **Før `1.0.0` kan en minor bryte** — pin en eksakt versjon
+om du trenger ro.
+
+## Lisens
+
+MIT. Klientpakkene er permissivt lisensiert fordi koden kjører hos deg og må
+kunne leses og granskes der. Plattformen bak — API, panel og drift — er det ikke.