safari-internal-js/DEV.md at b68eb4accb51bb328fe437453673aaa4c317ca84

noham/safari-internal-js

Fork 0

mirror of https://github.com/NohamR/safari-internal-js.git synced 2026-02-21 18:35:43 +00:00

Files

√(noham)² b68eb4accb Add 26.2 versioned JS files and move 15.7 files

2026-01-17 14:46:26 +01:00

9.8 KiB

Raw Blame History

Password & Form Autofill System

AutomaticPasswords.js

Manages Safari's automatic strong password generation:

Removes auto-generated passwords from password fields
Controls visibility of suggested strong passwords
Handles focus/blur events when users interact with password fields
Manages the "autofilled" state of password inputs

FormMetadata.js

The brain of Safari's form autofill system:

Form Detection & Classification: Identifies login forms, signup forms, password change forms, and standard forms
Smart Field Recognition: Uses pattern matching, element positioning, visual analysis, and machine learning-like scoring to identify:
- Username fields
- Password fields (current, new, confirm)
- Credit card fields (number, CVV, expiration, cardholder)
- Address fields (street, city, postal code)
- Phone numbers (split across multiple fields)
- Email addresses
- One-time codes (2FA)

FormMetadataClassification.js

Intelligently classifies form fields to enable autofill:

Identifies field types: credit cards, names, addresses, phone numbers, emails, birthdays, passwords, etc.
Handles multi-part fields: splits fields like "First Name | Last Name" or phone numbers across multiple inputs
Continuation detection: recognizes when a single piece of data (like credit card number) is split across multiple fields
Uses multiple signals: autocomplete attributes, field names, placeholders, sizes, and positioning
Date field parsing: understands various date formats and splits (day/month/year)
Smart matching: uses pattern recognition to classify fields even without explicit HTML hints

FormMetadataContactsAutoFillMappings.js (New in 26.2)

Mappings between form fields and Contacts data:

Defines relationships between HTML form fields and Contact card properties
Maps autofill field types to vCard/Contacts attributes
Handles address components (street, city, state, postal code)
Contact information mapping (name, email, phone, organization)
Enables seamless autofill from Contacts app

FormMetadataJSController.js (New in 26.2)

JavaScript bridge for form metadata operations:

Provides communication layer between native code and web content
Manages form field metadata collection and updates
Coordinates autofill operations across different contexts
Handles form submission and validation events

FormMetadataUtilities.js (New in 26.2)

Utility functions for form processing:

Helper functions for form element analysis
Field value normalization and validation
Common patterns for field identification
Shared utilities used across form metadata modules

PasswordRulesParserJS.js (New in 26.2)

Parses password requirement rules:

Implements password rules format parsing (as per WHATWG spec)
Interprets password requirements from websites
Generates strong passwords that meet specific site requirements
Handles character classes (uppercase, lowercase, digits, special)
Validates password constraints (min/max length, required/allowed characters)

NodePath.js

Creates stable references to DOM elements:

Path-based element identification: creates a "fingerprint" for DOM nodes that works even when the DOM changes
Fuzzy matching: uses similarity scoring (Levenshtein distance) to relocate elements after page updates
Handles shadow DOM and iframes: traverses across shadow boundaries and iframe documents
Range support: can reference text selections, not just elements
Resilient resolution: uses multiple strategies (CSS selectors, position, attributes) to find elements

Reader Mode System

Reader.html

The HTML template that powers Safari's Reader Mode interface:

Complete CSS styling: 1300+ lines of carefully crafted styles for article display
AI Summary UI: Collapsible summary sections with smooth animations and expand/collapse controls
Table of Contents: Sidebar navigation with styled list items and separators
Theme support: CSS variables for White, Sepia, Gray, and Night themes
Responsive typography: Styles for headings, paragraphs, blockquotes, figures, and captions
Watch support: Specialized styles for Apple Watch display
Rich content styling: Tables, code blocks, pull quotes, and floating images
Accessibility: Proper focus states and interactive button styling

Reader.js

Powers Safari's Reader Mode core functionality:

Manages visibility transitions for Reader view
Handles iframe URL caching/restoration when entering/exiting Reader
Checks JavaScript enablement settings
Mac-specific UI adjustments

ReaderArticleFinder.js (~3500 lines)

Safari's article detection and cleaning algorithm (similar to Mozilla's Readability):

Article Detection Strategies:

Schema.org metadata (<article itemtype="Article">)
OpenGraph tags (<meta property="og:type" content="article">)
Visual examination (hit-testing specific screen coordinates)
Quirks list for known sites (NYTimes, Medium, etc.)

Scoring System:

Text density analysis
Link density (fewer links = more likely article)
Tag names (article, main, section boost score)
Class names ("article", "content" boost; "comment", "sidebar" reduce)
Position on page
Font consistency

Smart Cleaning:

Removes ads, comments, navigation
Keeps images, videos, tweets
Converts lazy-loaded images
Preserves tables and code blocks
Handles multi-column layouts
Detects CJK (Chinese, Japanese, Korean) text using Unicode ranges

ReaderShared.js (New in 26.2)

Shared utilities for Reader Mode:

Common functions used across Reader Mode components
Text processing and article content utilities
DOM manipulation helpers specific to Reader Mode
Coordinate Reader behavior between different modules

ReaderSharedUI.js

Powers the actual Reader Mode interface:

Layout Management:

Multi-column pagination for long articles
Responsive design adapting to window size
12+ font families (System, Charter, Georgia, Iowan, Palatino, etc.)
4 themes: White, Sepia, Gray, Night
12 text size levels with custom line heights per font

Interactive Features:

Smooth scrolling with animations
Content-aware navigation (stops at natural break points)
Next page auto-loading for paginated articles
Print/email formatting
Reading position memory
Table of Contents generation from headings
AI-generated summary display with collapsible UI
Sidebar for TOC/summary on wide screens

ReaderSharedUINormalWorld.js

Enhances Reader Mode with rich content:

Twitter/X integration: replaces simple tweet embeds with rich Twitter widgets
Loads Twitter's widget JavaScript on demand
Handles transition from placeholder tweets to interactive embeds