Merge branch '@ksienkiewicz/docs-fundamentals' into @kacperzolkiewski/docs-api-reference

Author: hejsztynx

docs/docs/fundamentals/core-concepts.md

@@ -16,8 +16,8 @@ and you talk to it through a `ref`.
 
 This is deliberate. Rich text changes constantly - every character, selection
 move and style toggle - and round-tripping all of that through JavaScript state
-would be extremely slow and open to a possible de-synchronization of those states.
-Keeping it native makes the editor fast and stable.
+would be extremely slow and open to a possible de-synchronization of those states
+between the JS and native side. Keeping it in the native makes the editor fast and stable.
 
 In practice this means:
 
@@ -26,6 +26,13 @@ In practice this means:
 
 You never set a `value` prop and re-render to make an edit happen.
 
+:::note
+
+We have one value-setting prop - `defaultValue`. This provides the editor's initial value upon creation,
+so we don't violate the _uncontrolled_ nature of the component here.
+
+:::
+
 ## HTML is the source of truth
 
 The editor's content is HTML. `setValue` and `defaultValue` seeds it with an HTML string,

docs/docs/fundamentals/getting-started.md

@@ -23,7 +23,7 @@ renders the input's output. Both speak HTML - the input
 produces it, the display consumes it.
 
 Not only does this library allow you to apply basic rich text styles you know well,
-like *bold* or _italic_, but also provides more powerful tools like `mentions`, something
+like _bold_ or _italic_, but also provides more powerful tools like _mentions_, something
 you will learn more about in the next chapters.
 
 ## Prerequisites
@@ -60,7 +60,7 @@ The library contains native code, so rebuild your app after installing. On iOS,
 install the pods first:
 
 ```sh
-cd ios && bundler install && bundler exec pod install
+cd ios && pod install
 ```
 
 ### Expo
@@ -103,8 +103,7 @@ Install the package:
   </TabItem>
 </Tabs>
 
-The shipped components share the React Native's API, minus the functionalities a
-browser can't provide. See the _Web support_ guide for what's covered.
+The web version should work right out of the box. Check the details in the Web Support section. 
 
 ## Nightly builds
 

docs/docs/fundamentals/your-first-editor.mdx

@@ -8,7 +8,7 @@ import FirstEditorSrc from '!!raw-loader!@site/src/examples/FirstEditor';
 
 # Your first editor
 
-Let's build a small editor with a button that toggles bold and lights up when
+Let's build a small editor with a button that toggles bold and highlights when
 the current selection is bold. It's just enough to see the two moving parts of
 the library: **calling methods on the input** and **reading its state back**.
 
@@ -34,7 +34,9 @@ export default function App() {
 }
 
 const styles = StyleSheet.create({
-  container: { gap: 12 },
+  container: {
+    gap: 12
+  },
   input: {
     fontSize: 18,
     color: '#232736',
@@ -48,9 +50,6 @@ const styles = StyleSheet.create({
 
 ## Toggling a style
 
-The input is uncontrolled - you don't change its content through props. Instead
-you call methods on it through a `ref` of type `EnrichedTextInputInstance`.
-
 Add a ref and a button that calls `toggleBold`. Each call flips bold on the
 current selection, or arms it for the next characters you type if nothing is
 selected.
@@ -79,7 +78,9 @@ export default function App() {
 }
 
 const styles = StyleSheet.create({
-  container: { gap: 12 },
+  container: {
+    gap: 12
+  },
   input: {
     fontSize: 18,
     color: '#232736',
@@ -103,8 +104,11 @@ const styles = StyleSheet.create({
 });
 ```
 
-Every other style is toggled similarly via `ref` - there's a `toggleItalic`,
-`toggleUnderline`, `toggleH1`, `toggleOrderedList`, and so on.
+:::note
+
+To learn how you can toggle each of the available styles, visit [Basic styles](/rich-text-formatting/basic-styles).
+
+:::
 
 ## Reading the state back
 
@@ -147,7 +151,9 @@ export default function App() {
 }
 
 const styles = StyleSheet.create({
-  container: { gap: 12 },
+  container: {
+    gap: 12
+  },
   input: {
     fontSize: 18,
     color: '#232736',

docs/package.json

@@ -35,7 +35,7 @@
     "react": "19.1.1",
     "react-dom": "19.1.1",
     "react-native": "0.86.0",
-    "react-native-enriched-html": "1.0.1",
+    "react-native-enriched-html": "1.1.0",
     "react-native-web": "0.21.2"
   },
   "resolutions": {

docs/yarn.lock

@@ -7537,7 +7537,7 @@ __metadata:
     react: "npm:19.1.1"
     react-dom: "npm:19.1.1"
     react-native: "npm:0.86.0"
-    react-native-enriched-html: "npm:1.0.1"
+    react-native-enriched-html: "npm:1.1.0"
     react-native-web: "npm:0.21.2"
   languageName: unknown
   linkType: soft
@@ -13292,9 +13292,9 @@ __metadata:
   languageName: node
   linkType: hard
 
-"react-native-enriched-html@npm:1.0.1":
-  version: 1.0.1
-  resolution: "react-native-enriched-html@npm:1.0.1"
+"react-native-enriched-html@npm:1.1.0":
+  version: 1.1.0
+  resolution: "react-native-enriched-html@npm:1.1.0"
   dependencies:
     "@tiptap/core": "npm:3.27.1"
     "@tiptap/extension-blockquote": "npm:3.27.1"
@@ -13319,7 +13319,7 @@ __metadata:
   peerDependencies:
     react: "*"
     react-native: "*"
-  checksum: 10c0/692120bc1bb9bd1698e9d0909d7ec34ef0879b22665da657b27502bb7c86d05fbc3e52981e0d66c6124e779a1844a4e0dde17c7f81932c3fd70e73c43135aeb2
+  checksum: 10c0/2037f347164db268e115207241d2642e15e6713c7fb51d48fd44556c724b69d98e4fe82e4dc99b90ef4208bb319262d072020c85afe7991d8a20fef3b2408e4c
   languageName: node
   linkType: hard