Commit 6b75f557 authored by Kourser's avatar Kourser
Browse files

feat: annoter au doigt, écrire des notes, signer

« Je veux aussi pouvoir faire des annotations au doigt » : non, ça ne
l'était pas. `PKCanvasView.default` veut dire « Pencil seulement dès
qu'un Pencil est appairé », donc sur un iPad avec un Pencil le doigt
était refusé sans que rien ne le dise. C'est maintenant un réglage, et
il tient d'une session à l'autre.

Les notes et la signature n'existaient pas non plus.

Une note se pose en touchant la page, s'écrit au clavier, se relit et se
modifie en touchant son repère jaune. Elle part dans le PDF comme
annotation de texte : n'importe quel lecteur la rouvrira.

La signature se trace une fois — au doigt ou au Pencil, toujours les
deux, parce que quelqu'un qui signe dans un café n'a pas de stylet — et
s'appose d'un tap. On signe de la même manière à chaque fois ;
redessiner son nom à chaque contrat donne quatre personnes
différentes. Elle est rangée hors de toute bibliothèque, puisqu'elle
appartient à la personne et pas au document, et porte son propre nom
d'annotation pour que « tout effacer » l'épargne : effacer un
gribouillage ne doit pas dé-signer un contrat en silence.

Un défaut corrigé en vérifiant à l'écran : la page derrière le canevas
est une image rendue une fois, donc on apposait sa signature et il ne
se passait rien jusqu'à la sortie du mode. Elle est redessinée à chaque
changement d'annotation.

Et un défaut de l'étape précédente, réparé ici : StampAnnotation
dessinait dans les bornes de la page plutôt que dans les siennes, ce
qui allait pour un gribouillage couvrant la feuille et aurait étalé une
signature sur tout le document.

Vérifié à l'écran : note jaune posée et remplie au clavier, signature
tracée au doigt puis apposée, les deux présentes dans le lecteur après
sortie du mode.

Co-Authored-By: default avatarClaude Opus 5 <noreply@anthropic.com>
parent c826f7a5
Loading
Loading
Loading
Loading
+13 −0
Changes for CHANGELOG.md: 13 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -8,6 +8,19 @@ adopte le [versionnage sémantique](https://semver.org/lang/fr/).
## [Non publié]

### Ajouté
- Trois outils d'annotation PDF au lieu d'un : dessin, note tapée au clavier,
  signature.
- Le dessin au doigt se règle. `PKCanvasView.default` refuse le doigt dès
  qu'un Pencil est appairé : quelqu'un qui veut annoter du pouce dans le train
  le dit une fois dans les options, et ça tient.
- Une note se pose en touchant la page, s'écrit au clavier, se relit et se
  modifie en touchant son repère jaune. Elle est écrite dans le PDF comme
  annotation de texte, donc elle s'ouvre dans n'importe quel lecteur.
- Signature : tracée une fois, au doigt ou au Pencil, gardée, puis apposée
  d'un tap. On signe toujours de la même manière ; redessiner son nom à chaque
  contrat donne quatre personnes différentes. Elle est rangée hors de toute
  bibliothèque — elle appartient à la personne, pas au document — et porte son
  propre nom d'annotation pour que « tout effacer » l'épargne.
- Objectif de lecture quotidien, en minutes. Une page n'est pas une unité — elle
  change avec la taille du texte, l'appareil et le livre — alors qu'une minute
  est la même partout, et c'est la seule mesure qui compte aussi bien la
+13 −0
Changes for Packages/Core/Sources/PodbookUI/Reader/PDFMarkupStore.swift: 13 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -5,6 +5,19 @@ import Observation
import PencilKit
#endif

/// The names Podbook puts on the annotations it writes into a PDF.
///
/// Declared here rather than beside the drawing code because they are plain
/// strings with no PencilKit in them, and because « tout effacer » needs to
/// tell a scribble from a signature on any platform.
public enum PDFMarkupNames {
    /// A page's drawn marks, replaced wholesale on each pass.
    public static let markup = "podbook.markup"
    /// A signature, spared by « tout effacer » — erasing a scribble should
    /// not quietly unsign a contract.
    public static let signature = "podbook.signature"
}

/// Pencil strokes drawn on a PDF, kept so they can be taken up again.
///
/// Two copies of the same marks exist, on purpose, and they answer different
+374 −13

File changed.

Preview size limit exceeded, changes collapsed.

+67 −0
Changes for Packages/Core/Sources/PodbookUI/Reader/SignatureStore.swift: 67 added lines, 0 removed lines.
Original line number Diff line number Diff line
import Foundation
import Observation

#if canImport(PencilKit)
import PencilKit
#endif

/// The signature, drawn once and reused.
///
/// Signing a document is not drawing on it: you sign the same way every time,
/// and redrawing your name for each contract is how signatures end up looking
/// like four different people. So it is captured once, kept, and placed.
///
/// It lives apart from any book: a signature belongs to the person, not to a
/// PDF.
@MainActor
@Observable
public final class SignatureStore {
    public private(set) var hasSignature: Bool = false

    private let file: URL

    public init(root: URL? = nil) {
        let base: URL
        if let root {
            base = root
        } else {
            let support = FileManager.default.urls(for: .applicationSupportDirectory, in: .userDomainMask).first
                ?? FileManager.default.temporaryDirectory
            base = support.appendingPathComponent("Podbook/Signature", isDirectory: true)
        }
        try? FileManager.default.createDirectory(at: base, withIntermediateDirectories: true)
        file = base.appendingPathComponent("signature.drawing")
        hasSignature = FileManager.default.fileExists(atPath: file.path)
    }

    public func data() -> Data? {
        try? Data(contentsOf: file)
    }

    public func save(_ data: Data) {
        try? data.write(to: file, options: .atomic)
        hasSignature = true
    }

    public func clear() {
        try? FileManager.default.removeItem(at: file)
        hasSignature = false
    }
}

#if canImport(PencilKit)
public extension SignatureStore {
    var drawing: PKDrawing? {
        guard let data = data() else { return nil }
        return try? PKDrawing(data: data)
    }

    func save(_ drawing: PKDrawing) {
        if drawing.strokes.isEmpty {
            clear()
        } else {
            save(drawing.dataRepresentation())
        }
    }
}
#endif
+4 −1
Changes for Packages/Core/Sources/PodbookUI/Stores/ReadingServices.swift: 4 added lines, 1 removed line.
Original line number Diff line number Diff line
@@ -16,6 +16,7 @@ public struct ReadingServices {
    public let annotations: AnnotationStore
    public let stats: ReadingStatsStore
    public let markup: PDFMarkupStore
    public let signatures: SignatureStore

    public init(
        locations: ReadingLocationStore,
@@ -28,7 +29,8 @@ public struct ReadingServices {
        driving: DrivingMode,
        annotations: AnnotationStore,
        stats: ReadingStatsStore = ReadingStatsStore(),
        markup: PDFMarkupStore = PDFMarkupStore()
        markup: PDFMarkupStore = PDFMarkupStore(),
        signatures: SignatureStore = SignatureStore()
    ) {
        self.locations = locations
        self.translator = translator
@@ -41,5 +43,6 @@ public struct ReadingServices {
        self.annotations = annotations
        self.stats = stats
        self.markup = markup
        self.signatures = signatures
    }
}
Loading