VSinerva/freesewing
1
0
Fork 0
Code Activity

fix(dev/docs): Add expand setting

Browse source
This commit is contained in:
Benjamin Fan 2025-05-23 20:05:28 -07:00 • committed by Joost De Cock
parent f903929a0a
commit 19397c1c6e
3 changed files with 78 additions and 33 deletions
Download patch file Download diff file Expand all files Collapse all files

13
sites/dev/docs/reference/api/part/draft/readme.mdx
View file

@ -14,24 +14,25 @@ The draft method receives a single parameter, an object which you can _destructu
access the following properties:
| Property | Description |
| --------:|:----------- |
|| **_Content constructors_** |
| ----------------: | :------------------------------------------------------------------------------------------------------------ |
| | **_Content constructors_** |
| `Path` | A [Path constructor](/reference/api/path) to create new paths |
| `Point` | A [Point constructor](/reference/api/point) to create new points |
| `Snippet` | A [Snippet constructor](/reference/api/snippet) to create new snippets |
|| **_Content containers_** |
| | **_Content containers_** |
| `paths` | Add a Path to your part by adding it to this object |
| `points` | Add a Points to your part by adding it to this object |
| `snippets` | Add a Snippet to your part by adding it to this object |
|| **_Access to settings_** |
| | **_Access to settings_** |
| `absoluteOptions` | Access to `settings.absoluteOptions` |
| `complete` | Access to `settings.complete` |
| `expand` | Access to `settings.expand` |
| `measurements` | Access to `settings.measurements` |
| `options` | Access to `settings.options` |
| `paperless` | Access to `settings.paperless` |
| `sa` | Access to `settings.sa` |
| `scale` | Access to `settings.scale` |
|| **_Access to utilities_** |
| | **_Access to utilities_** |
| `context` | Allows access to the pattern object and other things higher in the tree |
| `getId` | See [the getId documentation](/reference/api/part/getid) |
| `log` | See [the Store Methods documentation](/reference/store-methods#store-methods-we-maintain) |
@ -40,7 +41,7 @@ access the following properties:
| `units` | A version of [`utils.units()`](/reference/api/utils/units) that is preconfigured with the user's chosen units |
| `utils` | See [the utils documentation](/reference/api/utils) |
| `Bezier` | The [bezier-js](https://pomax.github.io/bezierjs/) library's `Bezier` named export |
|| **_Return value_** |
| | **_Return value_** |
| `part` | Your draft method **must** return this |
:::tip

44
sites/dev/docs/reference/settings/expand/readme.mdx Normal file
View file

@ -0,0 +1,44 @@
---
title: expand
---
The `expand` setting controls whether all parts should be fully
drawn in a pattern.
Set `expand` to `false` when the pattern should instead omit parts and/or
draw abbreviated parts.
Omitting parts and using abbreviated parts saves space and paper
in printed patterns.
Typically, this is done for parts that are simple shapes like
rectangles or that can be cut on the fold.
## Signature
```js
const settings = {
Boolean expand=true
}
```
The default `expand` setting is `true`.
Set this to `false` to draft a pattern with omitted or abbreviated parts,
rather than with fully-drawn parts.
## Example
```js
import { Aaron } from '@freesewing/aaron'
const pattern = new Aaron({
expand: false,
})
```
## Notes
The `expand` setting does not automatically cause pattern parts to
be omitted or abbreviated.
Instead, it is up to the pattern designer to have the design
check for the `expand` setting,
include all, full parts if set to `true`,
and omit or abbreviate relevant parts if set to `false`.

2
sites/dev/docs/reference/settings/readme.mdx
View file

@ -13,6 +13,7 @@ Object settings = {
Object absoluteOptions,
Boolean complete=true,
Boolean embed=false,
Boolean expand=true,
String idPrefix='fs-',
Object|Boolean layout=true,
String locale='en',
@ -51,4 +52,3 @@ new pattern([
},
])
```