-- import: amitu.com/lib


-- lib.amitu: Hello World! 😀

-- lib.amitu:

you can also write multiline messages easily!

no quotes. and **markdown** is *supported*.

import {amitu} from './lib.js'

<amitu>Hello World! 😀</amitu>

<amitu>

you can also write multiline messages easily!

no quotes. and **markdown** is *supported*.

</amitu>

-- ws.page:

-- ws.hero-with-image: We transform ideas into digital outcomes.
cta-primary: Learn More
cta-primary-link: #about
image: $assets.files.assets.landing.png

We are an award-winning strategic design company that provides consultancy
services and help you create outstanding digital products.

... rest of code omitted ...

-- end: ws.page

-- foo:

-- component foo:

.. body omitted ..

-- end: foo

-- foo:
title: hello

-- component foo:
string title:

.. body omitted ..

-- end: foo

-- foo:
title: hello

-- foo: hello

-- component foo:
caption title:

.. body omitted ..

-- end: foo

-- foo:
title: hello

-- foo: hello

-- record person:
caption name:
string location:
optional body bio:

-- person amitu: Amit Upadhyay
location: Bangalore, India

Amit is the founder and CEO of FifthTry.

He loves to code, and is pursuing his childhood goal of
becoming a professional starer of the trees.

-- component bar:
children c:

.. body omitted ..

-- end: bar

-- bar:

-- foo: hello

this is the "body of foo"

-- end: bar

-- component page:
optional body b:
children c:

.. body omitted ..

-- end: bar

-- page:

this is the "body of page"

;; children of page
-- foo: hello

this is the "body of foo"

-- end: page

-- import: lib
exposing: pricing-page, pricing-card

-- pricing-page: Our Startup Offers Excellent Prices
annual-discout: 10%

Thousands of customers trust us for their daily image
manipulation needs, you can join them by selecting one
of the plans we offer.

-- pricing-plan: Free Plan
price: 0

You can use free plan forever, but there would be a
water mark.

-- pricing-plan: Pro Plan
price: 10

Pro plan offers you a water mark free version.

-- end: pricing-page

-- import: fastn

-- fastn.package: acme.fastn.com
favicon: /-/acme.fastn.com/favicon.ico

-- fastn.dependency: fastn-community.github.io/midnight-storm as theme

.. other dependencies snipped ..

-- fastn.auto-import: acme.fastn.com/FASTN/ws

.. rest of file omitted ..

-- import: fastn.com/rfcs/lib

-- lib.rfc: RFC-4: Incremental Build
id: 0004-incremental-build
status: accepted

In this RFC we propose persisting build metadata on every
`fastn build`. This will enable as to only rebuild only
the minimum number of files needed in the output directory,
and will significantly cut down build time.


-- lib.motivation:

Current we rebuild every document present in current package,
and recreate entire `.build` folder. If we have cache metadata
about the previous, we can do incremental build, and achieve
much faster builds.


-- lib.detailed-design:

We will create a new cache data, `build-cache.json`, which will
contain the following information:

.. rest of detailed design omitted ..

-- lib.teaching-notes:

The feature itself requires no training as this is an internal
optimisation.

Confiruing CI systems to preserve build cache across builds is
required. We will be updating our fastn-template Github Action
to include build caching. We will also have to write blog post
on how to enable build caching on Vercel, and other hosting
providers who give caching.


-- lib.unresolved-questions:

There are no known unresolved questions right now.


-- end: lib.rfc

