@coolon/angular-ui-powerups 12.4.0-alpha.9 → 12.4.0-alpha.90

package/lib/interaction/alert.d.ts

@@ -1,5 +1,11 @@
 export interface Alert {
     title?(): string;
-    content(): string[];
+    color?(): string;
+    content(): string | string[];
     ok(): string;
 }
+export declare namespace Alert {
+    function getContent(alert: Alert): string[];
+    function getTitle(alert: Alert): string;
+    function getColor(alert: Alert): string;
+}

package/lib/interaction/components/abstract-confirm-dialog.component.d.ts

@@ -0,0 +1,7 @@
+import { CommandFace } from '../../components/commands/command-face';
+import { Confirm } from '../confirm';
+import { AbstractDialogComponent } from './abstract-dialog.component';
+export declare class AbstractConfirmDialogComponent<D, R, E = any> extends AbstractDialogComponent<D, R, E> {
+    readonly cancelFace: CommandFace;
+    constructor(config: Confirm);
+}

package/lib/interaction/components/abstract-dialog.component.d.ts

@@ -0,0 +1,17 @@
+import { InjectionToken } from '@angular/core';
+import { CommandFace } from '../../components/commands/command-face';
+import { Activity } from '../activity';
+import { Alert } from '../alert';
+import { Confirm } from '../confirm';
+export declare const ALERT_CONFIG: InjectionToken<any>;
+export declare class AbstractDialogComponent<D, R, E = any> extends Activity<D, R, E> {
+    protected readonly config: Alert | Confirm;
+    readonly confirmFace: CommandFace;
+    readonly title: string;
+    readonly content: string[];
+    readonly color?: 'primary' | 'accent' | 'warn';
+    constructor(config: Alert | Confirm);
+    getConfig(): Alert | Confirm;
+    protected checkColor(rawColor: string): 'primary' | 'accent' | 'warn';
+    isDestructive(): boolean;
+}

package/lib/interaction/components/activity-actions/activity-actions.component.d.ts

@@ -1,5 +1,6 @@
 import { ChangeDetectorRef, OnInit } from '@angular/core';
 import { Command } from '@coolon/pectin';
+import { Enum } from 'typescript-string-enums';
 import { CommandFace } from '../../../components/commands/command-face';
 import { DisposableComponent } from '../../../components/disposable-component';
 /**
@@ -40,9 +41,8 @@ export declare class ActivityActionsComponent extends DisposableComponent implem
      * @deprecated use #faces instead.
      */
     set style(style: ActivityActionsComponent.Style);
-    align: 'start' | 'end' | 'stretch';
-    get alignEnd(): boolean;
-    get alignStretch(): boolean;
+    layout: ActivityActionsComponent.Layout;
+    align: ActivityActionsComponent.Align;
     constructor(cdr: ChangeDetectorRef);
     ngOnInit(): void;
     hasConfirmFace(): boolean;
