Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 9 additions & 27 deletions app/Console/Commands/ReleaseCheckCommand.php
Original file line number Diff line number Diff line change
Expand Up @@ -26,8 +26,8 @@
* `mac.floorVersion` (the 0.77 labels disappear when that is bumped);
* - the iTunes lookup in the `us` storefront against `ios.release.version`,
* `ios.requirements.minVersion` and `ios.price.amount`;
* - the iTunes lookup in the `de` storefront against `ios.storefrontExclusions`:
* `de` is expected to be missing when that list holds `de` or an `EU` entry.
* - the iTunes lookup in each storefront `ios.storefrontExclusions` names,
* where the app is expected to be missing.
*
* It prints one row per comparison and exits non-zero when any differs or any
* source cannot be read, because an unchecked fact is not a checked one.
Expand Down Expand Up @@ -89,13 +89,10 @@ public function handle(PlatformCatalog $platforms, MacReleaseService $releases,
$this->compare('App Store (us)', 'minimum iOS', $this->string($ios['requirements']['minVersion'] ?? null), $missing ?? $this->string($usApp['minimumOsVersion'] ?? null), readable: $us !== null);
$this->compare('App Store (us)', 'price', $this->amount($ios['price']['amount'] ?? null), $missing ?? $this->amount($usApp['price'] ?? null), readable: $us !== null);

$de = $appId !== null ? $this->lookup($appId, 'de') : null;
$this->compare(
'App Store (de)',
'listed',
$this->excludes($ios['storefrontExclusions'] ?? [], 'de') ? 'no' : 'yes',
is_array($de) ? ((int) ($de['resultCount'] ?? 0) > 0 ? 'yes' : 'no') : null,
);
foreach ($this->storefronts($ios['storefrontExclusions'] ?? []) as $country) {
$lookup = $appId !== null ? $this->lookup($appId, $country) : null;
$this->compare("App Store ({$country})", 'listed', 'no', is_array($lookup) ? ((int) ($lookup['resultCount'] ?? 0) > 0 ? 'yes' : 'no') : null);
}

// Before Linux ships no channel holds a package, so its rows would only report what is not there yet.
if ($platforms->isReleased('linux')) {
Expand Down Expand Up @@ -327,26 +324,11 @@ private function appStoreId(PlatformCatalog $platforms): ?string
}

/**
* Whether `storefrontExclusions` leaves out a storefront: its own code
* (`de`), or an entry naming the EU, which holds every EU storefront.
* @return list<string>
*/
private function excludes(mixed $exclusions, string $country): bool
private function storefronts(mixed $exclusions): array
{
if (! is_array($exclusions)) {
return false;
}

foreach ($exclusions as $entry) {
if (! is_string($entry)) {
continue;
}

if (strcasecmp(trim($entry), $country) === 0 || preg_match('/\bEU\b/i', $entry) === 1) {
return true;
}
}

return false;
return is_array($exclusions) ? array_values(array_filter($exclusions, fn(mixed $code): bool => is_string($code) && preg_match('/^[a-z]{2}$/', $code) === 1)) : [];
}

private function string(mixed $value): ?string
Expand Down
50 changes: 11 additions & 39 deletions app/Http/Controllers/IosController.php
Original file line number Diff line number Diff line change
Expand Up @@ -6,45 +6,25 @@
use App\Services\Releases\PlatformCatalog;
use App\Support\Assets\AssetManifest;
use App\Support\Content\ContentRepository;
use Carbon\CarbonImmutable;
use Illuminate\Support\Facades\App;
use Inertia\Inertia;
use Inertia\Response;

/**
* The iPhone and iPad page, `/ios` and `/vi/ios` (sitemap §A.1, §E.5).
*
* It describes the App Store release named in `platforms.json` (1.0, build
* 22) and nothing merged after it. Every fact it states arrives here as a
* prop: the requirement, price, version and App Store URL from
* `platforms.json`, the engine names from `engines.json`, the Safe Mode level
* names and the history and result limits from `facts.json`. The page asks
* GitHub for nothing: the Mac release does not appear on it.
*
* `lcpAsset` preloads the iPad capture under the header, the page's largest
* image. The page renders it and the iPhone capture beside it with priority
* (`<AssetSlot priority>`), although their manifest entries load lazily where
* they appear lower on another page. Null while the capture is a placeholder.
*/
// The App Store release named in platforms.json (sitemap §E.5). The page asks GitHub for nothing.
class IosController extends Controller
{
/**
* The iPad capture's `sizes` in the header row, beside the iPhone slot. The
* page renders the slot with it and the preload is built with it, so both
* pick the same srcset candidate.
*/
public const IPAD_SIZES = '(min-width: 1280px) 904px, (min-width: 1024px) calc(100vw - 376px), (min-width: 640px) calc(100vw - 48px), calc(100vw - 32px)';
// The hero iPad, 75.54% of the content width beside the iPhone; the page renders it with this and the preload is
// built with it, so both pick the same candidate.
public const HERO_SIZES = '(min-width: 1280px) 919px, (min-width: 1024px) calc(75.5vw - 48px), calc(75.5vw - 36px)';

public function __invoke(ContentRepository $content, PlatformCatalog $platforms, SiteFacts $facts, AssetManifest $assets): Response
{
$locale = App::getLocale();
$ios = $platforms->find('ios');
$mac = $platforms->summary('mac');

return Inertia::render('Ios', [
'content' => $content->page('ios', $locale),
'ios' => $ios !== null && ($ios['status'] ?? null) === 'released' ? $this->ios($ios, $platforms, $locale) : null,
'macRequirements' => $mac['requirements'] ?? null,
'ios' => $ios !== null && ($ios['status'] ?? null) === 'released' ? $this->ios($ios, $platforms) : null,
'engines' => $facts->iosEngines($this->stringList($ios['iosEngines'] ?? [])),
'safeModeLevels' => $facts->iosSafeModeLevels(),
'limits' => [
Expand All @@ -53,34 +33,26 @@ public function __invoke(ContentRepository $content, PlatformCatalog $platforms,
],
'links' => $facts->links(),
'organizationProfiles' => $facts->organizationProfiles(),
'ipadSizes' => self::IPAD_SIZES,
'lcpAsset' => $assets->lcpDescriptor('ipad-table-browse', $locale, priority: true, sizes: self::IPAD_SIZES),
'heroSizes' => self::HERO_SIZES,
// A phone hides the iPad, so only a wider screen preloads it.
'lcpAsset' => $assets->lcpDescriptor('ios-hero-ipad', $locale, priority: true, sizes: self::HERO_SIZES, media: AssetManifest::WIDE_MEDIA),
]);
}

/**
* @param array<string, mixed> $ios
* @return array{deviceNames: list<string>, requirements: array{systems: list<string>, minVersion: string, displayVersion: string, releaseName: string|null}|null, appStoreUrl: string|null, free: bool, inAppPurchases: bool, version: string|null, publishedAt: string|null, publishedAtFormatted: string|null}
* @return array{requirements: array{systems: list<string>, minVersion: string, displayVersion: string, releaseName: string|null}|null, appStoreUrl: string|null, free: bool, inAppPurchases: bool}
*/
private function ios(array $ios, PlatformCatalog $platforms, string $locale): array
private function ios(array $ios, PlatformCatalog $platforms): array
{
$summary = $platforms->summary('ios');
$price = is_array($ios['price'] ?? null) ? $ios['price'] : [];
$store = $platforms->destination('ios', 'app-store')['url'] ?? null;
$release = is_array($ios['release'] ?? null) ? $ios['release'] : [];
$published = is_string($release['publishedAt'] ?? null) && preg_match('/^\d{4}-\d{2}-\d{2}$/', $release['publishedAt']) === 1
? CarbonImmutable::createFromFormat('Y-m-d', $release['publishedAt'])->startOfDay()
: null;

return [
'deviceNames' => $summary['deviceNames'] ?? [],
'requirements' => $summary['requirements'] ?? null,
'requirements' => $platforms->summary('ios')['requirements'] ?? null,
'appStoreUrl' => is_string($store) && str_starts_with($store, 'https://') ? $store : null,
'free' => is_numeric($price['amount'] ?? null) && (float) $price['amount'] === 0.0,
'inAppPurchases' => ($price['inAppPurchases'] ?? false) === true,
'version' => is_string($release['version'] ?? null) ? $release['version'] : null,
'publishedAt' => $published?->toDateString(),
'publishedAtFormatted' => $published?->locale($locale)->isoFormat('LL'),
];
}

Expand Down
8 changes: 4 additions & 4 deletions app/Support/Assets/AssetManifest.php
Original file line number Diff line number Diff line change
Expand Up @@ -245,7 +245,7 @@ public function isSupplied(string $id): bool
* preload) and for an image that is not marked `priority`, which loads
* lazily, unless the page passes `$priority`: a placement that renders an
* entry with priority although the entry is not the homepage hero (the
* /ios header, `<AssetSlot priority>`).
* /ios hero iPad).
*
* Each srcset is the first delivered format's, with its MIME type, because
* that is the `<source>` the browser picks in `<picture>`. A browser that
Expand All @@ -259,7 +259,7 @@ public function isSupplied(string $id): bool
*
* @return array{light: list<Preload>, dark: list<Preload>|null}|null
*/
public function lcpDescriptor(string $id, ?string $locale = null, bool $priority = false, ?string $sizes = null): ?array
public function lcpDescriptor(string $id, ?string $locale = null, bool $priority = false, ?string $sizes = null, ?string $media = null): ?array
{
$entry = $this->entry($id);

Expand All @@ -278,8 +278,8 @@ public function lcpDescriptor(string $id, ?string $locale = null, bool $priority
$cropResolved = $crop !== null ? $this->themedSources($crop, $locale) : null;
$themed = $entry['theme'] === 'both' && is_array($resolved[0]['dark'] ?? null);

$describe = function (string $variant) use ($id, $resolved, $crop, $cropResolved, $sizes): array {
$preloads = [$this->preload($id, $resolved, $variant, $crop !== null ? self::WIDE_MEDIA : null, $sizes)];
$describe = function (string $variant) use ($id, $resolved, $crop, $cropResolved, $sizes, $media): array {
$preloads = [$this->preload($id, $resolved, $variant, $crop !== null ? self::WIDE_MEDIA : $media, $sizes)];

if ($crop !== null && $cropResolved !== null) {
$preloads[] = $this->preload($crop, $cropResolved, $variant, self::NARROW_MEDIA);
Expand Down
30 changes: 17 additions & 13 deletions docs/rebuild/design/design-system.md
Original file line number Diff line number Diff line change
Expand Up @@ -1544,23 +1544,27 @@ platform's version, requirement and update line, and the release row only links.

### 8.8 iPhone & iPad (`/ios`)

Sections, ids and slots follow sitemap §A.1 and §A.8.
Rebuilt 2026-11-08 on the grid of Home and the feature pages (§8.1, §8.2): `FeatureHero`, `BandFrame`, `MoreFrame`, `ClosingFrame`.
Ids and slots follow sitemap §A.1 and §A.8.

```
PageHeader H1 · lead (scope: a separate app designed for the phone and tablet, not a copy of the Mac app)
[ App Store badge ] + AvailabilityLine (requirement · free, no in-app purchases)
▒ ios-connection-list (phone, 280) │ ▒ ipad-table-browse (4:3)
Rows one capability each, in order: #databases · #browse · #query · #security · #safe-mode · #ipad · #mac · #automation
phone rows: text cols 1–6 │ ▒ phone (280) cols 8–10 iPad rows: text, then ▒ 4:3 cols 2–11 below
(slots from sitemap §A.8: ios-table-browse, ios-row-edit, ios-query, ios-live-activity, ios-connection-form,
ios-safe-mode-confirm, ipad-two-windows, diagram-icloud-sync, mac-handoff-ios, ios-widgets, ios-shortcuts-add-rows)
#limits Not on iPhone and iPad (list or DataTable from data)
#privacy Share Usage Data is off by default; what is sent · ▒ ios-settings-privacy
Get it App Store badge + a short FAQ
DownloadBand (App Store first on this page)
Hero H1 · one sentence · [ App Store badge ] · requirement line (free, no in-app purchases, iOS and iPadOS 18)
▒ ios-hero-ipad (75.54%) │ gap 5% │ ▒ ios-hero-iphone (19.46%), one baseline, never overlapping
#databases Band: the engines the app opens as linked words (EngineWords, from iosEngines) · Redshift and file notes
Bands #connect · #browse · #query · #safe-mode · #shortcuts · #mac, 40 to 60 words each
iPhone band: title cols 1–3 │ text cols 4–8 │ ▒ framed iPhone cols 9–12, 300 px, right edge
iPad band: title cols 1–3 │ text cols 4–12, then ▒ framed iPad across the band, 1216 px
#mac: the same, with diagram-icloud-sync below
#more Also: What stays on the Mac (#limits) · On iPad (#ipad) · Privacy (#privacy) · Open source
#get one sentence · [ App Store badge ]
```

At 375 the phone slot (240) sits above its text.
- Framed devices are the `framed-device` kind: Apple's frame, light and dark, at their real relative size (the iPhone
is 0.2576 of the landscape iPad's width). Whole screens, never cropped; a soft drop shadow follows the frame's edge.
- The hero devices settle in once on load, like Home's (`.hero-device`); the bands rise into place as they scroll in.
- Below 768 the hero shows the iPhone alone, 240 px wide, and the lazy iPad is never fetched; its preload carries
`(min-width: 768px)`. A band's iPhone sits under its text, 240 px wide (260 px from 768).
- A band whose capture has no file shows its text across the band.

### 8.9 Blog index (`/blog`, `/vi/blog`)

Expand Down
Loading