plutonium 0.65.0 → 0.66.0

data/docs/reference/resource/model.md

@@ -11,25 +11,25 @@ All resource models inherit from `ResourceRecord` (created by `pu:core:install`)
 class Post < ResourceRecord
 end
 
-# Inside a feature package — uses the package's ResourceRecord
+# Inside a feature package: uses the package's ResourceRecord
 module Blogging
   class Post < Blogging::ResourceRecord
   end
 end
 ```
 
-`ResourceRecord` is abstract and inherits from `ApplicationRecord`. Standard ActiveRecord features (associations, validations, scopes, callbacks, attribute macros) all work — Plutonium adds capabilities on top.
+`ResourceRecord` is abstract and inherits from `ApplicationRecord`. Standard ActiveRecord features (associations, validations, scopes, callbacks, attribute macros) all work; Plutonium adds capabilities on top.
 
 ## What `Plutonium::Resource::Record` adds
 
 | Module | Purpose | Section |
 |---|---|---|
-| `HasCents` | Money handling — cents column ↔ decimal accessor | [has_cents](#has-cents) |
+| `HasCents` | Money handling: cents column ↔ decimal accessor | [has_cents](#has-cents) |
 | `Routes` | URL parameter customization (slugs, dynamic params) | [URL routing](#url-routing) |
 | `Labeling` | `to_label` for human-readable record names | [Labeling](#labeling) |
 | `FieldNames` | Field introspection by category | [Field introspection](#field-introspection) |
 | `Associations` | Auto-generated SGID accessors on every association | [SGID accessors](#sgid-accessors) |
-| `AssociatedWith` | Multi-tenant scoping — `Model.associated_with(entity)` | [Tenancy](/reference/tenancy/entity-scoping) |
+| `AssociatedWith` | Multi-tenant scoping: `Model.associated_with(entity)` | [Tenancy](/reference/tenancy/entity-scoping) |
 
 ## Section layout
 
@@ -89,7 +89,7 @@ end
 
 ## `has_cents`
 
-Stores monetary values as integer cents and exposes a decimal virtual accessor. Use this for money — never store decimals directly.
+Stores monetary values as integer cents and exposes a decimal virtual accessor. Use this for money; never store decimals directly.
 
 ```ruby
 class Product < ResourceRecord
@@ -112,16 +112,16 @@ product.price = 10.999
 product.price_cents  # => 1099
 ```
 
-**Currency symbol (`unit:`)** — a `String` is used verbatim (`unit: "£"`); a `Symbol`
+**Currency symbol (`unit:`).** A `String` is used verbatim (`unit: "£"`); a `Symbol`
 names a method read off the record for per-row currencies (`unit: :currency_symbol`
 → `record.currency_symbol`); `false` explicitly renders no symbol. This unit is picked
-up automatically anywhere the value renders as currency — show pages, tables, and
-grid/kanban cards — so you configure it once on the model. A per-display
+up automatically anywhere the value renders as currency (show pages, tables, and
+grid/kanban cards), so you configure it once on the model. A per-display
 `display :price, as: :currency, unit: …` overrides it for that display.
 
 A `has_cents` field also **infers the currency input** on forms: a bare `input :price`
 renders the [currency input](../ui/forms#currency-fields) (number field + unit prefix),
-no `as: :currency` needed — matching the display side.
+no `as: :currency` needed, matching the display side.
 
 Resolution is `display unit → has_cents unit → config default`, where `nil` means
 "not set, keep looking" and `false` means "stop, no symbol". When nothing is set, it
@@ -148,7 +148,7 @@ end
 field :price, as: :decimal   # ✅ virtual name
 ```
 
-Generators sometimes emit the `_cents` name in the policy — fix by hand (and verify `has_cents` is declared on the model).
+Generators sometimes emit the `_cents` name in the policy; fix by hand (and verify `has_cents` is declared on the model).
 :::
 
 ### Options
@@ -176,7 +176,7 @@ product.errors[:price_cents] # => ["must be greater than 0"]
 product.errors[:price]       # => ["is invalid"]
 ```
 
-The framework adds an `after_validation` hook that copies `:invalid` from `price_cents` → `price` automatically — no manual wiring needed.
+The framework adds an `after_validation` hook that copies `:invalid` from `price_cents` → `price` automatically, no manual wiring needed.
 
 ### Introspection
 
@@ -196,7 +196,7 @@ post.to_param  # => "1"      (numeric id)
 # URL: /posts/1
 ```
 