- Start Date: 2014-03-11
- RFC PR: [rust-lang/rfcs#1](https://github.com/rust-lang/rfcs/pull/1)
- Rust Issue: [rust-lang/rust#8122](https://github.com/rust-lang/rust/issues/8122)

# Summary

This is an RFC to make all struct fields private by default.
This includes both tuple structs and structural structs.

# Motivation

Reasons for default private visibility..

-- lib.rfc: RFC-4: Incremental Build
id: 0004-incremental-build
status: accepted

In this RFC we propose persisting build metadata on every
`fastn build`. This will enable as to only rebuild only
the minimum number of files needed in the output directory,
and will significantly cut down build time.

-- component rfc:
;; the title of the RFC
caption title:
;; each rfc should have a unique slug
string id:
;; short summary of the RFC
body short:
;; possible values: proposal, accepted, rejected and
;; open-questions. `open-questions` means RFC has been
;; reviewed, but some open questions have been found
;; and RFC has to be updated. Once RFC has been updated
;; it can go back to `proposal` state.
string status: proposal
children c:

-- ds.page: $rfc.title

$rfc.short

-- note.note: This is a RFC document

This document exists to describe a proposal for enhancing the
`fastn` language. This is a Request For Comment. Please share
your comments by posting them in the pull request for this RFC
if this RFC is not merged yet. If the RFC is merged, you can
post comment on our [official
Discord](https://fastn.com/discord/), or open a [discussion on
Github](https://github.com/orgs/fastn-stack/discussions).

.. snip ..

-- ds.h2: Status

$rfc.status



-- ftd.column:
width: fill-container
children: $rfc.c

-- end: ftd.column

-- end: ds.page

-- end: rfc

-- integer x: 10

-- ftd.integer: $x

-- import: <package-name>/foo

-- ftd.text: hello world
padding.px: $foo.x

;; non mutable variable
-- integer x: 10

;; mutable variable: $ prefix in declaration => mutable
-- integer $y: 20

-- void incr(a,by):
integer $a:
integer by: 1

a = a + by

-- integer $x: 10

-- ftd.integer: $x
role: $inherited.types.heading-medium
$on-click$: $incr($a=$x)

-- ftd.integer: $x
role: $inherited.types.heading-medium
$on-click$: $incr($a=$x, by=3)
color: red
color if { x % 2 == 0 }: green

-- integer add(a,b):
integer a:
integer b:

a + b

;; y is defined in terms of `x` and is a "formula"
-- integer y: $add(a=$x, b=1)

-- ftd.integer: $x
role: $inherited.types.heading-medium
$on-click$: $incr($a=$x)
color: orange
color if { y % 2 == 0 }: purple

-- boolean $show: false

-- ftd.text: hello
if: { show }

.. some other UI that toggles `show`

-- person list $people:

-- person: Amit Upadhyay
title: CEO

-- person: Arpita Jaiswal
title: Senior Software Engineer

-- end: people

-- show-person: $p
for: p in $people

.. some UI that mutates $people

-- import: fastn/processors

-- string username:
$processor$: processors.request-data

-- repo list repos:
$processor$: processors.pg
limit: 20

SELECT
*
FROM
repos
WHERE
username = $username::TEXT
LIMIT $limit::INTEGER;

-- string username: $fastn.request-data("username")
-- repo list repos: $fastn.pg(query="multi line query", limit=20, username=$username)

-- string username: $fastn.request-data("username")
-- repo list repos: {
fastn.pg(
"multi line query",
limit=20,
username=$username
)
}

-- or-type lead:

-- person person:

-- record company:
caption name:
string contact:
string fax:

-- end: lead

-- lead.person l: $amitu

-- lead list leads:

-- lead.person: John Doe
title: Senior Designer

John loves to design.

-- lean.company: Acme, Inc.
contact: Bugs Bunny
fax: +1 (555) 12333123

-- end: leads

-- or-type length:

-- integer px:

-- constant string fill-parent: Fill Parent

-- end: length

-- length.px l1: 20

-- length l2: fill-parent

-- match: l1
exhaustive: false

-- ftd.integer: $v
case: length.px as $v

-- end: match

-- record type-data:
ftd.responsive-type heading-large:
ftd.responsive-type heading-medium:
ftd.responsive-type heading-small:
ftd.responsive-type heading-hero:
ftd.responsive-type heading-tiny:
ftd.responsive-type copy-small:
ftd.responsive-type copy-regular:
ftd.responsive-type copy-large:
ftd.responsive-type fine-print:
ftd.responsive-type blockquote:
ftd.responsive-type source-code:
ftd.responsive-type button-small:
ftd.responsive-type button-medium:
ftd.responsive-type button-large:
ftd.responsive-type link:
ftd.responsive-type label-large:
ftd.responsive-type label-small:

-- record responsive-type: ;; ftd.responsive-type
caption ftd.type desktop:
ftd.type mobile: $responsive-type.desktop

-- record type:  ;; ftd.type
optional ftd.font-size size:
optional ftd.font-size line-height:
optional ftd.font-size letter-spacing:
optional integer weight:
optional string font-family:

-- ftd.integer: $x
role: $inherited.types.heading-medium

-- record color-scheme:
ftd.background-colors background:
ftd.color border:
ftd.color border-strong:
ftd.color text:
ftd.color text-strong:
ftd.color shadow:
ftd.color scrim:
ftd.cta-colors cta-primary:
ftd.cta-colors cta-secondary:
ftd.cta-colors cta-tertiary:
ftd.cta-colors cta-danger:
ftd.pst accent:
ftd.btb error:
ftd.btb success:
ftd.btb info:
ftd.btb warning:
ftd.custom-colors custom:

-- record background-colors:
ftd.color base:
ftd.color step-1:
ftd.color step-2:
ftd.color overlay:
ftd.color code:

.. and so on ..

-- ftd.integer: $x
role: $inherited.types.heading-medium
color: $inherited.colors.text

-- import: fastn-community.github.io/dark-flame-cs
-- import: fifthtry.github.io/fastn-io-typography as ft-typography

;; the top level document is usually `ftd.document`

-- ftd.document:
ftd.type-data types: $ft-typography.types
ftd.color-scheme colors: $dark-flame-cs.main

.. rest of your document ..

-- end: ftd.document

-- import: package.that/is-interface as the-interface

-- component foo:
module theme: the-interface

-- foo.theme.yo: this is yo

`the-interface` defined a component called `yo` that
we are calling.

-- end: foo

-- import: package.that/is-interface as the-interface

-- component foo:

-- the-interface.yo: this is yo

`the-interface` defined a component called `yo` that
we are calling.

-- end: foo

-- import: some-package/the-interface as implementer

-- foo:
theme: implementer

-- fastn.dynamic-urls:

# User Profile Page
url: /<string:username>/
document: profile.ftd

-- import: fastn/processors as pr

-- string username:
$processor$: pr.request-data

-- ftd.text: $data.message

-- import: fastn/processors as pr

-- person people:
$processor$: pr.pg

SELECT * FROM users where username = $username::TEXT;

;; let's say the person object we got has a `is-blocked`
;; field, these user's should not be shown
-- ftd.redirect: /
if: { person.is-blocked }

-- import: fastn/processors as pr

-- string username:
$processor$: pr.request-data

-- person p:
$processor$: pr.pg

SELECT * FROM users where username = $username::TEXT;

;; let's say the person object we got has a `is-blocked`
;; field, these user's should not be shown
-- ftd.redirect: /
if: { p.is-blocked }

-- show-person: $p

;; must match `users` table definition
-- record person:
integer id:
string username:
string name:
boolean is-blocked:
optional string bio:

-- component show-person:
person caption $p:

.. body omitted ..

-- end: show-person