@@ -53,6 +53,17 @@ export declare class ActivityActionsComponent extends DisposableComponent implem
     }): void;
 }
 export declare namespace ActivityActionsComponent {
+    const Layout: {
+        INLINE: "inline";
+        BLOCK: "block";
+    };
+    type Layout = Enum<typeof Layout>;
+    const Align: {
+        START: "start";
+        END: "end";
+        STRETCH: "stretch";
+    };
+    type Align = Enum<typeof Align>;
     interface Style {
         confirm: CommandFace;
         cancel: CommandFace;

package/lib/interaction/components/activity-triggers/abstract-activity-trigger.component.d.ts

@@ -14,7 +14,7 @@ export declare class AbstractActivityTriggerComponent<D = any, R = any, E = any>
     faceModel: ValueModel<CommandFace>;
     alignFace: HorizontalAlignment;
     readonly startActivityCommand: Command<unknown>;
-    interactionContext: InteractionContext;
+    get interactionContext(): InteractionContext;
     confirmEvent: EventEmitter<R>;
     cancelEvent: EventEmitter<E>;
     constructor();

package/lib/interaction/components/activity-triggers/inline-activity-trigger/inline-activity-trigger.component.d.ts

@@ -1,6 +1,7 @@
 import { InteractionContext } from '../../../interaction-context';
 import { AbstractActivityTriggerComponent } from '../abstract-activity-trigger.component';
 export declare class InlineActivityTriggerComponent<D = any, R = any, E = any> extends AbstractActivityTriggerComponent<D, R, E> {
-    interactionContext: InteractionContext;
+    _interactionContext: InteractionContext;
+    get interactionContext(): InteractionContext;
     constructor();
 }

package/lib/interaction/components/activity-triggers/modal-activity-trigger/modal-activity-trigger.component.d.ts

@@ -2,6 +2,7 @@ import { InteractionContext } from '../../../interaction-context';
 import { InteractionService } from '../../../services/interaction.service';
 import { AbstractActivityTriggerComponent } from '../abstract-activity-trigger.component';
 export declare class ModalActivityTriggerComponent<D = any, R = any, E = any> extends AbstractActivityTriggerComponent<D, R, E> {
-    interactionContext: InteractionContext;
+    _interactionContext: InteractionContext;
+    get interactionContext(): InteractionContext;
     constructor(interactionService: InteractionService);
 }

package/lib/interaction/components/activity-triggers/popup-activity-trigger/popup-activity-trigger.component.d.ts

@@ -3,6 +3,7 @@ import { AbstractActivityTriggerComponent } from '../abstract-activity-trigger.c
 export declare class PopupActivityTriggerComponent<D = any, R = any, E = any> extends AbstractActivityTriggerComponent<D, R, E> {
     anchorX: 'start' | 'end';
     anchorY: 'top' | 'bottom';
-    interactionContext: InteractionContext;
+    _interactionContext: InteractionContext;
     constructor();
+    get interactionContext(): InteractionContext;
 }

package/lib/interaction/components/add-card-activity/add-card-activity.component.d.ts

@@ -0,0 +1,39 @@
+import { OnInit } from '@angular/core';
+import { ListModelChain } from '@coolon/pectin';
+import { Enum } from 'typescript-string-enums';
+import { CommandFace } from '../../../components/commands/command-face';
+import { InteractionContext } from '../../interaction-context';
+import { InteractionService } from '../../services/interaction.service';
+import { AbstractActivityTriggerComponent } from '../activity-triggers/abstract-activity-trigger.component';
+/**
+ *
+ */
+export declare class AddCardActivityComponent extends AbstractActivityTriggerComponent implements OnInit {
+    private modalInteractionContext;
+    inlineInteractionContext: InteractionContext;
+    interactionStyle: AddCardActivityComponent.InteractionType;
+    renderAs: AddCardActivityComponent.RenderAs;
+    notCard: boolean;
+    readonly faceList: ListModelChain<CommandFace>;
+    get renderAsClass(): string;
+    get activityTypeClass(): string;
+    isRenderAsCard(): boolean;
+    isRenderAsButton(): boolean;
+    constructor(interactionService: InteractionService);
+    ngOnInit(): void;
+    get interactionContext(): InteractionContext;
+    isModal(): boolean;
+    isInline(): boolean;
+}
+export declare namespace AddCardActivityComponent {
+    const InteractionType: {
+        MODAL: "modal";
+        INLINE: "inline";
+    };
+    type InteractionType = Enum<typeof InteractionType>;
+    const RenderAs: {
+        CARD: "card";
+        BUTTON: "button";
+    };
+    type RenderAs = Enum<typeof RenderAs>;
+}

package/lib/interaction/components/alert-dialog/alert-dialog.component.d.ts

@@ -1,10 +1,5 @@
-import { OnInit } from '@angular/core';
-import { CommandFace } from '../../../components/commands/command-face';
-import { Activity } from '../../activity';
 import { Alert } from '../../alert';
-export declare class AlertDialogComponent extends Activity<Alert, void> implements OnInit {
-    readonly alert: Alert;
-    readonly confirmFace: CommandFace;
+import { AbstractDialogComponent } from '../abstract-dialog.component';
+export declare class AlertDialogComponent extends AbstractDialogComponent<Alert, void> {
     constructor(alert: Alert);
-    ngOnInit(): void;
 }

package/lib/interaction/components/confirm-then-dialog/confirm-then-dialog.component.d.ts

@@ -1,17 +1,9 @@
-import { OnInit } from '@angular/core';
 import { Constructable } from '@coolon/pectin';
-import { CommandFace } from '../../../components/commands/command-face';
 import { Activity } from '../../activity';
 import { Confirm } from '../../confirm';
-export declare class ConfirmThenDialogComponent<D, R, E> extends Activity<ConfirmThenDialogComponent.Data<D, R, E>, R, E> implements OnInit {
-    readonly config: ConfirmThenDialogComponent.Data<D, R, E>;
-    readonly confirmFace: CommandFace;
-    readonly cancelFace: CommandFace;
+import { AbstractConfirmDialogComponent } from '../abstract-confirm-dialog.component';
+export declare class ConfirmThenDialogComponent<D, R, E> extends AbstractConfirmDialogComponent<ConfirmThenDialogComponent.Data<D, R, E>, R, E> {
     constructor(config: ConfirmThenDialogComponent.Data<D, R, E>);
-    ngOnInit(): void;
-    get confirm(): Confirm;
-    get titleColor(): string;
-    isDestructive(): boolean;
 }
 export declare namespace ConfirmThenDialogComponent {
     interface Data<D, R, E> {

package/lib/interaction/components/confirm-then-execute-dialog/confirm-then-execute-dialog.component.d.ts

@@ -0,0 +1,12 @@
+import { Confirm } from '../../confirm';
+import { InteractionContext } from '../../interaction-context';
+import { AbstractConfirmDialogComponent } from '../abstract-confirm-dialog.component';
+export declare class ConfirmThenExecuteDialogComponent<R, E> extends AbstractConfirmDialogComponent<ConfirmThenExecuteDialogComponent.Data<R, E>, R, E> {
+    constructor(data: ConfirmThenExecuteDialogComponent.Data<R, E>);
+}
+export declare namespace ConfirmThenExecuteDialogComponent {
+    interface Data<R, E> {
+        confirm: Confirm;
+        operation: (interactionContext: InteractionContext) => R | Promise<R>;
+    }
+}

package/lib/interaction/components/confirmation-dialog/confirmation-dialog.component.d.ts

@@ -1,13 +1,6 @@
-import { OnInit } from '@angular/core';
-import { CommandFace } from '../../../components/commands/command-face';
-import { Activity } from '../../activity';
 import { Confirm } from '../../confirm';
-export declare class ConfirmationDialogComponent extends Activity<Confirm, void> implements OnInit {
+import { AbstractConfirmDialogComponent } from '../abstract-confirm-dialog.component';
+export declare class ConfirmationDialogComponent extends AbstractConfirmDialogComponent<Confirm, void> {
     readonly confirm: Confirm;
-    readonly confirmFace: CommandFace;
-    readonly cancelFace: CommandFace;
     constructor(confirm: Confirm);
-    ngOnInit(): void;
-    get titleColor(): string;
-    isDestructive(): boolean;
 }

package/lib/interaction/components/editors/edit-context.d.ts

@@ -0,0 +1,3 @@
+export interface EditContext<T> {
+    injectError(error: string): any;
+}

package/lib/interaction/components/editors/inline-string-editor/inline-editor-model.d.ts

@@ -0,0 +1,24 @@
+import { GarbageCollector, ListModel, MutableValueModel, Validator, ValueModel } from '@coolon/pectin';
+import { EditContext } from '../edit-context';
+export declare class InlineEditorModel<T> extends GarbageCollector {
+    readonly valueModel: ValueModel<T>;
+    readonly saveCallback: InlineEditorModel.SaveCallback<T>;
+    readonly editing: MutableValueModel<boolean>;
+    private readonly _validators;
+    private _editingEnabled;
+    constructor(valueModel: ValueModel<T>, saveCallback: InlineEditorModel.SaveCallback<T>);
+    get editingEnabled(): ValueModel<boolean>;
+    disableWhile(condition: ValueModel<boolean>): this;
+    enableWhile(condition: ValueModel<boolean>): this;
+    get validators(): ListModel<Validator<T>>;
+    validateUsing(validator: Validator<T>): this;
+    isEditing(): boolean;
+    cancelEdit(): void;
+    startEditing(): void;
+}
+export declare namespace InlineEditorModel {
+    type SaveCallback<T> = (value: T, context: EditContext<T>) => void | Promise<void>;
+    function create<T>(valueModel: ValueModel<T>, options: {
+        save: SaveCallback<T>;
+    }): InlineEditorModel<T>;
+}

package/lib/interaction/components/editors/inline-string-editor/inline-string-editor.component.d.ts

@@ -0,0 +1,57 @@
+import { OnInit } from '@angular/core';
+import { BooleanValueModelChain, Command, DelegatingValueModel, ValueModel, ValueModelChain } from '@coolon/pectin';
+import { CommandFace } from '../../../../components/commands/command-face';
+import { DisposableComponent } from '../../../../components/disposable-component';
+import { InteractionService } from '../../../services/interaction.service';
+import { InPlaceInteractionContextComponent } from '../../inplace-interaction-context/in-place-interaction-context.component';
+import { InlineEditorModel } from './inline-editor-model';
+/**
+ * @example
+ * const source: ValueModel<string> = ...;
+ * const model = InlineEditorModel.create(source, {
+ *   save(updated:string, context: EditContext) => {
+ *      try {
+ *        try and save the thing...
+ *      } catch(error) {
+ *        context.injectError(error)
+ *      }
+ * }).validateUsing(Validator.present("We'll need a value");
+ *
+ * # in the view
+ * <aup-inline-string-editor
+ *       label="My field"
+ *       placeHolder="I'm ready for a string..."
+ *       [editorModel]="model"></aup-inline-string-editor>
+ */
+export declare class InlineStringEditorComponent extends DisposableComponent implements OnInit {
+    editorModel: InlineEditorModel<string>;
+    facesModel: ValueModel<InlineStringEditorComponent.Faces>;
+    faces: InlineStringEditorComponent.Faces;
+    interactionContext: InPlaceInteractionContextComponent<any, any, any>;
+    label: string;
+    placeHolder: string;
+    placeHolderModel: ValueModel<string>;
+    readonly description: ValueModelChain<string>;
+    empty: BooleanValueModelChain;
+    readonly editCommand: Command<void>;
+    displayValue: ValueModelChain<string>;
+    readonly editFaceModel: ValueModelChain<CommandFace>;
+    readonly saveFace: ValueModelChain<CommandFace>;
+    readonly cancelFace: ValueModelChain<CommandFace>;
+    readonly editingEnabled: DelegatingValueModel<boolean>;
+    constructor(interactionService: InteractionService);
+    ngOnInit(): void;
+    private createInputActivityData;
+    cancelEdit(): void;
+    startEdit(): void;
+    private isEditing;
+    isEmpty(): boolean;
+}
+export declare namespace InlineStringEditorComponent {
+    interface Faces {
+        edit?: CommandFace;
+        save?: CommandFace;
+        cancel?: CommandFace;
+    }
+    const DEFAULT_FACES: Faces;
+}

package/lib/interaction/components/inplace-interaction-context/in-place-interaction-context.component.d.ts

@@ -29,6 +29,7 @@ export declare class InPlaceInteractionContextComponent<D, R, E> extends Disposa
      */
     animateFirstActivity: boolean;
     get animationDuration(): string;
+    get active(): boolean;
     constructor(interactionService: InteractionService, tabConfig: MatTabsConfig);
     ngAfterViewInit(): void;
     initialise(id: string, api: InteractionService.Api): void;
@@ -38,6 +39,7 @@ export declare class InPlaceInteractionContextComponent<D, R, E> extends Disposa
     confirm(confirm: Confirm): Promise<boolean>;
     confirmOrReject(confirm: Confirm): Promise<void>;
     confirmThen<D1, R1, E1>(confirm: Confirm, activityType: Constructable<Activity<D1, R1, E1>>, data?: D1): Promise<R1>;
+    confirmThenExecute<R1>(confirm: Confirm, operation: (interactionContext: InteractionContext) => (Promise<R1> | R1)): Promise<R1>;
     isActive(): boolean;
     startActivity<D1, R1, E1>(activityType: Constructable<Activity<D1, R1, E1>>, data?: D1, options?: InteractionContext.Options): Promise<R1>;
 }

package/lib/interaction/components/input-activities/input-activity.d.ts

@@ -0,0 +1,41 @@
+import { Command, Form, Validator } from '@coolon/pectin';
+import { Enum } from 'typescript-string-enums';
+import { CommandFace } from '../../../components/commands/command-face';
+import { Activity } from '../../activity';
+export declare class InputActivity<T, D extends InputActivity.Data<T> = InputActivity.Data<T>> extends Activity<D, T> {
+    readonly data: D;
+    readonly confirmCommand: Command<void>;
+    readonly cancelCommand: Command<void>;
+    readonly valueModel: Form.ValueModelBase<T>;
+    class: string;
+    readonly confirmFace: CommandFace;
+    readonly cancelFace: CommandFace;
+    get layout(): InputActivity.Layout;
+    constructor(data: D);
+    onActivityReady(): void;
+    get additionalCssClassName(): string;
+    onEscape(): void;
+    shouldCancelOnEscape(): boolean;
+}
+export declare namespace InputActivity {
+    const Layout: {
+        INLINE: "inline";
+        BLOCK: "block";
+    };
+    type Layout = Enum<typeof Layout>;
+    interface Context {
+        injectError(error: string): any;
+    }
+    interface Data<T> {
+        initialValue: T;
+        label?: string;
+        placeholder?: string;
+        layout?: InputActivity.Layout;
+        confirmFace?: CommandFace;
+        cancelFace?: CommandFace;
+        validators?: Validator<T>[];
+        cancelOnEscape?: boolean;
+        cssClassName?: string;
+        save?(valueModel: T, interactionContext?: Context): void | Promise<void>;
+    }
+}

package/lib/interaction/components/input-activities/select-input-activity.d.ts

@@ -1,7 +1,15 @@
-import { AbstractInputActivity } from './abstract-input-activity';
-import { SelectInputActivityData } from './select-input-activity-data';
-export declare class SelectInputActivity<T> extends AbstractInputActivity<T, SelectInputActivityData<T>> {
+import { ListModel } from '@coolon/pectin';
+import { InputActivity } from './input-activity';
+export declare class SelectInputActivity<T> extends InputActivity<T, SelectInputActivity.Data<T>> {
     readonly defaultOptionLabelFormat: (option: T) => T | T[keyof T];
     get optionLabelFormat(): (option: T) => any;
     get options(): T[];
 }
+export declare namespace SelectInputActivity {
+    interface Data<T> extends InputActivity.Data<T> {
+        options?: T[];
+        optionsModel?: ListModel<T>;
+        optionLabel?: keyof T;
+        optionLabelFormat?: (option: T) => any;
+    }
+}

package/lib/interaction/components/input-activities/string-input-activity.d.ts

@@ -1,3 +1,7 @@
-import { AbstractInputActivity } from './abstract-input-activity';
-export declare class StringInputActivity extends AbstractInputActivity<string> {
+import { InputActivity } from './input-activity';
+export declare class StringInputActivity extends InputActivity<string> {
+}
+export declare namespace StringInputActivity {
+    interface Data extends InputActivity.Data<String> {
+    }
 }

package/lib/interaction/exports.d.ts

@@ -8,8 +8,9 @@ export * from "./alert";
 export * from "./confirm";
 export * from "./interaction-context";
 export * from "./interaction.module";
-export * from "./result";
 export * from "./route-synchronisation-adapter";
+export * from "./components/abstract-confirm-dialog.component";
+export * from "./components/abstract-dialog.component";
 export * from "./components/activity-actions/activity-actions.component";
 export * from "./components/activity-body/activity-body.component";
 export * from "./components/activity-container/activity-container.component";
@@ -19,14 +20,17 @@ export * from "./components/activity-triggers/abstract-activity-trigger.componen
 export * from "./components/activity-triggers/inline-activity-trigger/inline-activity-trigger.component";
 export * from "./components/activity-triggers/modal-activity-trigger/modal-activity-trigger.component";
 export * from "./components/activity-triggers/popup-activity-trigger/popup-activity-trigger.component";
+export * from "./components/add-card-activity/add-card-activity.component";
 export * from "./components/add-item-interaction-context/add-item-interaction-context.component";
 export * from "./components/alert-dialog/alert-dialog.component";
 export * from "./components/confirm-then-dialog/confirm-then-dialog.component";
+export * from "./components/confirm-then-execute-dialog/confirm-then-execute-dialog.component";
 export * from "./components/confirmation-dialog/confirmation-dialog.component";
+export * from "./components/editors/edit-context";
+export * from "./components/editors/inline-string-editor/inline-editor-model";
+export * from "./components/editors/inline-string-editor/inline-string-editor.component";
 export * from "./components/inplace-interaction-context/in-place-interaction-context.component";
-export * from "./components/input-activities/abstract-input-activity";
-export * from "./components/input-activities/input-activity-data";
-export * from "./components/input-activities/select-input-activity-data";
+export * from "./components/input-activities/input-activity";
 export * from "./components/input-activities/select-input-activity";
 export * from "./components/input-activities/string-input-activity";
 export * from "./components/popup-interaction-context/popup-interaction-context.component";

package/lib/interaction/interaction-context.d.ts

@@ -11,6 +11,7 @@ export interface InteractionContext extends Disposable, Disposable.Collector {
     alert(alert: Alert): Promise<void>;
     confirmOrReject(confirm: Confirm): Promise<void>;
     confirmThen<D, R, E>(confirm: Confirm, activityType: Constructable<Activity<D, R, E>>, data?: D): Promise<R>;
+    confirmThenExecute<R>(confirm: Confirm, operation: (interactionContext: InteractionContext) => R | Promise<R>): Promise<R>;
 }
 export declare namespace InteractionContext {
     interface Options {

package/lib/place/components/place-outlet/place-outlet.component.d.ts

@@ -51,6 +51,7 @@ export declare class PlaceOutletComponent extends DisposableComponent implements
     onOutletDeactivated(): void;
     private checkStateAndInitialise;
     private initialisePlace;
+    private pushVisitChangeToComponent;
     private pushVisitChangeToRoute;
     animationStarted(): void;
     animationDone(): void;

package/lib/place/place-component.d.ts

@@ -22,7 +22,12 @@ export declare class PlaceComponent extends DisposableComponent {
     initialiseVisit(visit: Visit, notifyVisitChanged: (current: Visit, previous: Visit) => void): void;
     updateVisit(visit: Visit): void;
     isInitialised(): boolean;
-    private installBinding;
+    /**
+     * Initialised the component bindings.  If any binding has an initial model value (e.g. a selection model
+     * initialised during the constructor) and the route has nothing, then the visit will be udpated and this
+     * method will return ture to nofiy the the visit has changed.
+     */
+    private installAndInitialiseBinding;
     get placeDefinition(): PlaceDefinition;
     get active(): ValueModel<boolean>;
     /**

package/lib/place/place-router.d.ts

@@ -43,10 +43,10 @@ export declare class PlaceRouter extends GarbageCollector {
     onRouterCancelled(event: NavigationCancel): void;
     onRouterError(event: NavigationError): void;
     onRouterEnd(event: NavigationEnd): void;
-    navigate(visit: Visit, options?: {
+    navigate(visit: Visit | Visit[], options?: {
         relativeTo: ActivatedRoute;
     }): Promise<void>;
-    doNavigation(visit: Visit, runNavigationCommands: (router: Router) => any): Promise<void>;
+    doNavigation(visit: Visit | Visit[], runNavigationCommands: (router: Router) => any): Promise<void>;
     navigateByUrl(urlSnapshot: UrlSnapshot, navigationExtras?: NavigationExtras): Promise<boolean>;
     get activeVisits(): ListModel<Visit>;
     pushVisitChangesToRoute(previous: Visit, next: Visit): Promise<void>;

package/lib/place/route/parameter-decorators.d.ts

@@ -1,9 +1,12 @@
+import { Constructable } from '@coolon/pectin';
 import { Formatter } from './formatter';
+import { ParameterSanitiser } from './parameter-sanitiser';
 export interface RouteIdOptions<T> {
     as?: string;
     optional?: boolean;
     remember?: boolean;
     defaultValue?: T;
+    sanitiser?: Constructable<ParameterSanitiser<T>> | ParameterSanitiser<T>;
 }
 export interface RouteParameterOptions<T> {
     as?: string;
@@ -11,6 +14,7 @@ export interface RouteParameterOptions<T> {
     remember?: boolean;
     defaultValue?: T;
     storeInUrl?: Formatter<T>;
+    sanitiser?: Constructable<ParameterSanitiser<T>> | ParameterSanitiser<T>;
 }
 export interface RouteListParameterOptions<T> {
     as?: string;
@@ -18,6 +22,7 @@ export interface RouteListParameterOptions<T> {
     remember?: boolean;
     defaultValue?: T[];
     storeInUrl?: Formatter<T>;
+    sanitiser?: Constructable<ParameterSanitiser<T[]>> | ParameterSanitiser<T[]>;
 }
 export declare function RouteId<T extends string | number>(type: Formatter<T>, options?: RouteIdOptions<T>): PropertyDecorator;
 export declare function VisitParameter<T>(options?: RouteParameterOptions<T>): PropertyDecorator;

package/lib/place/route/parameter-definition.d.ts

@@ -1,8 +1,9 @@
 import { Injector } from '@angular/core';
-import { HasValue, ListModel, MutableListModel, MutableValueModel, ValueModel } from '@coolon/pectin';
+import { Constructable, HasValue, ListModel, MutableListModel, MutableValueModel, ValueModel } from '@coolon/pectin';
 import { PlaceHistory } from '../place-history';
 import { Visit } from '../visit';
 import { Formatter } from './formatter';
+import { ParameterSanitiser } from './parameter-sanitiser';
 export declare abstract class ParameterDefinition<T, E = T> {
     readonly propertyName: string;
     readonly urlFormat?: Formatter<E>;
@@ -20,6 +21,9 @@ export declare abstract class ParameterDefinition<T, E = T> {
     createBackingModel(): HasValue<T>;
     protected getOptionValue<K extends keyof ParameterDefinition.Options<T>>(key: K): ParameterDefinition.Options<T>[K];
     sanitise(value: T, visit: Visit, placeHistory: PlaceHistory, injector: Injector, isPopState: boolean): Promise<T>;
+    private runCustomSanitiser;
+    private sanitiseMissing;
+    private prepareCustomSanitiser;
     private isMissingFrom;
 }
 export declare namespace ParameterDefinition {
@@ -28,6 +32,7 @@ export declare namespace ParameterDefinition {
         optional?: boolean;
         remember?: boolean;
         defaultValue?: T;
+        sanitiser?: Constructable<ParameterSanitiser<T>> | ParameterSanitiser<T>;
     }
     class RouteId<T> extends ParameterDefinition<T> {
         readonly isRouteId = true;

package/lib/place/route/parameter-sanitiser.d.ts

@@ -1,6 +1,5 @@
 import { Injector } from '@angular/core';
 import { Visit } from '../visit';
-import { ParameterSnapshot } from './parameter-snapshot';
-export interface ParameterSanitiser<S> {
-    sanitise(parameterValue: ParameterSnapshot<S>, visit?: Visit, injector?: Injector): Promise<S> | S;
+export interface ParameterSanitiser<T> {
+    sanitise(parameterValue: T, visit?: Visit, injector?: Injector): Promise<T> | T;
 }

package/lib/place/visit.d.ts

@@ -13,9 +13,9 @@ export declare class Visit {
      * Returns the value of the place parameter with the specified name.  The parameter
      * name is taken from the `as` option, e.g. {as: 'aCustomName'} otherwise it is the
      * same as the the ValueModel property name.
-     * @param parameterDef the visit parameter definition
+     * @param parameter the visit parameter definition
      */
-    getParameterValue<T, S>(parameterDef: ParameterDefinition<T, S>): T;
+    getParameterValue<T, S>(parameter: ParameterDefinition<T, S> | string): T;
     hasParameter(parameterDef: ParameterDefinition<any>): boolean;
     replace<T>(parameter: ParameterDefinition<T, any>, value: T): Visit;
     mergeRouteParameters<S>(routeParams: {

package/lib/services/exports.d.ts

@@ -2,3 +2,5 @@
  * @file Automatically generated by barrelsby.
  */
 export * from "./visibility-service";
+export * from "./markdown/markdown.service";
+export * from "./markdown/pill-plugin";

package/lib/services/markdown/markdown.service.d.ts

@@ -0,0 +1,6 @@
+export declare class MarkdownService {
+    constructor();
+    render(content: string): string;
+    renderInline(content: string): string;
+    usePillExtension(renderer?: (content: string) => string): void;
+}

package/lib/services/markdown/pill-plugin.d.ts

@@ -0,0 +1,15 @@
+import { marked } from 'marked';
+import RendererThis = marked.RendererThis;
+import TokenizerThis = marked.TokenizerThis;
+import Tokens = marked.Tokens;
+export declare const markdownPillExtension: (renderPill: (text: string) => string) => {
+    name: string;
+    level: string;
+    start: (src: string) => number;
+    tokenizer: (this: TokenizerThis, src: string) => {
+        type: string;
+        raw: string;
+        text: string;
+    };
+    renderer: (this: RendererThis, token: Tokens.Generic) => string;
+};