stylegallery 0.1.8 → 0.1.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +4 -2
- package/DOMAINS.md +1 -1
- package/README.md +12 -0
- package/consumer-reference/agent-native/v2/material-registry.json +1 -1
- package/expression/brand-studies.md +2 -2
- package/expression/direction-brief.md +17 -5
- package/expression/directions/nocturne-editorial.md +6 -5
- package/expression/directions/warm-print.md +5 -5
- package/expression/index.md +12 -0
- package/expression/techniques/webgl-hero.md +1 -1
- package/log.md +40 -0
- package/motion/index.md +69 -0
- package/package.json +12 -2
- package/patterns/media-fit/icon-frame.md +1 -1
- package/patterns/viewport-shell/holy-grail.md +7 -0
- package/quality/claim-records/samples.md +1494 -0
- package/quality/claims.md +31 -1
- package/scripts/compiler/cli.mjs +20 -0
- package/scripts/conservator-exhibits.mjs +768 -0
- package/scripts/conservator.mjs +326 -0
- package/scripts/markdown-structure.mjs +45 -0
- package/scripts/pattern-data.mjs +325 -0
- package/scripts/registrar.mjs +323 -0
- package/showcase/README.md +15 -1
package/AGENTS.md
CHANGED
|
@@ -46,10 +46,12 @@ The remaining pattern, CSS, naming, token, checklist, and verification rules app
|
|
|
46
46
|
|
|
47
47
|
Use this route when the task is to make a finished, expressive page (a landing page, brand study, or art-directed experiment) rather than to edit governed knowledge.
|
|
48
48
|
|
|
49
|
-
- Read only [Showcase](showcase/README.md), one [Expression](expression/index.md) direction, and the Expression or [Motion techniques](motion/techniques/scroll-choreography.md) the page needs. Skip governance, lifecycle, provenance, and consumer-reference documents: a showcase work creates no governed record.
|
|
49
|
+
- Read only [Showcase](showcase/README.md), the [Expression Direction Brief](expression/direction-brief.md), one [Expression](expression/index.md) direction, and the Expression or [Motion techniques](motion/techniques/scroll-choreography.md) the page needs. Skip governance, lifecycle, provenance, and consumer-reference documents: a showcase work creates no governed record.
|
|
50
|
+
- Reuse existing assets first: inspect the reference site's media, supplied files, and project assets before building a visual. Create new assets only when the intended result is graphical or vector artwork (icons, diagrams, patterns, abstract graphics, or deliberately vector illustrations). Do not generate photos, video, or realistic product renders, or imitate them with CSS/SVG/canvas stand-ins. If the needed asset is missing, find an existing one or report the missing slot; do not fabricate a replacement to pass a richness check. See [Image Weight](expression/techniques/image-weight.md).
|
|
51
|
+
- Meet the richness floor measured on 49 live homepages ([Measured Expression Benchmarks](expression/measured-benchmarks.md)): existing imagery, an intentional vector graphic, or a live product surface on every screen, never a headline alone on a gradient; a 100-320ms state change on every link, button, card, tab, and media frame; masks, rounded clips, and hairlines instead of soft shadows; display type 3.5-5.5 times the body, not larger.
|
|
50
52
|
- Build in `showcase/<slug>/` with an `index.html` and a `brief.md`. The Layout CSS Authoring, CSS Scope, Class Naming, and Token rules do not apply there. Any property, selector, library, font, or WebGL is allowed.
|
|
51
53
|
- Preview with `bun run showcase:serve`; over SSH, it prints the `ssh -L` command to run on the local machine. Add the work to the hub, `showcase/index.html`, creating the hub with the first work.
|
|
52
|
-
- Layout remains the floor, checked by outcome: run `node scripts/check-showcase.mjs --work <slug
|
|
54
|
+
- Layout remains the floor, checked by outcome: run `node scripts/check-showcase.mjs --work <slug> --richness error` and fix every failure (errors, overflow, focus, reduced motion, contrast, honest actions, hash navigation, short viewports, offscreen loops, offline and no-script reading, empty screens, too few responsive elements, slow link transitions, missing masks or hairlines; see [Showcase QA](showcase/QA.md)). Then review the settled screenshots in `.tmp/showcase/<slug>/` for taste, which the check does not judge.
|
|
53
55
|
- A brand study of a real brand must follow [Brand Studies](expression/brand-studies.md): name the subject, mark the page Unofficial, set `noindex`, and use no copied logos or verbatim copy.
|
|
54
56
|
- Handoff: `consumer_reference: not_applicable` because a showcase work selects no consumer reference record.
|
|
55
57
|
- Promote a value or technique out of a showcase work only by writing it into an Expression or Motion page. Never copy showcase CSS into `patterns/**`.
|
package/DOMAINS.md
CHANGED
|
@@ -30,7 +30,7 @@ This manifest is the source of truth for top-level StyleGallery domains. A domai
|
|
|
30
30
|
| Design Engineering | `design-engineering/index.md` | `design-engineering/interface-craft.md`, `design-engineering/consumer-migration-readiness.md`, `design-engineering/reference-profiles/index.md`, `design-engineering/reference-profiles/governed-local/index.md`, `design-engineering/reference-profiles/external-adaptation/index.md`, `design-engineering/decision-tree.md`, `design-engineering/component-contract.md`, `design-engineering/worked-examples.md`, `design-engineering/state-management/decision-tree.md`, `design-engineering/state-management/index.md`, `design-engineering/state-management/patterns/derived-state.md`, `design-engineering/state-management/patterns/draft-and-baseline.md`, `design-engineering/state-management/patterns/id-selection.md`, `design-engineering/state-management/patterns/identity-reset.md`, `design-engineering/state-management/patterns/latest-request-wins.md`, `design-engineering/state-management/patterns/optimistic-overlay.md`, `design-engineering/state-management/patterns/single-flight.md`, `design-engineering/state-management/patterns/single-owner.md`, `design-engineering/state-management/patterns/submitted-snapshot.md`, `design-engineering/state-management/patterns/unsaved-navigation.md`, `design-engineering/state-management/patterns/url-state.md`, `design-engineering/state-management/patterns/versioned-restore.md`, `design-engineering/state-management/recipes/delete-undo.md`, `design-engineering/state-management/recipes/index.md`, `design-engineering/state-management/recipes/multi-step-form.md`, `design-engineering/state-management/recipes/search-detail.md`, `design-engineering/state-management/recipes/settings-save.md`, `design-engineering/state-management/state-brief.md`, `design-engineering/state-management/verification.md`, `design-engineering/native-interaction-contracts.md`, `design-engineering/text-input-and-internationalization.md`, `design-engineering/loading-and-feedback.md` |
|
|
31
31
|
| Platform Guides | `platform-guides/index.md` | `platform-guides/apple-interaction.md`, `platform-guides/adaptation-workflow.md`, `platform-guides/android-interaction.md`, `platform-guides/windows-interaction.md`, `platform-guides/compatibility-matrix.md`, `platform-guides/adaptive-navigation.md`, `platform-guides/preferences-and-accessibility.md`, `platform-guides/input-and-focus.md` |
|
|
32
32
|
| Design Terminology | `design-terminology/index.md` | `design-terminology/source-kinds.md`, `design-terminology/source-vocabularies.md`, `design-terminology/concept-families.md`, `design-terminology/relation-types.md`, `design-terminology/conflict-cases.md`, `design-terminology/comparison-workflow.md`, `design-terminology/token-semantics.md`, `design-terminology/interaction-semantics.md`, `design-terminology/typography-semantics.md` |
|
|
33
|
-
| Expression | `expression/index.md` | `expression/direction-brief.md`, `expression/brand-studies.md`, `expression/directions/nocturne-editorial.md`, `expression/directions/warm-print.md`, `expression/techniques/gradient-atmosphere.md`, `expression/techniques/grain-and-texture.md`, `expression/techniques/webgl-hero.md` |
|
|
33
|
+
| Expression | `expression/index.md` | `expression/direction-brief.md`, `expression/brand-studies.md`, `expression/directions/nocturne-editorial.md`, `expression/directions/warm-print.md`, `expression/techniques/gradient-atmosphere.md`, `expression/techniques/grain-and-texture.md`, `expression/techniques/webgl-hero.md`, `expression/directions/fintech-clarity.md`, `expression/directions/hardware-catalogue.md`, `expression/directions/developer-tool.md`, `expression/directions/korean-service.md`, `expression/techniques/drawn-products.md`, `expression/techniques/live-product-demos.md`, `expression/techniques/canvas-3d.md`, `expression/study-atlas.md`, `expression/measured-benchmarks.md`, `expression/techniques/image-weight.md`, `expression/techniques/display-type-calibration.md`, `expression/techniques/surface-detail.md` |
|
|
34
34
|
|
|
35
35
|
## Shared Non-Domain Infrastructure
|
|
36
36
|
|
package/README.md
CHANGED
|
@@ -46,6 +46,18 @@ sg context sg:profile/editorial-reference-profile --format json
|
|
|
46
46
|
sg ops --format json
|
|
47
47
|
```
|
|
48
48
|
|
|
49
|
+
Check the gallery's own claims with the Registrar and the Conservator:
|
|
50
|
+
|
|
51
|
+
```sh
|
|
52
|
+
sg registrar
|
|
53
|
+
sg registrar --stale
|
|
54
|
+
sg registrar --unverified
|
|
55
|
+
sg conservator
|
|
56
|
+
sg conservator --pattern sidebar,reel --controls
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
`sg registrar` checks every claim record in `quality/claim-records/` against the [claim template and machine-field rules](quality/claims.md). `--stale` lists records whose review date has passed, and `--unverified` lists records whose verdict is not fully automated. `sg conservator` renders every Layout pattern's documented CSS in Chromium at 320, 768, and 1440 CSS pixels and measures the spatial behavior the pattern doc claims. `--controls` also removes a declaration each pattern depends on and requires the matching measurement to fail. Playwright is installed with the package, but its browser is not. If Chromium is missing, the command reports `browser_missing`; run `npx playwright install chromium`, add `--install-browser`, or use an installed Chrome with `--channel chrome`.
|
|
60
|
+
|
|
49
61
|
Every command writes JSON to stdout. Knowledge results retain their deterministic v1 payloads; `discover` and `ops` also report the local compiler installation. Invalid input returns an error object and a nonzero exit status. See [Agent-Native StyleGallery](consumer-reference/agent-native/README.md) for the frozen knowledge contract, StableRef and VersionID model, MCP resources, and trust boundaries.
|
|
50
62
|
|
|
51
63
|
Compile a website directly through SG after [installing the compiler](scripts/compiler/README.md#setup):
|