-### `path_parameter` — use a stable column
+### `path_parameter`: use a stable column
 
 Use a column that's unique and human-readable instead of the numeric id:
 
@@ -212,9 +212,9 @@ user.to_param  # => "john_doe"
 User.from_path_param("john_doe")   # finds by username
 ```
 
-`path_parameter` is a class-level macro (private class method). The column you pass MUST be unique — Plutonium uses it for lookup.
+`path_parameter` is a class-level macro (private class method). The column you pass MUST be unique; Plutonium uses it for lookup.
 
-### `dynamic_path_parameter` — SEO-friendly id + slug
+### `dynamic_path_parameter`: SEO-friendly id + slug
 
 Combines the id (for stable lookup) with a slug from another column (for SEO):
 
@@ -230,7 +230,7 @@ article.to_param  # => "42-hello-world"
 Article.from_path_param("42-hello-world")  # extracts "42", finds by id
 ```
 
-The slug is informational — only the id portion is used for lookup, so changing the title doesn't break old URLs.
+The slug is informational: only the id portion is used for lookup, so changing the title doesn't break old URLs.
 
 ## Labeling
 
@@ -262,7 +262,7 @@ end
 
 ## SGID accessors
 
-Every association on a resource model gets Signed Global ID accessors automatically — for secure form submission, API payloads, and hidden fields without exposing database ids.
+Every association on a resource model gets Signed Global ID accessors automatically, for secure form submission, API payloads, and hidden fields without exposing database ids.
 
 ### Singular associations (`belongs_to`, `has_one`)
 
@@ -292,7 +292,7 @@ user.add_post_sgid(sgid)          # append
 user.remove_post_sgid(sgid)       # remove
 ```
 
-These are what `secure_association_tag` uses in forms — see [UI › Forms](/reference/ui/forms).
+These are what `secure_association_tag` uses in forms; see [UI › Forms](/reference/ui/forms).
 
 ## Field introspection
 
@@ -335,11 +335,11 @@ Resolution order, association path requirements, three model shapes, and custom
 
 ## Standard ActiveRecord features
 
-Everything you'd expect works — associations, validations, scopes, callbacks, delegations, `has_rich_text`, `has_secure_token`, `has_one_attached`, etc. Where Plutonium adds twists:
+Everything you'd expect works: associations, validations, scopes, callbacks, delegations, `has_rich_text`, `has_secure_token`, `has_one_attached`, etc. Where Plutonium adds twists:
 
-- **Section ordering** is by convention, not enforcement — pick the right slot in the [layout above](#section-layout) so the file stays scannable.
-- **Compound uniqueness for tenant-scoped resources:** `validates :code, uniqueness: {scope: :organization_id}` — without the scope, uniqueness leaks across tenants.
-- **Keep models thin** — business logic that touches multiple records or has multi-step state changes belongs in [interactions](/reference/behavior/interactions), not model methods.
+- **Section ordering** is by convention, not enforcement: pick the right slot in the [layout above](#section-layout) so the file stays scannable.
+- **Compound uniqueness for tenant-scoped resources:** `validates :code, uniqueness: {scope: :organization_id}`, without the scope, uniqueness leaks across tenants.
+- **Keep models thin**: business logic that touches multiple records or has multi-step state changes belongs in [interactions](/reference/behavior/interactions), not model methods.
 
 ## Nested resources
 
@@ -369,6 +369,6 @@ Override with `self.table_name = "posts"` if you need a shared table.
 
 ## Related
 
-- [Definition](./definition) — controls how the model's fields render
-- [Tenancy › Entity scoping](/reference/tenancy/entity-scoping) — `associated_with`, three model shapes
-- [App › Generators](/reference/app/generators) — `pu:res:scaffold` field syntax
+- [Definition](./definition): controls how the model's fields render
+- [Tenancy › Entity scoping](/reference/tenancy/entity-scoping): `associated_with`, three model shapes
+- [App › Generators](/reference/app/generators): `pu:res:scaffold` field syntax